方法 (1/2)
設定代表實體執行程式庫動作時,用於驗證的權杖。如果先前已為該實體設定權杖,則會取代其先前的權杖。備註 (1/2)
此方法接受 PlayFab 登入方法所傳回的 PlayFabAuthenticationContextauthContext。當程式庫代表實體執行需要驗證或授權的作業 (例如建立或更新大廳) 時,程式庫會查閱與該實體相關聯的權杖以用於作業。如果先前未為該實體設定任何權杖,作業會同步失敗。在非同步作業期間,PlayFab 服務會驗證權杖是否有效、未過期、與提供的實體識別碼相關聯,且已獲授權執行該作業。如果不符合這些條件,作業就會失敗。
PlayFab 實體索引鍵和實體權杖可以從 PlayFab 登入作業的輸出取得,然後作為此方法的輸入提供。
提供的 authContext 必須是使用傳遞給 Initialize 的相同 PlayFab 遊戲識別碼所取得。
Multiplayer 程式庫會複製所提供的 PlayFab 實體權杖,以供後續需要驗證或授權本機使用者的作業使用,例如 CreateAndJoinLobby。如果提供給此呼叫的權杖已過期或因其他原因無效,則需要有效權杖的作業將會失敗。可以使用相同的實體索引鍵再次呼叫此方法,將新的有效權杖提供給 Multiplayer 程式庫。
呼叫者負責監視提供給此方法之實體權杖的到期情況。當權杖接近或超過到期時間時,應執行 PlayFab 登入作業以取得新的權杖,並再次呼叫此方法將其提供給 Multiplayer 程式庫。建議在先前提供的權杖有效期間過半時取得新的權杖。在可能進入低電源狀態或因其他原因導致應用程式長時間暫停執行、使權杖無法在到期前重新整理的平台上,應在恢復執行後檢查權杖是否已到期。
方法 (2/2)
設定代表實體執行程式庫動作時,用於驗證的權杖。如果先前已為該實體設定權杖,則會取代其先前的權杖。備註 (2/2)
此方法接受 PlayFab 實體索引鍵作為 localMember,以及 PlayFab 實體權杖作為 entityToken。當程式庫代表實體執行需要驗證或授權的作業 (例如建立或更新大廳) 時,程式庫會查閱與該實體相關聯的權杖以用於作業。如果先前未為該實體設定任何權杖,作業會同步失敗。在非同步作業期間,PlayFab 服務會驗證權杖是否有效、未過期、與提供的實體識別碼相關聯,且已獲授權執行該作業。如果不符合這些條件,作業就會失敗。 PlayFab 實體索引鍵和實體權杖可以從 PlayFab 登入作業的輸出取得,然後作為此方法的輸入提供。 提供的 localMember 和 entityToken 必須是使用傳遞給Initialize 的相同 PlayFab 遊戲識別碼所取得。
Multiplayer 程式庫會複製所提供的 PlayFab 實體權杖,以供後續需要驗證或授權本機使用者的作業使用,例如 CreateAndJoinLobby。如果提供給此呼叫的權杖已過期或因其他原因無效,則需要有效權杖的作業將會失敗。可以使用相同的實體索引鍵再次呼叫此方法,將新的有效權杖提供給 Multiplayer 程式庫。
呼叫者負責監視提供給此方法之實體權杖的到期情況。當權杖接近或超過到期時間時,應執行 PlayFab 登入作業以取得新的權杖,並再次呼叫此方法將其提供給 Multiplayer 程式庫。建議在先前提供的權杖有效期間過半時取得新的權杖。在可能進入低電源狀態或因其他原因導致應用程式長時間暫停執行、使權杖無法在到期前重新整理的平台上,應在恢復執行後檢查權杖是否已到期。
另請參閱
- method Initialize
- class PFEntityKey
- class PlayFabMultiplayer
- namespace PlayFab.Multiplayer
