>
6Labs >

Unreal 向け 6labs SDK

このセクションでは、Windows 上の Unreal Engine アプリに 6labs SDK を統合する方法について説明します。

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

6labs SDK は Unreal Engine プラグインとして提供されます。

このモジュールを Unreal プロジェクトに追加します。

  1. パッケージをダウンロード して、Unreal Engine 向け最新バージョンの 6labs SDK を取得します。
  2. プラグインをプロジェクトの Plugins ディレクトリ(YourProject/Plugins/SixLabsSDK/)に展開します。
  3. プラグインが有効になっていることを確認します。
    • Unreal Editor で Edit > Plugins を開きます。
    • 6Labs SDK」を検索し、有効になっていることを確認します。
  4. モジュール依存関係を追加します。
    • ゲームモジュールの Build.cs に次を追加します: PublicDependencyModuleNames.Add("SixLabsSDK");

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

以下のように、Init() メソッドを使用して SDK を初期化し、ゲームプレイの観察を開始します。

#include "SixLabsSubsystem.h"

USixLabsSubsystem* SixLabs = GetSubsystem<USixLabsSubsystem>();

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

SixLabs->Init(TEXT("optional_player_in_game_id"), TEXT("optional_developer_payload_here"));

// ... ゲームプレイ中 — セッションデータが自動的にアップロードされます ...

重要事項

  • InGameIdが渡されない場合、観察されたセッションは破棄され、AI分析に使用されない可能性があります。これがないと、セッションをプレイヤーに紐付けることができず、後続のインサイト生成に必要な情報が不足します。
  • ゲームプレイの観察を開始する前に、必ずユーザーの同意を取得してください。SDK は自動的に許可を求めないため、同意処理はゲーム側のロジックで実装する必要があります。
  • 推奨されるベストプラクティスとして、ゲームプレイ観察に関する開示をゲームの EULA またはプライバシーポリシーに記載することを検討してください。
  • 適切にテストするには、プラットフォームごとのビルドを作成し、実機で実行する必要があります。

リファレンス

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

メソッドシグネチャ

SixLabs->Init(TEXT("optional_player_in_game_id"), TEXT("optional_developer_payload_here"));

パラメータ

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

  • 獲得チャネル
  • キャンペーン ID
  • ユーザーセグメント(例:新規、復帰、ヘビーユーザー)
  • A/B テストのバリアント(例:variant_a、variant_b)— ユーザーをコホートに分け、6Labs ダッシュボードでゲームプレイ指標を比較できます。
  • 内部参照識別子

3. 高度な制御

ほとんどの統合では、Init() を呼び出すだけでゲームプレイの観察を開始できます。より高度な、またはカスタムの制御が必要な場合は、StartSession()StopSession() を直接使用することもできます。

3.1 観察を開始

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

#include "SixLabsSubsystem.h"

USixLabsSubsystem* SixLabs = GetSubsystem<USixLabsSubsystem>();

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

SixLabs->StartSession(TEXT("optional_player_in_game_id"), TEXT("optional_developer_payload_here"));

// ... ゲームプレイ中 — セッションデータが自動的にアップロードされます ...

メソッドシグネチャ

SixLabs->StartSession(TEXT("optional_player_in_game_id"), TEXT("optional_developer_payload_here"));

パラメータ

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

3.2 観察を停止

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

// ゲームプレイの観察を停止

SixLabs->StopSession();

重要事項

  • ゲームプレイの観察を停止します。
  • 後で再度 StartSession() を呼び出して、新しい観察を開始できます。
×

目次

Unreal 向け 6labs SDK

目次

ドキュメント改訂版 1.0

Text copied to clipboard
Link copied to clipboard
ご不明な点がございましたら、お気軽にお問い合わせください。 dev-support@6labs.ai