> ## 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.

# PlayFabMultiplayer.SetEntityToken

> PlayFabMultiplayer.SetEntityToken

## 方法 (1/2)

設定代表實體執行程式庫動作時，用於驗證的權杖。如果先前已為該實體設定權杖，則會取代其先前的權杖。

```csharp theme={null}
public static void SetEntityToken(PlayFabAuthenticationContext localMember)
```

| 參數 | 描述 |
| - | - |
| localMember | 包含實體和權杖的 PlayFab PlayFabAuthenticationContext。 |

## 備註 (1/2)

此方法接受 PlayFab 登入方法所傳回的 PlayFabAuthenticationContext `authContext`。當程式庫代表實體執行需要驗證或授權的作業 (例如建立或更新大廳) 時，程式庫會查閱與該實體相關聯的權杖以用於作業。如果先前未為該實體設定任何權杖，作業會同步失敗。在非同步作業期間，PlayFab 服務會驗證權杖是否有效、未過期、與提供的實體識別碼相關聯，且已獲授權執行該作業。如果不符合這些條件，作業就會失敗。

PlayFab 實體索引鍵和實體權杖可以從 PlayFab 登入作業的輸出取得，然後作為此方法的輸入提供。

提供的 `authContext` 必須是使用傳遞給 [`Initialize`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/Initialize) 的相同 PlayFab 遊戲識別碼所取得。

Multiplayer 程式庫會複製所提供的 PlayFab 實體權杖，以供後續需要驗證或授權本機使用者的作業使用，例如 [`CreateAndJoinLobby`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateAndJoinLobby)。如果提供給此呼叫的權杖已過期或因其他原因無效，則需要有效權杖的作業將會失敗。可以使用相同的實體索引鍵再次呼叫此方法，將新的有效權杖提供給 Multiplayer 程式庫。

呼叫者負責監視提供給此方法之實體權杖的到期情況。當權杖接近或超過到期時間時，應執行 PlayFab 登入作業以取得新的權杖，並再次呼叫此方法將其提供給 Multiplayer 程式庫。建議在先前提供的權杖有效期間過半時取得新的權杖。在可能進入低電源狀態或因其他原因導致應用程式長時間暫停執行、使權杖無法在到期前重新整理的平台上，應在恢復執行後檢查權杖是否已到期。

***

## 方法 (2/2)

設定代表實體執行程式庫動作時，用於驗證的權杖。如果先前已為該實體設定權杖，則會取代其先前的權杖。

```csharp theme={null}
public static void SetEntityToken(PFEntityKey localMember, string entityToken)
```

| 參數 | 描述 |
| - | - |
| localMember | 要與權杖相關聯的 PlayFab 實體索引鍵。 |
| entityToken | 要與實體相關聯的 PlayFab 實體權杖。 |

## 備註 (2/2)

此方法接受 PlayFab 實體索引鍵作為 *localMember*，以及 PlayFab 實體權杖作為 *entityToken*。當程式庫代表實體執行需要驗證或授權的作業 (例如建立或更新大廳) 時，程式庫會查閱與該實體相關聯的權杖以用於作業。如果先前未為該實體設定任何權杖，作業會同步失敗。在非同步作業期間，PlayFab 服務會驗證權杖是否有效、未過期、與提供的實體識別碼相關聯，且已獲授權執行該作業。如果不符合這些條件，作業就會失敗。

PlayFab 實體索引鍵和實體權杖可以從 PlayFab 登入作業的輸出取得，然後作為此方法的輸入提供。

提供的 *localMember* 和 *entityToken* 必須是使用傳遞給 [`Initialize`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/Initialize) 的相同 PlayFab 遊戲識別碼所取得。

Multiplayer 程式庫會複製所提供的 PlayFab 實體權杖，以供後續需要驗證或授權本機使用者的作業使用，例如 [`CreateAndJoinLobby`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateAndJoinLobby)。如果提供給此呼叫的權杖已過期或因其他原因無效，則需要有效權杖的作業將會失敗。可以使用相同的實體索引鍵再次呼叫此方法，將新的有效權杖提供給 Multiplayer 程式庫。

呼叫者負責監視提供給此方法之實體權杖的到期情況。當權杖接近或超過到期時間時，應執行 PlayFab 登入作業以取得新的權杖，並再次呼叫此方法將其提供給 Multiplayer 程式庫。建議在先前提供的權杖有效期間過半時取得新的權杖。在可能進入低電源狀態或因其他原因導致應用程式長時間暫停執行、使權杖無法在到期前重新整理的平台上，應在恢復執行後檢查權杖是否已到期。

## 另請參閱

* method [Initialize](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/Initialize)
* class [PFEntityKey](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview)
* class [PlayFabMultiplayer](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/overview)
* namespace [PlayFab.Multiplayer](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference)


## Related topics

- [PlayFabMultiplayerManager.Get().UpdateEntityToken](/zh-TW/services/playfab/multiplayer/networking/unity-party-api-reference/classes/playfabmultiplayermanager/methods/playfabunityupdateentitytoken.md)
- [PlayFabMultiplayer.Initialize](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/Initialize.md)
- [PFMultiplayerSetEntityToken](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken.md)
- [CreateServerBackfillTicket](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/CreateServerBackfillTicket.md)
- [PFMultiplayerInitialize](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayerinitialize.md)