> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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

> Como os títulos devem exibir a gamertag moderna ou clássica como nome de exibição principal nos consoles XBOX, além do caso de teste 046-01 para gamertags e imagens 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**\
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**\
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](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergetgamertag.md). 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**\
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**\
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](https://docs.xbox.com/pt-BR/publishing/certification/xr/overview.md)
- [XR046 Nome de exibição e imagem do jogador](https://docs.xbox.com/pt-BR/publishing/certification/fma/xr-046.md)
- [Requisitos do XBOX para jogos do XBOX](https://docs.xbox.com/pt-BR/publishing/certification/xbox-requirements.md)
- [Requisitos XBOX testados na certificação para jogos XBOX](https://docs.xbox.com/pt-BR/publishing/certification/console-cert-tested-requirements.md)
- [XUserGetGamerPictureAsync](https://docs.xbox.com/pt-BR/reference/system/xuser/functions/xusergetgamerpictureasync.md)