語法
參數
entityToken PartyString
要與本機使用者相關聯的新 PlayFab 實體權杖。
傳回值
PartyErrorc_partyErrorSuccess (如果呼叫成功)，否則為錯誤碼。可透過 PartyManager::GetErrorMessage() 擷取錯誤碼的人類可讀形式。
備註
此方法接受 PlayFab 實體權杖 (作為entityToken)。不會對此值執行同步驗證。當程式庫執行需要使用者驗證或授權的作業 (例如建立網路、驗證進入網路或執行語音轉文字轉譯) 時，Party 服務會驗證權杖是否有效、未過期、與提供給 PartyManager::CreateLocalUser() 或 PartyManager::CreateLocalUserWithEntityType() 呼叫的相同實體識別碼相關聯，且已獲授權執行該作業。如果不符合這些條件，作業就會失敗。 PlayFab 實體權杖可以從 PlayFab 登入作業的輸出取得，然後作為此方法的輸入提供。權杖必須與最初指定給 PartyManager::CreateLocalUser() 或 PartyManager::CreateLocalUserWithEntityType() 的相同 PlayFab 實體識別碼和類型相關聯。
提供的
entityToken 必須是使用傳遞給 PartyManager::Initialize() 的相同遊戲識別碼所取得。 Party 程式庫會複製所提供的 PlayFab 實體權杖，以供後續需要驗證或授權本機使用者的作業使用，例如 PartyManager::CreateNewNetwork() 或 PartyNetwork::AuthenticateLocalUser()。如果提供給此呼叫的權杖已過期或因其他原因無效，則需要有效權杖的作業將會失敗。可以再次呼叫此方法，將新的有效權杖提供給 Party 程式庫。
呼叫者負責監視提供給此方法和 PartyManager::CreateLocalUser() 或 PartyManager::CreateLocalUserWithEntityType() 之實體權杖的到期情況。當權杖接近或超過到期時間時，應執行 PlayFab 登入作業以取得新的權杖，並呼叫此方法將其提供給 Party 程式庫。建議在先前提供的權杖有效期間過半時取得新的權杖。在可能進入低電源狀態或因其他原因導致應用程式長時間暫停執行、使權杖無法在到期前重新整理的平台上，應在恢復執行後檢查權杖是否已到期。
需求
標頭： Party.h另請參閱
PartyLocalUserPartyManager::GetErrorMessage
PartyManager::CreateLocalUser
PartyManager::CreateLocalUserWithEntityType
PartyManager::CreateNewNetwork
PartyNetwork::AuthenticateLocalUser