> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 實體移轉資訊

> 將遊戲、玩家和角色資料從 PlayFab 帳戶和資料 API 移至實體 API，包括用語和存取模式的變更。

實體 API 引進了新的存取模式，旨在減輕目前帳戶和資料系統的痛點。

如果您先前使用下列方法為遊戲、玩家或角色資訊實作資料管理，此處提供的資訊會對您有所幫助。

**遊戲**存取：

* client/[GetTitleData](xref:titleid.playfabapi.com.client.title-widedatamanagement.gettitledata)
* admin/[GetTitleData](xref:titleid.playfabapi.com.admin.title-widedatamanagement.gettitledata)
* server/[GetTitleData](xref:titleid.playfabapi.com.server.title-widedatamanagement.gettitledata)

**玩家**存取：

* client/[GetUserReadOnlyData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserreadonlydata)
* client/[UpdateUserData](xref:titleid.playfabapi.com.client.playerdatamanagement.updateuserdata)
* client/[UpdateUserPublisherData](xref:titleid.playfabapi.com.client.playerdatamanagement.updateuserpublisherdata)

**角色**存取：

* client/[GetCharacterData](xref:titleid.playfabapi.com.client.characterdata.getcharacterdata)
* client/[UpdateCharacterData](xref:titleid.playfabapi.com.client.characterdata.updatecharacterdata)

使用實體 API，您可以呼叫單一方法來儲存 title、player 和 character 實體類型的資料值。此 API 提供的存取規則可複製並擴充目前自訂資料的系統行為，並提供更好的介面。

在某些方面，這些變更不具回溯相容性。不過，您可以新增對實體 API 的呼叫，而不會改變現有 API 的行為。

## 用語

下表說明與實體 API 相關的用語調整。

| 用語 | 描述 |
| - | - |
| **title** | 此概念未變更。您的遊戲可能包含可供所有玩家使用的全域資訊。這類似於 [TitleData](xref:titleid.playfabapi.com.client.title-widedatamanagement.gettitledata)。它由遊戲/應用程式的遊戲識別碼 (`TitleId`) 識別。 |
| **master\_player\_account** | 此實體類型可讓您在命名空間中的多個遊戲之間共用玩家的相關資訊。這類似於 [UserPublisherData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserpublisherdata)。它由玩家的玩家識別碼 (`PlayFabId`) 識別，此識別碼會在任何登入或任何擷取玩家帳戶之帳戶資訊的呼叫中傳回 (例如 PlayFab Client API [GetAccountInfo](xref:titleid.playfabapi.com.client.accountmanagement.getaccountinfo))。 |
| **title\_player\_account** | 此概念以現有 API 方法中的使用者/玩家為基礎。每位玩家都可以包含目前遊戲的一些資訊。這類似於 [GetUserData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserdata) 方法。它由您在任何將 `LoginTitlePlayerAccountEntity` 指定為 `True` 的登入中，於 [EntityKey](xref:titleid.playfabapi.com.authentication.authentication.getentitytoken#entitykey) 物件內取回的實體識別碼 (`EntityKey.Id`) 識別。 |
| **character** | 此概念未變更。您的玩家可能擁有角色，每個角色都可以包含一些資訊。這類似於 [CharacterData](xref:titleid.playfabapi.com.client.characterdata.getcharacterdata)。它由角色的角色識別碼 (`CharacterId`) 識別。 |
| **PlayFabId** | 此用語先前同時涵蓋 `master_player_account` 和 `title_player_account` 概念。將這些概念分開可簡化並釐清功能。玩家可以與同一命名空間中的多個遊戲互動。玩家可以在每個遊戲的不同 `title_player_account` 中擁有獨特資訊，並擁有單一 `master_player_account`，其中包含跨遊戲共用的資料。這樣就能實現遊戲的交叉推廣和跨遊戲獎勵。 |

## 另請參閱

* PlayFab 部落格上的 [Introducing Entities, Objects and Files](https://blog.playfab.com/blog/introducing-entities-objects-and-files)。
* [實體快速入門](/zh-TW/services/playfab/live-service-management/game-configuration/entities/quickstart)


## Related topics

- [實體快速入門](/zh-TW/services/playfab/live-service-management/game-configuration/entities/quickstart.md)
- [從 PlayFab 獨立 SDK v1 移轉至 Unified SDK v2](/zh-TW/services/playfab/sdks/unified-sdk/migrating-from-v1.md)
- [移轉仲裁者](/zh-TW/services/xbox-services/multiplayer/concepts/live-migrating-an-arbiter.md)
- [觸控調整套件 (TAK) 參考](/zh-TW/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)
- [實體 API 重新架構升級教學課程](/zh-TW/services/playfab/live-service-management/game-configuration/entities/entity-api-restructure-upgrade-tutorial.md)