适用于 Unity 的 6labs SDK

6labs SDK 以 Unity 包文件的形式提供。

按照以下步骤将该模块添加到您的 Unity 项目中：

1. 下载 6labs Unity SDK 最新版本 v4.0.0。
2. 将安装包导入到您的 Unity 项目中：
   • 在 Unity 编辑器中点击 Assets > Import Package > Custom Package.
   • 从系统中选择已下载的 .unitypackage 文件。
   • 点击 Import 完成导入。

使用 StartSession() 方法开始观察游戏，如下所示：

using SixLabs.SDK;

SixLabsSDK.Instance.StartSession(
    inGameId: "<optional_player_in_game_id>",
    developerPayload: "<optional_developer_payload_here>",
    callbackOnComplete: (sdkResponse, errorMessage) => {
        // sdkResponse == SdkResponse.SUCCESS 表示 StartSession() 已成功完成
        // 处理返回结果
        // SixLabsSDK.Instance.CurrentState 可获取 SDK 当前的状态
    }
);

public void StartSession(
    string inGameId = null,
    string developerPayload = null,
    Action<SdkResponse, string> callbackOnComplete = null)

使用 SetInGameId() 方法将玩家的游戏内 ID 与现有的观察会话关联。当 SDK 在用户账户创建之前完成初始化时，通常需要调用此方法，以便将已登录的用户与当前正在进行的会话关联起来。

SixLabsSDK.Instance.SetInGameId("<player_in_game_id>");

public void SetInGameId(string inGameId)

使用 SendGameEvent() 方法在活动的游戏观察会话期间记录自定义游戏事件。事件会被关联到该会话，并可用于在分析时对应到特定的游戏时刻。

bool result = SixLabsSDK.Instance.SendGameEvent(
    eventName: "<event_name>",
    eventDataJson: "<event_data_as_json>"
);

public bool SendGameEvent(
    string eventName,
    string eventDataJson)

StartSession() 会为新会话开始观察游戏。之后，您可以根据需要使用 PauseSession()、 ResumeSession() 和 StopSession() 方法来控制该会话。

5.1 暂停 (PauseSession)

调用 PauseSession() 方法暂停游戏观察。

SdkResponse result = SixLabsSDK.Instance.PauseSession();

public SdkResponse PauseSession()

5.2 恢复 (ResumeSession)

使用 ResumeSession() 方法继续此前通过 PauseSession() 暂停的会话。

SixLabsSDK.Instance.ResumeSession(
    callbackOnComplete: (sdkResponse, errorMessage) => {
        // sdkResponse == SdkResponse.SUCCESS 表示 ResumeSession() 已成功完成
        // 处理返回结果
        // SixLabsSDK.Instance.CurrentState 可获取 SDK 当前的状态
    }
);

public void ResumeSession(Action<SdkResponse, string> callbackOnComplete = null)

5.3 停止 (StopSession)

使用 StopSession() 方法永久结束当前会话。与 PauseSession() 不同，已停止的会话无法通过 ResumeSession() 继续 — 如需开始新的会话，必须重新调用 StartSession()。

SixLabsSDK.Instance.StopSession(
    callbackOnComplete: (sdkResponse, errorMessage) => {
        // sdkResponse == SdkResponse.SUCCESS 表示 StopSession() 已成功完成
        // 处理返回结果
        // SixLabsSDK.Instance.CurrentState 可获取 SDK 当前的状态
    }
);

public void StopSession(Action<SdkResponse, string> callbackOnComplete = null)

SDK 会在以下状态之间转换。您可以调用哪些方法以及方法返回什么，取决于当前状态：

• 您可以随时通过 SixLabsSDK.Instance.CurrentState 查看 SDK 当前的状态。
• StartSession()、PauseSession()、ResumeSession() 和 StopSession() 只能在 SDK 处于有效状态时调用。在无效状态下调用会返回错误。
• PauseSession() 会直接返回一个 SdkResponse。StartSession()、ResumeSession() 和 StopSession() 则通过可选的 callbackOnComplete 回调返回结果。
• callbackOnComplete 回调是异步调用的。

6.1 回调参数

该回调的类型为 Action<SdkResponse, string>，会接收以下两个参数：

6.2 状态

6.3 响应代码