6Labs SDK の使用

このセクションでは、Unity を使用した iOS および Android アプリに 6Labs SDK を統合する方法について説明します。

1. モジュールのダウンロードとインポート

6Labs SDK は、Unity パッケージファイル SixLabsSDK-1.0.6.unitypackage として提供されています。

以下の手順でモジュールを Unity プロジェクトに追加します：

SDK パッケージをダウンロードします（最新バージョンの 6Labs Unity SDK が含まれています）。
パッケージを Unity プロジェクトにインポートします：
- Unity エディタで Assets > Import Package > Custom Package をクリックします。
- ローカル環境から SixLabsSDK-1.0.6.unitypackage を選択します。
- Import をクリックしてインポートを完了します。

Init() メソッドを使用して SDK を初期化し、ゲームプレイキャプチャを開始します。以下の例を参照してください。

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

ゲームプレイのキャプチャを開始する前に、必ずユーザーの同意を取得してください。SDKは自動的に許可を要求しないため、同意処理はゲームロジック内で実装する必要があります。
推奨されるベストプラクティスとして、ゲームのEULA（エンドユーザー使用許諾契約）またはプライバシーポリシーに、ゲームプレイ録画に関する記載を含めることを検討してください。
SDKはUnity Editor内では動作しません。正しくテストするには、プラットフォーム別のビルドを作成し、実機で実行する必要があります。

以下は Init() メソッドのリファレンスです。

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

パラメータ型必須説明

inGameId string いいえゲーム内のユーザーを識別する任意の ID です。指定しない場合は空文字列が使用されます。

developerPayload

string

いいえ

セッションに関連付ける開発者定義の任意メタデータです。この値はキャプチャリクエストとともにそのまま送信され、カスタムトラッキングやコンテキスト情報の付与に利用できます。
例：

通常の統合では、Init() を呼び出すだけでキャプチャフローを開始できます。

より詳細にキャプチャの開始・停止タイミングを制御したい場合は、StartCapture() および StopCapture() メソッドを直接使用することも可能です。

ゲームプレイキャプチャの開始タイミングを明示的に制御したい場合は、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`	いいえ	ゲーム内ユーザーを識別する任意の ID です。指定しない場合は空文字列になります。
`developerPayload`	`string`	いいえ	開発者定義の任意メタデータで、カスタムトラッキングやコンテキスト情報を付与するために使用できます。

StopCapture() メソッドを使用して、現在進行中のゲームプレイキャプチャセッションを停止します。

SixLabsSDK.Instance.StopCapture();