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

## Método (1 de 2)

Define o token que deve ser usado para autenticação ao realizar ações da biblioteca em nome de uma entidade. Se um token já tiver sido definido anteriormente para a entidade, este substituirá o token anterior.

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

| parâmetro | descrição |
| - | - |
| localMember | O PlayFabAuthenticationContext do PlayFab que contém a entidade e o token. |

## Comentários (1 de 2)

Este método recebe um PlayFabAuthenticationContext `authContext` retornado por um método de login do PlayFab. Quando a biblioteca realiza operações em nome de uma entidade que exigem autenticação ou autorização, como criar ou atualizar um lobby, ela procura um token associado à entidade para usar na operação. Se nenhum token tiver sido definido anteriormente para a entidade, a operação falhará de forma síncrona. Durante a operação assíncrona, o serviço PlayFab validará se o token é válido, não está expirado, está associado à ID de entidade fornecida e tem autorização para realizar a operação. Se essas condições não forem atendidas, a operação falhará.

Uma chave de entidade do PlayFab e um token de entidade podem ser obtidos a partir da saída de uma operação de login do PlayFab e, em seguida, fornecidos como entrada para este método.

O `authContext` fornecido deve ter sido obtido usando a mesma ID de título do PlayFab que foi passada para [`Initialize`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/Initialize).

A biblioteca Multiplayer faz uma cópia do token de entidade do PlayFab fornecido para uso em operações subsequentes que exigem autenticação ou autorização do usuário local, como [`CreateAndJoinLobby`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateAndJoinLobby). Se o token fornecido a esta chamada estiver expirado ou for inválido de outra forma, as operações que exigem um token válido falharão. Um token novo e válido pode ser fornecido à biblioteca Multiplayer chamando este método novamente com a mesma chave de entidade.

O chamador é responsável por monitorar a expiração do token de entidade fornecido a este método. Quando o token estiver próximo do horário de expiração ou já o tiver ultrapassado, um novo token deverá ser obtido realizando uma operação de login do PlayFab e fornecido à biblioteca Multiplayer chamando este método novamente. É recomendável obter um novo token quando o token fornecido anteriormente atingir a metade do seu período de validade. Em plataformas que podem entrar em um estado de baixo consumo de energia ou que, de outra forma, possam fazer com que o aplicativo pause a execução por um longo período, impedindo que o token seja atualizado antes de expirar, a expiração do token deve ser verificada assim que a execução for retomada.

***

## Método (2 de 2)

Define o token que deve ser usado para autenticação ao realizar ações da biblioteca em nome de uma entidade. Se um token já tiver sido definido anteriormente para a entidade, este substituirá o token anterior.

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

| parâmetro | descrição |
| - | - |
| localMember | A chave de entidade do PlayFab a ser associada a um token. |
| entityToken | O token de entidade do PlayFab a ser associado a uma entidade. |

## Comentários (2 de 2)

Este método recebe uma chave de entidade do PlayFab como *localMember* e um token de entidade do PlayFab como *entityToken*. Quando a biblioteca realiza operações em nome de uma entidade que exigem autenticação ou autorização, como criar ou atualizar um lobby, ela procura um token associado à entidade para usar na operação. Se nenhum token tiver sido definido anteriormente para a entidade, a operação falhará de forma síncrona. Durante a operação assíncrona, o serviço PlayFab validará se o token é válido, não está expirado, está associado à ID de entidade fornecida e tem autorização para realizar a operação. Se essas condições não forem atendidas, a operação falhará.

Uma chave de entidade do PlayFab e um token de entidade podem ser obtidos a partir da saída de uma operação de login do PlayFab e, em seguida, fornecidos como entrada para este método.

O *localMember* e o *entityToken* fornecidos devem ter sido obtidos usando a mesma ID de título do PlayFab que foi passada para [`Initialize`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/Initialize).

A biblioteca Multiplayer faz uma cópia do token de entidade do PlayFab fornecido para uso em operações subsequentes que exigem autenticação ou autorização do usuário local, como [`CreateAndJoinLobby`](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateAndJoinLobby). Se o token fornecido a esta chamada estiver expirado ou for inválido de outra forma, as operações que exigem um token válido falharão. Um token novo e válido pode ser fornecido à biblioteca Multiplayer chamando este método novamente com a mesma chave de entidade.

O chamador é responsável por monitorar a expiração do token de entidade fornecido a este método. Quando o token estiver próximo do horário de expiração ou já o tiver ultrapassado, um novo token deverá ser obtido realizando uma operação de login do PlayFab e fornecido à biblioteca Multiplayer chamando este método novamente. É recomendável obter um novo token quando o token fornecido anteriormente atingir a metade do seu período de validade. Em plataformas que podem entrar em um estado de baixo consumo de energia ou que, de outra forma, possam fazer com que o aplicativo pause a execução por um longo período, impedindo que o token seja atualizado antes de expirar, a expiração do token deve ser verificada assim que a execução for retomada.

## Confira também

* método [Initialize](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/Initialize)
* classe [PFEntityKey](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview)
* classe [PlayFabMultiplayer](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/overview)
* namespace [PlayFab.Multiplayer](/pt-BR/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference)


## Related topics

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