利用可能な組み込みエンティティの種類

[アーティクル]
11/17/2023

このトピックでは、EntityKey の構築に使用できるエンティティ型について説明します。

エンティティキーは、新しい API メソッドのほとんどでエンティティを識別します。

EntityKey.Type フィールドの値を使用して、ID フィールドに設定する値の種類を決定します。

注意

エンティティキーは大文字と小文字を区別します。

名前空間

namespace エンティティは、スタジオ内のすべてのタイトルのすべてのグローバル情報を参照します。

注意

このエンティティへの変更は、リアルタイムで反映されません。

ID フィールドをゲームの発行元 ID に設定します。 発行元 ID を取得するには:

ゲームマネージャーにサインインします。
ゲームマネージャーの左上隅の歯車アイコンを選択します。
[Title Settings (タイトル設定)] を選択します。
[API 機能] を選択します。
発行元 ID は、[API ACCESS] セクションに表示されます。

タイトル

title エンティティは、タイトルのすべてのグローバル情報を参照します。

注意

このエンティティへの変更は、リアルタイムで反映されません。

ID フィールドをゲームのタイトル ID に設定します。 タイトル ID を取得するには:

ゲームマネージャーにサインインします。
ゲームマネージャーの左上隅の歯車アイコンを選択します。
[Title Settings (タイトル設定)] を選択します。
[API 機能] を選択します。
タイトル ID は、[API ACCESS] セクションに表示されます。

master_player_account

master_player_account は、スタジオ内の全タイトル間で共有されるプレイヤーエンティティです。

ID フィールドをクラシック API の LoginResult.PlayFabId に設定します。 LoginResult を取得するには、Client Authentication でログインメソッドのいずれかを呼び出します。

title_player_account

ほとんどの開発者にとって、title_player_account は最も従来的な意味でプレイヤーを表します。

ID フィールドは、クライアント API の LoginResult.EntityToken.Entity.Id、または認証 API の GetEntityTokenResponse.Entity.Id に設定する必要があります。

LoginResult を取得するには、Client Authentication でログインメソッドのいずれかを呼び出します。 GetEntityTokenResponse を取得するには、Get Entity Token を呼び出します。

Character

character エンティティは title_player_account のサブエンティティであり、従来型 API のキャラクターの直接的なミラーです。

ID フィールドを result.Characters[i].CharacterId から任意の characterId に設定します。

グループ

group エンティティは、他のエンティティのコンテナーです。現在、プレイヤーとキャラクターに制限されています。

グループを作成する場合は ID フィールドを result.Group.Id に、メンバーシップを一覧表示するときは、result.Groups[i].Group.Id に設定します。

game_server

game_server エンティティは、主にマッチメイキングおよびロビー機能で使用するためにゲームサーバーが使用する一意のエンティティです。今後のシナリオは、他の PlayFab 機能をサポートするために追加される可能性があります。

このエンティティは、マッチメイキングとロビーのリアルタイム更新をサブスクライブしたり、ロビー所有者の移行などの特定の機能をサポートしたりするために、ゲームサーバーに独自の ID を提供します。

game_server のエンティティとして認証するには、API AuthenticateGameServerWithCustomId をタイトルエンティティとして呼び出し、game_server エンティティキーとトークンのペアを取得します。 PFMultiplayerSetEntityToken で PlayFab マルチプレイヤー SDK を使用する場合は、このエンティティキーを使用します。

次の方法で共有