エンティティ移行情報 - XBOX Game Development Documentation

エンティティ API は、現在のアカウントおよびデータシステムの問題点を緩和するために設計された、新しいアクセスパターンを導入します。ここで紹介する情報は、タイトル、プレイヤー、またはキャラクターの情報のデータ管理を実装するために、以前に次のメソッドを使用していた場合に役立ちます。 タイトル アクセス:

client/GetTitleData
admin/GetTitleData
server/GetTitleData

プレイヤー アクセス:

キャラクター アクセス:

client/GetCharacterData
client/UpdateCharacterData

エンティティ API を使用すると、単一のメソッドを呼び出して、タイトル、プレイヤー、キャラクターの各エンティティタイプのデータ値を保存できます。API は、現在のカスタムデータのシステム動作を複製し拡張したアクセスルールを、より優れたインターフェイスで提供します。一部の点では、これらの変更は下位互換性がありません。ただし、既存の API の動作を変更することなく、エンティティ API への呼び出しを追加できます。

用語

次の表は、エンティティ API に関連する用語の改訂内容を示しています。

用語	説明
title	この概念は変わりません。タイトルには、すべてのプレイヤーが利用できるグローバル情報を含めることができます。これは TitleData に似ています。ゲーム/アプリケーションのタイトル ID (`TitleId`) で識別されます。
master_player_account	このエンティティタイプを使用すると、スタジオ内の複数のゲーム間でプレイヤーに関する情報を共有できます。これは UserPublisherData に似ています。プレイヤーのプレイヤー ID (`PlayFabId`) で識別されます。これは、ログインの一部として、またはプレイヤーアカウントのアカウント情報を取得する呼び出し (たとえば、PlayFab Client API の GetAccountInfo) から返されます。
title_player_account	この概念は、既存の API メソッドの user/player に基づいています。各プレイヤーは、現在のタイトルに関する情報を保持できます。これは GetUserData メソッドに似ています。これは、`LoginTitlePlayerAccountEntity` を `True` として指定する任意のログインの EntityKey オブジェクトから返されるエンティティ ID (`EntityKey.Id`) で識別されます。
character	この概念は変わりません。プレイヤーはキャラクターを所有することができ、それぞれに情報を保持できます。これは CharacterData に似ています。キャラクターのキャラクター ID (`CharacterId`) で識別されます。
PlayFabId	以前は、この用語は `master_player_account` と `title_player_account` の両方の概念をカバーしていました。これらの概念を分離することで、機能が簡素化され明確になります。プレイヤーは同じスタジオ内の複数のタイトルとやり取りできるため、各タイトルで異なる `title_player_account` として固有の情報を持つ一方で、スタジオのオーナーは、そのプレイヤーをタイトル間で共有されるデータを持つ単一の `master_player_account` エンティティとしても識別する必要があります。これにより、ゲームのクロスプロモーションや、プレイヤーへのクロスゲーム報酬の付与などが可能になります。

関連項目

PlayFab ブログの Introducing Entities, Objects and Files。
エンティティクイックスタート

最終更新日 2026年8月13日

関連トピック

エンティティクイックスタートエンティティハンドルエンティティファイルエンティティグループエンティティプログラミングモデル

⌘I