适用于 Unity 的 6Labs SDK

本节介绍如何将 6Labs SDK 集成到您的 Unity 应用中。

1. 下载并导入模块

6Labs SDK 以 Unity 包文件 SixLabsSDK-1.1.1.unitypackage 的形式提供。

将该模块添加到您的 Unity 项目中:

  1. 下载安装包,其中包含最新版本的 Unity 版 6Labs SDK。
  2. 将安装包导入到您的 Unity 项目中:
    • 点击 Assets > Import Package > Custom Package
    • 从本地选择 SixLabsSDK-1.1.1.unitypackage
    • 点击 Import 完成导入。

2. 开始观察游戏

使用 Init() 方法初始化 SDK 并开始观察游戏,如下所示:

SixLabsSDK.Instance.Init(
    inGameId: "<optional_player_in_game_id>",
    developerPayload: "<optional_developer_payload_here>"
);

重要信息

  • 如果未传递 inGameId,观察到的会话可能会被丢弃,并且不会用于 AI 分析。缺少该字段时,无法将会话归属到玩家,而这是生成后续洞察所必需的。
  • 在开始观察游戏之前,请确保已获得用户同意。SDK 不会自动请求权限;同意处理必须在您的游戏逻辑中实现。
  • 作为推荐的最佳实践,您可以在游戏的 EULA 或隐私政策中加入有关游戏观察的披露说明。
  • 请确保您的应用已为目标平台启用所需的网络访问权限。
  • SDK 无法在 Unity Editor 中运行。要进行正确测试,您需要创建特定平台的构建并在物理设备上运行。

参考

以下是 Init() 方法的参考。

方法签名

public void Init(string inGameId = null, string developerPayload = null)

参数

参数 类型 是否必需 描述
inGameId string 游戏内的可选用户标识符。如未传递,则默认为空字符串。
developerPayload string 与会话关联的可选开发者自定义元数据。该值会随会话请求原样转发,可用于附加自定义跟踪或上下文信息。提供更丰富的 developerPayload 可显著改善 AI 驱动的分析和会话理解能力。
示例:

  • 获取渠道
  • 活动 ID
  • 用户分群(例如:新用户、回访用户、鲸鱼用户)
  • A/B 测试变体(例如:variant_a、variant_b)—— 将用户分配到不同群组,并在 6Labs 仪表板中比较他们的游戏指标。
  • 内部参考标识符

3. 高级控制

在大多数集成场景中,调用 Init() 即可开始观察游戏。对于更高级或自定义的控制,您也可以直接使用 StartCapture()StopCapture()

3.1 开始观察

当您希望显式控制何时开始游戏观察时,请使用 StartCapture() 方法。

SixLabsSDK.Instance.StartCapture(
    inGameId: "<optional_player_in_game_id>",
    developerPayload: "<optional_developer_payload_here>"
);

方法签名

public void StartCapture(string inGameId = null, string developerPayload = null)

参数

参数 类型 是否必需 描述
inGameId string 游戏内的可选用户标识符。如未传递,则默认为空字符串。
developerPayload string 提供更丰富的 developerPayload 可显著改善 AI 驱动的分析和会话理解能力。包含用户分群、活动标识符、进度状态或获取渠道等上下文信息有助于生成更具相关性的洞察。

3.2 停止观察

使用 StopCapture() 方法停止游戏观察。

SixLabsSDK.Instance.StopCapture();

重要信息

  • 停止游戏观察。
  • 您之后可以再次调用 StartCapture() 以开始游戏观察。
×

目录

适用于 Unity 的 6Labs SDK

目录

文档版本 1.0

文本已复制到剪贴板
copyLinkText
有疑问?请通过以下方式联系我们: dev-support@now.us