> ## 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 玩家資料，用於儲存每位玩家的自訂索引鍵值欄位，包括用於進度的內部、唯讀和遊戲資料。

玩家資料是範圍限定於玩家實體 (`title_player_account`、`master_player_account` 和 `character`) 的個別玩家儲存空間。使用它來儲存遊戲進度、偏好設定，以及與個別玩家相關的其他資訊。

玩家資料是 PlayFab 中數種儲存功能之一，每種功能的範圍都限定於不同的實體類型。如需比較，請參閱[實體物件](/zh-TW/services/playfab/live-service-management/game-configuration/entities/entity-objects#related-features)。

## 儲存選項

PlayFab 提供兩種儲存玩家資料的方式：

* [實體](/zh-TW/services/playfab/live-service-management/game-configuration/entities)：可讓您在玩家、角色和群組之間，將資料儲存在物件和檔案中。
* [玩家資料/UserData](/zh-TW/services/playfab/player-progression/player-data/quickstart)：可讓您為玩家儲存索引鍵/值組資料。

為了提供最大的彈性和最佳的效能，我們建議*所有*新遊戲都使用[實體物件](/zh-TW/services/playfab/live-service-management/game-configuration/entities/entity-objects)。

在 PlayFab API 中，函式名稱使用 **UserData** 一詞。在 **Game Manager** 中，此概念描述為 **Player Data**。兩者完全相同且可互換。

存取玩家資料有三種模式：

* 用戶端：這是您的遊戲用戶端可以讀取和更新的玩家資料。您可以使用用戶端 API [UpdateUserData](xref:titleid.playfabapi.com.client.playerdatamanagement.updateuserdata) 建立、更新或刪除，並使用 [GetUserData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserdata) 讀取玩家的資料。
* 唯讀：這是由您的伺服器建立或更新的玩家資料。您的遊戲用戶端可以讀取但無法更新此資料。您可以使用伺服器 API [UpdateUserReadOnlyData](xref:titleid.playfabapi.com.server.playerdatamanagement.updateuserreadonlydata) 建立、更新或刪除，並使用用戶端 API [GetUserReadOnlyData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserreadonlydata) 讀取玩家的遊戲特定資料。此資料對玩家可見，但只能由伺服器修改。
* 內部：這是只有您的伺服器才能使用的玩家資料。您可以使用伺服器 API [UpdateUserInternalData](xref:titleid.playfabapi.com.server.playerdatamanagement.updateuserinternaldata) 建立、更新或刪除，並使用 [GetUserInternalData](xref:titleid.playfabapi.com.server.playerdatamanagement.getuserinternaldata) 讀取玩家的遊戲特定資料。此資料僅限伺服器使用，用戶端無法看到。

使用玩家資料時，用戶端 API 只能使用 User Data 和 User Read Only Data。如果您有其他玩家應該能夠讀取的玩家資料，則需要在寫入資料時將 `Permission` 值設定為 `Public`。

## 玩家資料與玩家發行者資料

[玩家資料](/zh-TW/services/playfab/player-progression/player-data/quickstart)是遊戲特定的玩家資訊。它應用於遊戲特定的資訊——例如儲存玩家在地下城中的位置，或其他遊戲特定的資料。

玩家發行者資料與命名空間中玩家的 `master_player_account` 相關聯，而不是與 `title_player_account` 相關聯。使用它來儲存與命名空間中所有遊戲相關的玩家資訊，例如跨遊戲獎勵。

發行者識別碼可識別命名空間；**publisher** 是此範圍較舊的 API 用語。根據預設，工作室中的所有遊戲共用一個發行者識別碼。玩家的主要玩家帳戶在該命名空間中提供跨遊戲身分識別，而玩家在每個遊戲玩家帳戶中也有不同的資料。如需詳細資訊，請參閱 [PlayFab 概念](/zh-TW/services/playfab/get-started/concepts#studios-namespaces-and-titles)。

<Note>
  某些舊版設定在一個工作室中有多個發行者識別碼，或在多個工作室之間共用一個發行者識別碼。這些設定並不常見。
</Note>

<Note>
  請不要將*玩家*發行者資料與[發行者資料](/zh-TW/services/playfab/live-service-management/game-configuration/titledata/using-publisher-data)混淆，後者是所有遊戲共用的索引鍵/值組資料 (它*不是*個別玩家的資料)。
</Note>

玩家發行者資料的用法與玩家資料的用法幾乎相同。它們*都是*將字串對應至 JSON blob (或其他任意字串值) 的字典。

如需詳細資訊，請參閱[如何使用玩家發行者資料為遊玩多個遊戲授與獎勵](/zh-TW/services/playfab/player-progression/player-data/using-player-publisher-data)。


## Related topics

- [玩家資料](/zh-TW/services/xbox-services/player-data/index.md)
- [PlayFab 玩家進度文件](/zh-TW/services/playfab/player-progression/index.md)
- [XBOX 服務概觀](/zh-TW/services/xbox-services/fundamentals/live-xbl-overview.md)
- [使用 PlayFab 進行進度管理](/zh-TW/services/playfab/player-progression/player-progression-overview.md)
- [Winter Starfall PlayFab 示範遊戲概觀](/zh-TW/services/playfab/demo-game/overview.md)