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

## 方法(2 个方法中的第 1 个)

设置在代表某个实体执行库操作时应使用的身份验证令牌。如果先前已为该实体设置过令牌,此调用将替换其之前的令牌。

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

| parameter   | description                                    |
| ----------- | ---------------------------------------------- |
| localMember | 包含实体和令牌的 PlayFab PlayFabAuthenticationContext。 |

## 备注(2 个中的第 1 个)

此方法接受一个由 PlayFab 登录方法返回的 PlayFabAuthenticationContext `authContext`。当库代表实体执行需要身份验证或授权的操作时(例如创建或更新大厅),库将查找与该实体关联的令牌用于该操作。如果先前未为该实体设置任何令牌,则该操作将同步失败。在异步操作期间,PlayFab 服务将验证令牌是否有效、未过期、与所提供的 Entity ID 相关联,以及是否已获授权执行该操作。如果不满足这些条件,操作将失败。

PlayFab Entity Key 和 Entity Token 可从 PlayFab 登录操作的输出中获取,然后作为此方法的输入提供。

所提供的 `authContext` 必须使用与传递给 [`Initialize`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/Initialize) 相同的 PlayFab Title ID 获取。

Multiplayer 库会复制所提供的 PlayFab Entity Token,用于后续需要对本地用户进行身份验证或授权的操作(例如 [`CreateAndJoinLobby`](/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)
```

| parameter   | description                   |
| ----------- | ----------------------------- |
| localMember | 要与令牌关联的 PlayFab Entity Key。   |
| entityToken | 要与实体关联的 PlayFab Entity token。 |

## 备注(2 个中的第 2 个)

此方法接受 PlayFab Entity Key 作为 *localMember*、PlayFab Entity Token 作为 *entityToken*。当库代表实体执行需要身份验证或授权的操作时(例如创建或更新大厅),库将查找与该实体关联的令牌用于该操作。如果先前未为该实体设置任何令牌,则该操作将同步失败。在异步操作期间,PlayFab 服务将验证令牌是否有效、未过期、与所提供的 Entity ID 相关联,以及是否已获授权执行该操作。如果不满足这些条件,操作将失败。

PlayFab Entity Key 和 Entity Token 可从 PlayFab 登录操作的输出中获取,然后作为此方法的输入提供。

所提供的 *localMember* 和 *entityToken* 必须使用与传递给 [`Initialize`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/Initialize) 相同的 PlayFab Title ID 获取。

Multiplayer 库会复制所提供的 PlayFab Entity Token,用于后续需要对本地用户进行身份验证或授权的操作(例如 [`CreateAndJoinLobby`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateAndJoinLobby))。如果提供给此调用的令牌已过期或无效,则需要有效令牌的操作将失败。可以通过再次使用相同的实体密钥调用此方法,向 Multiplayer 库提供一个新的、有效的令牌。

调用方负责监视提供给此方法的实体令牌的过期时间。当令牌即将过期或已过期时,应通过执行 PlayFab 登录操作获取新令牌,并再次调用此方法将其提供给 Multiplayer 库。建议在先前提供的令牌达到其有效期的一半时获取新令牌。在可能进入低功耗状态或以其他方式使应用程序长时间暂停执行(从而无法在令牌过期之前刷新)的平台上,应在执行恢复后立即检查令牌是否过期。

## 另请参阅

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


## Related topics

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