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

# XR-046 Nome de exibição e imagem do jogador

> XR-046 Nome de exibição e imagem do jogador

Versão 2.0, 10/01/2024

Nos consoles XBOX, os títulos devem usar a gamertag como nome de exibição principal.

Com base na escolha de design, os títulos podem optar entre a gamertag moderna ou a gamertag clássica do jogador. A gamertag moderna está disponível no GDK, e a gamertag clássica está disponível tanto no ERA quanto no GDK.

Em plataformas que não são consoles, embora não seja obrigatório, recomendamos que você use a gamertag do jogador da rede XBOX nos locais apropriados da experiência do título do jogo.

A gamertag deve ser exibida corretamente no título com base no tipo de gamertag usado:

**Gamertag moderna**<br />Exiba todos os 16 caracteres da gamertag moderna exclusiva, que inclui até 12 caracteres da gamertag moderna, seguidos por # e pelo número do sufixo (se houver). Por exemplo: Major Nelson (sem sufixo) ou Major Nelson#881. Se forem usadas gamertags modernas, todos os intervalos de caracteres Unicode disponíveis para gamertags modernas devem ter suporte. Para obter mais informações e práticas recomendadas sobre gamertags modernas, consulte o artigo "Visão geral das gamertags modernas" na documentação de desenvolvimento do GDK.

**Gamertag clássica**<br />Exiba corretamente todos os 15 caracteres da gamertag clássica. As gamertags clássicas incluem apenas os caracteres ASCII a-z, A-Z, 0-9, vírgula (,) e espaço (caractere ASCII 0x20). Por exemplo: Major Nelson

No GDK, esses itens são retornados usando a API [XUserGetGamertag](/pt-BR/reference/system/xuser/functions/xusergetgamertag). No ERA, a gamertag é obtida usando a API `GetUserProfileAsync`.

> \[!Note]
> O suporte a diacríticos Unicode exigido para tailandês e devanágari, ambos idiomas com suporte nas gamertags modernas, frequentemente causa problemas que só são detectados em estágios posteriores dos testes. Se você pretende oferecer suporte a gamertags modernas no seu jogo, planeje e teste caracteres desses idiomas com antecedência.

## Casos de teste de certificação

### 046-01 Nome de exibição e imagem do jogador

**Ferramentas necessárias**

* *XblTestAccountGui.exe* do GDK

**Preparação**<br />Crie quatro contas de teste, uma para cada um dos nomes a seguir, e altere a gamertag de cada conta de teste usando *XblTestAccountGui.exe* para o seguinte:

* **สฐ众нь컴퓨퓨**
* **आथाώঙぁヺ**
* **øÜêþЯЂў**
* **gttest1**

**Etapas de teste**

1. Localize e visualize os locais onde as gamertags são exibidas no título.
2. Verifique como a gamertag dos usuários é exibida em todas as áreas identificadas na etapa \[1].
3. Se o título exibir imagens dos usuários, verifique se a imagem da conta Microsoft ou a imagem do jogador correta aparece para cada conta.

**Resultado esperado**<br />A gamertag do usuário deve ser exibida corretamente.

**Exemplos de aprovação**

1. A gamertag mostra corretamente os caracteres Unicode (incluindo o sufixo gerado automaticamente) ao usar a gamertag moderna.
2. A gamertag é mostrada corretamente ao usar a gamertag clássica.

**Exemplos de falha**

1. A gamertag não é renderizada porque os caracteres Unicode são mostrados como caracteres em branco.
2. A gamertag não é mostrada corretamente ao usar a gamertag clássica.


## Related topics

- [Conteúdo de suporte aos requisitos e políticas do XBOX](/pt-BR/publishing/certification/xr/overview.md)
- [XR046 Nome de exibição e imagem do jogador](/pt-BR/publishing/certification/fma/xr-046.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)
- [XR-047 Acesso ao perfil do usuário](/pt-BR/publishing/certification/xr/xr-047.md)