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

# Referenciar servidores do XBOX Game Streaming em declarações XSTS

> Configure a declaração Device capabilities (dca) no Partner Center e interprete-a no lado do servidor para detectar servidores do XBOX Game Streaming a partir de um token XSTS.

Em determinados cenários, seu jogo pode precisar referenciar e identificar especificamente quais usuários estão vindo de servidores do XBOX Game Streaming.

Para isso, as seguintes etapas devem ser executadas no Partner Center:

1. No Partner Center, navegue até a terceira parte confiável (Relying Party) aplicável e selecione a declaração apropriada encontrada em [Declarações do token de segurança dos XBOX services (microsoft.com) (tópico sob NDA)](/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-token-claims). Para entender qual declaração usar e qual valor é esperado, procure o termo "XBOX Game Streaming server" na documentação de declarações vinculada.
2. Atualize o esquema de declarações para incluir a variável apropriada que referencia o XBOX Game Streaming.
3. Volte ao menu principal 'Relying Parties' e clique em 'Publish'.

<Note>Ajustes em uma terceira parte confiável existente exigirão a reinicialização do dispositivo e do título (para limpar o cache do console) a fim de obter tokens XSTS recém-emitidos (ou aguardar um período de cerca de 4 horas para que o anterior expire).</Note>

## Detectar um servidor do XBOX Game Streaming a partir da declaração Device capabilities (`dca`)

Depois de configurar sua terceira parte confiável para incluir a declaração Device capabilities, seu serviço pode inspecionar o valor `dca` dentro da seção `xdi` (identidade do dispositivo) do token XSTS descriptografado para determinar se o token foi emitido em um servidor do XBOX Game Streaming.

A declaração `dca` é uma matriz de inteiros. Interprete-a da seguinte forma:

| Valor de `dca` | Significado |
| - | - |
| `2`, `1 2` ou `2 1` | O dispositivo é um servidor do XBOX Game Streaming (com ou sem ODD). Trate-o como uma instância de nuvem. |
| `1` ou nenhum valor | O dispositivo é um hardware de console XBOX (com ou sem ODD). Trate-o como um dispositivo sem streaming. |
| Declaração omitida do token | A terceira parte confiável não está configurada para emitir `dca`, ou o token veio de um cliente que não emite declarações de identidade do dispositivo (por exemplo, plataformas que não são XBOX). Trate a ausência como um dispositivo sem streaming somente depois de confirmar que a terceira parte confiável emite `dca` para tokens do XBOX. |

Como uma declaração omitida é indistinguível de uma terceira parte confiável configurada incorretamente, verifique se a sua terceira parte confiável publica a declaração `dca` (etapa 1 acima) antes de confiar na ausência como sinal. Para ver a tabela completa de valores de `dca` e outras declarações, consulte [Declarações do token de segurança dos XBOX services](/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-token-claims). Para ver um exemplo de token decodificado que mostra o campo `xdi.dca`, consulte [Exemplo de token XSTS, descriptografia e validação](/pt-BR/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-sample-xsts-token).

<Note>No lado do cliente, o próprio jogo pode chamar [`XGameStreamingIsStreaming`](/pt-BR/build/core-features/common/game-streaming/game-streaming-am-i-streaming) para detectar uma conexão de streaming ativa. A declaração `dca` é o sinal equivalente no lado do servidor para o serviço do seu título.</Note>

## ID de pares do dispositivo (`dpi`) em servidores do XBOX Game Streaming

A declaração Device pairwise ID (`dpi`) identifica o hardware físico que emitiu o token. Em servidores do XBOX Game Streaming, esse hardware é um servidor compartilhado em um datacenter do Azure, portanto o mesmo valor de `dpi` pode aparecer para vários usuários diferentes ao longo do tempo.

Se o seu serviço aplica banimentos ou limites de taxa por dispositivo usando `dpi`, condicione essa aplicação primeiro ao valor de `dca`. Quando `dca` indicar um servidor de streaming, exclua o `dpi` do token dos banimentos e limites de taxa no nível do dispositivo, para não penalizar usuários não relacionados que fizerem streaming posteriormente a partir do mesmo servidor.


## Related topics

- [Referencia a los servidores de XBOX Game Streaming en las notificaciones XSTS](/es/build/core-features/common/game-streaming/game-streaming-referencing-xcloud-servers-in-xsts-claims.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Requisitos do XBOX para jogos do XBOX](/pt-BR/publishing/certification/xbox-requirements.md)
- [Requisitos XBOX testados na certificação para jogos de console XBOX](/pt-BR/publishing/certification/console-cert-tested-requirements.md)
- [Optimización de tu juego para XBOX Game Streaming](/es/build/core-features/common/game-streaming/game-streaming-optimizing-your-game.md)