6Labs >

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 パッケージファイル SixLabsSDK-1.1.10.unitypackage として提供されています。

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

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

2. ゲームプレイの観察を開始

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

                                                                                using
                                                                                SixLabs.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 いいえゲーム内のユーザーを識別する任意の ID です。指定しない場合は空文字列が使用されます。

developerPayload

string

いいえ

セッションに関連付けられる任意の開発者定義メタデータです。この値はセッションリクエストとともにそのまま転送され、カスタムのトラッキング情報やコンテキスト情報を付加するために利用できます。より豊富な developerPayload を提供することで、AIによる分析やセッション理解の精度を大幅に向上させることができます。
例：

ユーザー獲得チャネル
キャンペーン ID
ユーザーセグメント（例：新規ユーザー、既存ユーザー、課金ユーザーなど）
A/Bテストバリアント（例：variant_a、variant_b） — ユーザーをコホートに分割し、6Labs ダッシュボードで各コホートのゲームプレイ指標を比較できます。
内部参照 ID

3. 高度な制御

通常の統合では、Init() を呼び出すだけでゲームプレイの観察を開始できます。

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

3.1 観察の開始

ゲームプレイ観察の開始タイミングを明示的に制御したい場合は、StartSession() メソッドを使用します。

                                                                                SixLabsSDK.Instance.StartSession(
                                                                                
                                                                                        inGameId:
                                                                                        "<optional_player_in_game_id>",

                                                                                        developerPayload:
                                                                                        "<optional_developer_payload_here>"
                                                                                
                                                                                );
                                                                        

メソッドシグネチャ

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

パラメータ

パラメータ	型	必須	説明
`inGameId`	`string`	いいえ	ゲーム内ユーザーを識別する任意の ID です。指定しない場合は空文字列になります。
`developerPayload`	`string`	いいえ	セッションに関連付けられる任意の開発者定義メタデータです。この値はセッションリクエストとともにそのまま転送され、カスタムのトラッキング情報やコンテキスト情報を付加するために利用できます。より豊富な `developerPayload` を提供することで、AIによる分析やセッション理解の精度を大幅に向上させることができます。

3.2 観察の停止

StopSession() メソッドを使用して、ゲームプレイの観察を停止します。

SixLabsSDK.Instance.StopSession();

重要事項

ゲームプレイの観察を停止します。
新しい観察を開始する場合は、後から再度 StartSession() を呼び出すことができます。

概要

Unreal 向け 6labs SDK

Unity 向け 6Labs SDK

前提条件

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

2. ゲームプレイの観察を開始

重要事項

リファレンス

メソッドシグネチャ

パラメータ

3. 高度な制御

3.1 観察の開始

メソッドシグネチャ

パラメータ

3.2 観察の停止

重要事項

目次

目次