跳轉到主要內容
設定檔包括與玩家設定檔、實體設定檔、角色設定檔、群組和物品欄相關的任何儲存資料。設定檔資料是適用於個別玩家、玩家群組或物品的資訊,並由 PlayFab 儲存為索引鍵/值組 (KVP)。 下列 API 會讓設定檔寫入計量遞增。

Admin API

Client API

  • AcceptTrade 如果本機登入的玩家在交易的允許玩家清單中,或交易對所有玩家開放,則接受一筆開放的交易 (尚未被接受或取消的交易)。如果呼叫成功,提供和接受的物品將在兩位玩家的物品欄之間交換。
  • AddFriend 根據與所提供之唯一識別碼的比對,將 PlayFab 使用者新增至本機使用者的好友清單。FriendPlayFabId、FriendUsername、FriendEmail 或 FriendTitleDisplayName 中至少應初始化一個。
  • AddGenericID 將指定的一般服務識別碼新增至玩家的 PlayFab 帳戶。此功能的設計目的是允許針對遊戲想要新增的任意服務識別碼查詢 PlayFab 識別碼。此識別碼永遠不應作為驗證認證使用,因為其目的是讓其他玩家能輕鬆存取。
  • AddOrUpdateContactEmail 在玩家的設定檔中新增或更新連絡電子郵件。
  • AddSharedGroupMembers 將使用者新增至能夠更新共用資料以及群組中使用者集合的使用者集合。只有群組中的使用者 (和伺服器) 可以新增成員。共用群組是為極少數玩家之間共用資料而設計的,請參閱使用共用群組資料。
  • AddUsernamePassword 將 PlayFab 使用者名稱/密碼驗證新增至透過匿名驗證方法 (例如自動裝置識別碼登入) 建立的現有帳戶。
  • AndroidDevicePushNotificationRegistration 註冊 Android 裝置以接收推播通知
  • ConsumePSNEntitlements 檢查是否有任何新的可消耗權利。如果找到任何權利,就會將其消耗並新增為 PlayFab 物品。
  • ConsumeXboxEntitlements 從 XBOX Live 授與玩家目前的權利,消耗 XBOX 中所有可用的物品,並將它們授與至玩家的 PlayFab 物品欄。此呼叫具有等冪性,不會將先前授與的物品再次授與玩家。
  • CreateSharedGroup 要求建立共用群組物件,其中包含群組所有成員都可以更新的索引鍵/值組。建立時,目前的使用者將是群組的唯一成員。共用群組是為極少數玩家之間共用資料而設計的。如需詳細資訊,請參閱使用共用群組資料。
  • GrantCharacterToUser 將指定的角色類型授與使用者。CharacterId 並非全域唯一;必須將 characterId 與上層 PlayFabId 一起評估,才能保證唯一性。
  • LinkAndroidDeviceID 將 Android 裝置識別碼連結至使用者的 PlayFab 帳戶
  • LinkCustomID 將遊戲產生的自訂識別碼連結至使用者的 PlayFab 帳戶。
  • LinkFacebookAccount 將與所提供之 Facebook 存取權杖相關聯的 Facebook 帳戶連結至使用者的 PlayFab 帳戶。
  • LinkFacebookInstantGamesId 將 Facebook Instant Games 識別碼連結至使用者的 PlayFab 帳戶。
  • LinkGameCenterAccount 將與所提供之 Game Center 識別碼相關聯的 Game Center 帳戶連結至使用者的 PlayFab 帳戶。
  • LinkGoogleAccount 使用 Google 帳戶認證,將目前登入的使用者帳戶連結至其 Google 帳戶。
  • LinkIOSDeviceID 將廠商特定的 iOS 裝置識別碼連結至使用者的 PlayFab 帳戶。
  • LinkKongregate 將 Kongregate 識別碼連結至使用者的 PlayFab 帳戶。
  • LinkNintendoSwitchDeviceId 將 NintendoSwitchDeviceId 連結至使用者的 PlayFab 帳戶。
  • LinkOpenIdConnect 根據遊戲與 Open ID Connect 提供者之間現有的關係,以及來自該提供者的 OpenId Connect JWT,將 OpenID Connect 帳戶連結至使用者的 PlayFab 帳戶。
  • LinkPSNAccount 將與所提供之存取碼相關聯的 PlayStation™Network 帳戶連結至使用者的 PlayFab 帳戶。
  • LinkSteamAccount 將與所提供之 Steam 驗證票證相關聯的 Steam 帳戶連結至使用者的 PlayFab 帳戶。
  • LinkTwitch 將與權杖相關聯的 Twitch 帳戶連結至使用者的 PlayFab 帳戶。
  • LinkXboxAccount 將與所提供之存取碼相關聯的 XBOX Live 帳戶連結至使用者的 PlayFab 帳戶。
  • OpenTrade 開啟新的未完成交易。請注意,一個指定的物品執行個體一次只能位於一筆開放的交易中。
  • PurchaseItem 使用虛擬貨幣購買單一物品。您必須同時指定用於購買的虛擬貨幣,以及用戶端認為的價格。這可讓伺服器在價格已變更時讓購買失敗。
  • PayForPurchase 為透過 StartPurchase 建立的採購訂單選取付款選項
  • RegisterForIOSPushNotification 註冊 iOS 裝置以接收推播通知
  • RegisterPlayFabUser 註冊新的 PlayFab 使用者帳戶,傳回可在之後用於需要已驗證使用者之 API 呼叫的工作階段識別碼。您必須提供使用者名稱或電子郵件地址。
  • RemoveContactEmail 從玩家的設定檔移除連絡電子郵件。
  • RemoveFriend 從本機使用者的好友清單中移除指定的使用者。
  • RemoveGenericID 從玩家的 PlayFab 帳戶移除指定的一般服務識別碼。
  • RemoveSharedGroupMembers 將使用者從能夠更新共用資料以及群組中使用者集合的使用者集合中移除。只有群組中的使用者可以移除成員。如果呼叫後沒有任何使用者保有存取權,群組及其相關資料將被刪除。共用群組是為極少數玩家之間共用資料而設計的,請參閱使用共用群組資料。
  • ReportAdActivity 回報玩家的廣告活動
  • ReportDeviceInfo 撰寫 PlayStream 事件來描述所提供的玩家裝置資訊。此 API 方法並非設計供開發人員直接呼叫。每個 PlayFab 用戶端 SDK 最終都會自動回報此資訊。
  • ReportPlayer 提交另一位玩家的檢舉 (由於不良行為等),讓遊戲的客戶服務代表可以對潛在的有害玩家採取行動。
  • RestoreIOSPurchases 根據指定的還原收據還原所有應用程式內購買
  • SetFriendTags 更新本機使用者好友清單中指定使用者的標籤清單。
  • SubtractUserVirtualCurrency 將使用者指定虛擬貨幣的餘額遞減所述的數量。使用此 API 可以讓 VC 餘額變成負數。
  • UnlinkAndroidDeviceID 從使用者的 PlayFab 帳戶取消連結相關的 Android 裝置識別碼。
  • UnlinkCustomID 從使用者的 PlayFab 帳戶取消連結相關的自訂識別碼。
  • UnlinkFacebookAccount 從使用者的 PlayFab 帳戶取消連結相關的 Facebook 帳戶。
  • UnlinkFacebookInstantGamesId 從使用者的 PlayFab 帳戶取消連結相關的 Facebook Instant Game 識別碼。
  • UnlinkGameCenterAccount 從使用者的 PlayFab 帳戶取消連結相關的 Game Center 帳戶。
  • UnlinkGoogleAccount 從使用者的 PlayFab 帳戶取消連結相關的 Google 帳戶 (https://developers.google.com/android/reference/com/google/android/gms/auth/GoogleAuthUtil#public-methods)。
  • UnlinkIOSDeviceID 從使用者的 PlayFab 帳戶取消連結相關的 iOS 裝置識別碼。
  • UnlinkKongregate 從使用者的 PlayFab 帳戶取消連結相關的 Kongregate 識別碼。
  • UnlinkNintendoSwitchDeviceId 從使用者的 PlayFab 帳戶取消連結相關的 NintendoSwitchDeviceId。
  • UnlinkOpenIdConnect 根據遊戲與 Open ID Connect 提供者之間現有關係的連線識別碼,從使用者的 PlayFab 帳戶取消連結 OpenID Connect 帳戶。
  • UnlinkPSNAccount 從使用者的 PlayFab 帳戶取消連結相關的 PSN™ 帳戶。
  • UnlinkSteamAccount 從使用者的 PlayFab 帳戶取消連結相關的 Steam 帳戶。
  • UnlinkTwitch 從使用者的 PlayFab 帳戶取消連結相關的 Twitch 帳戶。
  • UnlinkXboxAccount 從使用者的 PlayFab 帳戶取消連結相關的 XBOX Live 帳戶。
  • UnlockContainerInstance 以指定的鑰匙 (需要時) 開啟指定的容器,並傳回已開啟容器的內容。如果容器 (以及相關時的鑰匙) 是可消耗的 (RemainingUses > 0),其 RemainingUses 將會遞減,與 ConsumeItem 的作業一致。
  • UnlockContainerItem 在目標物品欄中搜尋符合指定 CatalogItemId 的 ItemInstance,必要時使用適當的鑰匙解鎖它,並傳回已開啟容器的內容。如果容器 (以及相關時的鑰匙) 是可消耗的 (RemainingUses > 0),其 RemainingUses 將會遞減,與 ConsumeItem 的作業一致。
  • UpdateAvatarUrl 更新玩家的虛擬人偶 URL。
  • UpdateCharacterData 建立和更新使用者角色的遊戲特定自訂資料,用戶端可讀取和寫入此資料
  • UpdateCharacterStatistics 更新特定角色之指定遊戲特定統計資料的值。根據預設,不允許用戶端更新統計資料。開發人員可以在 Game Manager > Settings > API Features 中覆寫此設定。
  • UpdatePlayerStatistics 更新使用者之指定遊戲特定統計資料的值。根據預設,不允許用戶端更新統計資料。開發人員可以在 Game Manager > Settings > API Features 中覆寫此設定。
  • UpdateSharedGroupData 新增、更新和移除共用群組物件的資料索引鍵。如果權限設定為 Public,則在此呼叫中更新或新增的所有欄位都可供不在群組中的使用者讀取。根據預設,資料權限設定為 Private。無論權限設定為何,只有群組成員可以更新資料。共用群組是為極少數玩家之間共用資料而設計的,請參閱使用共用群組資料。
  • UpdateUserData 建立和更新使用者的遊戲特定自訂資料,用戶端可讀取和寫入此資料。
  • UpdateUserPublisherData 建立和更新使用者的發行者特定自訂資料,用戶端可讀取和寫入此資料。
  • UpdateUserTitleDisplayName 更新使用者的遊戲特定顯示名稱
“PlayStation” 是 Sony Interactive Entertainment Inc. 的註冊商標或商標。 “PSN” 是 Sony Interactive Entertainment Inc. 的註冊商標或商標。

Data API

  • SetObjects 在實體的設定檔上設定物件。

Groups API

Profile API

  • SetGlobalPolicy 設定全域遊戲存取原則。
  • SetProfileLanguage 更新實體的語言。與玩家溝通的優先順序階層為遊戲玩家帳戶語言、主要玩家帳戶語言,如果前兩者未設定或不受支援,則為遊戲預設語言。
  • SetProfilePolicy 設定設定檔存取原則。

Server API

  • AddCharacterVirtualCurrency 將角色指定虛擬貨幣的餘額遞增所述的數量。
  • AddFriend 將好友使用者新增至具有 PlayFabId 之使用者的好友清單。FriendPlayFabId、FriendUsername、FriendEmail 或 FriendTitleDisplayName 中至少應初始化一個。
  • AddGenericID 將指定的一般服務識別碼新增至玩家的 PlayFab 帳戶。此功能的設計目的是允許針對遊戲想要新增的任意服務識別碼查詢 PlayFab 識別碼。此識別碼永遠不應作為驗證認證使用,因為其目的是讓其他玩家能輕鬆存取。
  • AddPlayerTag 將指定的標籤新增至玩家設定檔。標籤的命名空間會根據標籤的來源自動產生。
  • AddSharedGroupMembers 將使用者新增至能夠更新共用資料以及群組中使用者集合的使用者集合。只有群組中的使用者 (和伺服器) 可以新增成員。共用群組是為極少數玩家之間共用資料而設計的,請參閱使用共用群組資料。
  • AddUserVirtualCurrency 將使用者指定虛擬貨幣的餘額遞增所述的數量。
  • AwardSteamAchievement 將指定的 Steam 成就頒發給指定的使用者。
  • BanUsers 針對所提供的遊戲,依 PlayFab 識別碼 (可選擇搭配 IP 位址) 禁止使用者。
  • ConsumeItem 消耗可消耗物品的使用次數。當所有使用次數都消耗完畢時,它將從玩家的物品欄中移除。
  • CreateSharedGroup 要求建立共用群組物件,其中包含群組所有成員都可以更新的索引鍵/值組。由伺服器建立時,群組一開始不會有任何成員。共用群組是為極少數玩家之間共用資料而設計的,請參閱使用共用群組資料。
  • DeleteCharacterFromUser 從指定使用者刪除特定的角色識別碼。
  • DeleteSharedGroup 刪除共用群組,釋出共用群組識別碼以供新群組重複使用。共用群組是為極少數玩家之間共用資料而設計的,請參閱使用共用群組資料。
  • GrantCharacterToUser 將指定的角色類型授與使用者。CharacterId 並非全域唯一;必須將 characterId 與上層 PlayFabId 一起評估,才能保證唯一性。
  • GrantItemsToCharacter 將指定的物品新增至指定角色的物品欄。
  • GrantItemsToUser 將指定的物品新增至指定使用者的物品欄。
  • GrantItemsToUsers 將指定的物品新增至指定的使用者物品欄,
  • LinkServerCustomId 將遊戲產生的自訂伺服器識別碼連結至使用者的 PlayFab 帳戶。
  • LinkXboxAccount 將與所提供之存取碼相關聯的 XBOX Live 帳戶連結至使用者的 PlayFab 帳戶。
  • ModifyItemUses 修改玩家物品欄物品的剩餘使用次數。
  • MoveItemToCharacterFromCharacter 將物品從某個角色的物品欄移至該使用者另一個角色的物品欄。
  • MoveItemToCharacterFromUser 將物品從使用者的物品欄移至其角色的物品欄。
  • MoveItemToUserFromCharacter 將物品從角色的物品欄移至擁有該角色之使用者的物品欄。
  • RedeemCoupon 將與優惠券相關聯的虛擬商品新增至使用者的物品欄。可以透過 PlayFab Game Manager 中的 Economy->Catalogs 索引標籤產生優惠券。
  • RemoveFriend 從使用者的好友清單中移除指定的好友。
  • RemoveGenericID 從玩家的 PlayFab 帳戶移除指定的一般服務識別碼。
  • RemovePlayerTag 從玩家設定檔移除指定的標籤。標籤的命名空間會根據標籤的來源自動產生。
  • RemoveSharedGroupMembers 將使用者從能夠更新共用資料以及群組中使用者集合的使用者集合中移除。只有群組中的使用者可以移除成員。如果呼叫後沒有任何使用者保有存取權,群組及其相關資料將被刪除。共用群組是為極少數玩家之間共用資料而設計的,請參閱使用共用群組資料。
  • RevokeAllBansForUser 撤銷使用者的所有作用中禁止。
  • RevokeBans 撤銷以 BanId 指定的所有作用中禁止。
  • RevokeInventoryItem 撤銷使用者物品欄中物品的存取權。
  • RevokeInventoryItems 撤銷多位使用者和角色之間最多 25 個物品的存取權。
  • SetFriendTags 更新另一位使用者好友清單中指定使用者的標籤清單。
  • SetPlayerSecret 如果尚未設定玩家的秘密,則設定之。玩家秘密用於簽署 API 要求。若要重設玩家的秘密,請使用 Admin 或 Server API 方法 SetPlayerSecret。
  • SetPublisherData 更新自訂發行者設定的索引鍵值存放區。
  • SetTitleData /rest/api/services/playfab/server/title-wide-data-management/setpublisherdata?
  • SetTitleInternalData 更新自訂遊戲設定的索引鍵值存放區
  • SubtractCharacterVirtualCurrency 將角色指定虛擬貨幣的餘額遞減所述的數量。使用此 API 可以讓 VC 餘額變成負數。
  • SubtractUserVirtualCurrency 將使用者指定虛擬貨幣的餘額遞減所述的數量。使用此 API 可以讓 VC 餘額變成負數。
  • UnlinkServerCustomId 從使用者的 PlayFab 帳戶取消連結自訂伺服器識別碼。
  • UnlinkXboxAccount 從使用者的 PlayFab 帳戶取消連結相關的 XBOX Live 帳戶。
  • UnlockContainerInstance 以特定的鑰匙 (KeyItemInstanceId,需要時) 開啟特定的容器 (ContainerItemInstanceId),並傳回已開啟容器的內容。如果容器 (以及相關時的鑰匙) 是可消耗的 (RemainingUses > 0),其 RemainingUses 將會遞減,與 ConsumeItem 的作業一致。
  • UnlockContainerItem 在玩家或角色物品欄中搜尋任何符合指定 CatalogItemId 的 ItemInstance,必要時使用任何適當的鑰匙解鎖它,並傳回已開啟容器的內容。如果容器 (以及相關時的鑰匙) 是可消耗的 (RemainingUses > 0),其 RemainingUses 將會遞減,與 ConsumeItem 的作業一致。
  • UpdateAvatarUrl 更新指定玩家的虛擬人偶 URL。
  • UpdateBans 更新以 Ban Id 指定之現有禁止清單的資訊。
  • UpdateCharacterData 更新使用者角色的遊戲特定自訂資料,用戶端可讀取和寫入此資料。
  • UpdateCharacterInternalData 更新使用者角色的遊戲特定自訂資料,用戶端無法存取此資料。
  • UpdateCharacterReadOnlyData 更新使用者角色的遊戲特定自訂資料,用戶端只能讀取此資料。
  • UpdateCharacterStatistics 更新特定角色之指定遊戲特定統計資料的值。
  • UpdatePlayerStatistics 更新使用者之指定遊戲特定統計資料的值。
  • UpdateUserData 更新使用者的遊戲特定自訂資料,用戶端可讀取和寫入此資料。
  • UpdateUserInternalData 更新使用者的遊戲特定自訂資料,用戶端無法存取此資料。
  • UpdateUserInventoryItemCustomData 更新標記至指定物品的索引鍵值組資料,用戶端只能讀取此資料。
  • UpdateUserPublisherData 更新使用者的發行者特定自訂資料,用戶端可讀取和寫入此資料。
  • UpdateUserPublisherInternalData 更新使用者的發行者特定自訂資料,用戶端無法存取此資料。
  • UpdateUserPublisherReadOnlyData 更新使用者的發行者特定自訂資料,用戶端只能讀取此資料。
  • UpdateUserReadOnlyData 更新使用者的遊戲特定自訂資料,用戶端只能讀取此資料。
最後修改於 2026年10月8日