Unity 向け 6Labs SDK
このセクションでは、6Labs SDKをUnityアプリケーションに統合する方法を説明します。
前提条件
- Unity 2021 LTS以降が必要です。それ以前のバージョンでも動作する可能性がありますが、積極的にはサポートされていません。
- Appleプラットフォームのみ — 開発マシンに以下のツールがインストールされていることを確認してください：
- Xcode 26.2以降
- CocoaPods 1.12.0以降
- Unityプロジェクトは以下の最小デプロイメントターゲットを満たす必要があります：
- iOS — iOS 15以降
- tvOS — tvOS 15以降
- Android — APIレベル23（Android 6.0 Marshmallow）以降
1. モジュールのダウンロードとインポート
6Labs SDK は、Unity パッケージファイルとして提供されています。
以下の手順でモジュールを Unity プロジェクトに追加します：
- ダウンロード 6Labs Unity SDK の最新バージョン
v2.0.7。 - パッケージを Unity プロジェクトにインポートします：
- Unity エディタで Assets > Import Package > Custom Package. をクリックします。
- システムからダウンロードした
.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() メソッドのリファレンスです。
メソッドシグネチャ
パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
inGameId |
string |
いいえ | 省略可能ですが推奨されるユーザー識別子です。省略した場合、セッションが破棄され、AI 分析に使用されない可能性があります。 |
developerPayload
|
string |
いいえ | セッションに関連付けられる任意の開発者定義メタデータです。この値はセッションリクエストとともにそのまま転送され、カスタムのトラッキング情報やコンテキスト情報を付加するために利用できます。より豊富な developerPayload を提供することで、AIによる分析やセッション理解の精度を大幅に向上させることができます。例：
|
3. ゲーム内 ID の設定
SetInGameId() メソッドを使用して、プレイヤーのゲーム内 ID を既存の観察セッションに関連付けます。このメソッドは、ユーザーアカウントが作成される前に SDK が初期化された場合に、ログイン済みのユーザーを進行中のセッションに紐付けるためによく使用されます。
注意
Init()呼び出し時にinGameIdを渡していた場合、SetInGameId()を呼び出すと、現在のセッションに設定されていた値が上書きされます。
リファレンス
以下は SetInGameId() メソッドのリファレンスです。
メソッドシグネチャ
パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
inGameId |
string |
はい | 現在のセッションに関連付けるプレイヤーのゲーム内識別子です。 |
4. 高度な制御
通常の統合では、Init() を呼び出すだけでゲームプレイの観察を開始できます。
より詳細に観察の開始・停止タイミングを制御したい場合は、Resume() および Pause() メソッドを直接使用することも可能です。
4.1 再開 (Resume)
ゲームプレイ観察を再開したい場合は、Resume() メソッドを使用します。
developerPayload: "<optional_developer_payload_here>" );
メソッドシグネチャ
パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
inGameId |
string |
いいえ | 省略可能ですが推奨されるユーザー識別子です。省略した場合、セッションが破棄され、AI 分析に使用されない可能性があります。 |
developerPayload
|
string |
いいえ | セッションに関連付けられる任意の開発者定義メタデータです。この値はセッションリクエストとともにそのまま転送され、カスタムのトラッキング情報やコンテキスト情報を付加するために利用できます。より豊富な developerPayload を提供することで、AIによる分析やセッション理解の精度を大幅に向上させることができます。
|
4.2 一時停止 (Pause)
Pause()
メソッドを使用して、ゲームプレイの観察を一時停止します。
重要事項
- ゲームプレイの観察を一時停止します。
- 観察を再開する場合は、後から再度
Resume()を呼び出すことができます。