玩家資料

玩家資料是範圍限定於玩家實體 (title_player_account、master_player_account 和 character) 的個別玩家儲存空間。使用它來儲存遊戲進度、偏好設定，以及與個別玩家相關的其他資訊。 玩家資料是 PlayFab 中數種儲存功能之一，每種功能的範圍都限定於不同的實體類型。如需比較，請參閱實體物件。

​

儲存選項

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

• 實體：可讓您在玩家、角色和群組之間，將資料儲存在物件和檔案中。
• 玩家資料/UserData：可讓您為玩家儲存索引鍵/值組資料。

為了提供最大的彈性和最佳的效能，我們建議所有新遊戲都使用實體物件。 在 PlayFab API 中，函式名稱使用 UserData 一詞。在 Game Manager 中，此概念描述為 Player Data。兩者完全相同且可互換。 存取玩家資料有三種模式：

• 用戶端：這是您的遊戲用戶端可以讀取和更新的玩家資料。您可以使用用戶端 API UpdateUserData 建立、更新或刪除，並使用 GetUserData 讀取玩家的資料。
• 唯讀：這是由您的伺服器建立或更新的玩家資料。您的遊戲用戶端可以讀取但無法更新此資料。您可以使用伺服器 API UpdateUserReadOnlyData 建立、更新或刪除，並使用用戶端 API GetUserReadOnlyData 讀取玩家的遊戲特定資料。此資料對玩家可見，但只能由伺服器修改。
• 內部：這是只有您的伺服器才能使用的玩家資料。您可以使用伺服器 API UpdateUserInternalData 建立、更新或刪除，並使用 GetUserInternalData 讀取玩家的遊戲特定資料。此資料僅限伺服器使用，用戶端無法看到。

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

​

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

玩家資料是遊戲特定的玩家資訊。它應用於遊戲特定的資訊——例如儲存玩家在地下城中的位置，或其他遊戲特定的資料。 玩家發行者資料與命名空間中玩家的 master_player_account 相關聯，而不是與 title_player_account 相關聯。使用它來儲存與命名空間中所有遊戲相關的玩家資訊，例如跨遊戲獎勵。 發行者識別碼可識別命名空間；publisher 是此範圍較舊的 API 用語。根據預設，工作室中的所有遊戲共用一個發行者識別碼。玩家的主要玩家帳戶在該命名空間中提供跨遊戲身分識別，而玩家在每個遊戲玩家帳戶中也有不同的資料。如需詳細資訊，請參閱 PlayFab 概念。 玩家發行者資料的用法與玩家資料的用法幾乎相同。它們都是將字串對應至 JSON blob (或其他任意字串值) 的字典。 如需詳細資訊，請參閱如何使用玩家發行者資料為遊玩多個遊戲授與獎勵。