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> 型で、次の 2 つのパラメータを受け取ります：

6.2 状態

6.3 レスポンスコード