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

# Configurando cadeias de caracteres de Rich Presence

> Como definir conjuntos de cadeias de caracteres de Rich Presence do XBOX Live com valores localizados, enumerações e parâmetros de estatísticas baseadas em eventos para textos de atividade dinâmicos.

Este artigo descreve como as cadeias de caracteres de Rich Presence são configuradas.

## Cadeias de caracteres

Para suas cadeias de caracteres de Rich Presence, você precisa definir os conjuntos de cadeias.
Recomendamos dar a cada conjunto de cadeias um nome amigável para usar como identificador.

Cada conjunto de cadeias que você criar precisa conter um grupo de cadeias de caracteres localizadas adequadamente para as localidades em que o jogo será lançado.

Além das cadeias de caracteres localizadas, você também precisa fornecer uma cadeia de caracteres neutra em relação à cultura.
Essa cadeia é usada se for feita uma requisição para uma localidade que não está presente.

Cada conjunto de cadeias também pode usar dados do jogo, parametrizando as cadeias para aprimorá-las ainda mais.
Um conjunto de cadeias pode ter quantos parâmetros você quiser, desde que as cadeias resultantes não excedam os limites de caracteres. Para obter mais informações, consulte [Políticas e limites das cadeias de caracteres de Rich Presence](/pt-BR/services/xbox-services/community/presence/concepts/live-presence-limits).

## Enumerações

As enumerações descritas a seguir são definidas por meio dos eventos dos Player Data do XBOX.

## Estatísticas

Você pode usar valores de estatísticas numéricas baseadas em eventos nas suas cadeias de caracteres de Rich Presence.
Por exemplo, em um jogo de tiro, talvez você queira que a cadeia de caracteres de Rich Presence mostre quantos abates o jogador tem no momento.

A configuração precisa indicar que o parâmetro é substituído pela estatística "Kill Count".
Ela foi criada pelo sistema de eventos Common Schema e está sendo passada ou encaminhada ao serviço XBOX Player Stats para ser transformada em dados do jogador. A estatística precisa ser definida usando a configuração de estatísticas.

Quando a cadeia de caracteres é lida por outro jogador, o serviço Rich Presence recupera o valor mais atualizado da estatística "Kill Count". Como resultado, a cadeia de caracteres está sempre atualizada.

As cadeias de caracteres de Rich Presence com variáveis são compatíveis apenas com estatísticas numéricas baseadas em eventos, e não com estatísticas gerenciadas pelo título.

## Estado

Você também pode optar por usar estatísticas que representam valores de estado reais nas suas cadeias de caracteres de Rich Presence.
Por exemplo, em um jogo de corrida, você pode usar uma cadeia de caracteres de Rich Presence para mostrar qual carro o jogador está dirigindo no momento ou em qual mapa ou pista ele está correndo.

**Para configurar as informações de estado**

1. Defina enumerações para quaisquer cadeias de caracteres do jogo. Por exemplo, se o seu jogo tiver cinco mapas e você quiser que esses mapas façam parte das suas cadeias de caracteres de Rich Presence, os cinco mapas também precisarão ser enumerados em cadeias de caracteres localizadas.

2. Vincule as enumerações às estatísticas. O serviço Rich Presence novamente recupera o valor mais atualizado dos dados do jogador consultando o valor da estatística. Em seguida, o serviço determina para qual valor de enumeração a estatística se traduz.

## Jogo de exemplo

No restante do exemplo, suponha que você esteja trabalhando no mais recente jogo de chutar baldes. Você deseja criar uma estatística para cada tipo de balde chutado e, em seguida, exibir as estatísticas usando cadeias de caracteres de Rich Presence.

Suponha que as regras do jogo sejam as seguintes:

* Os tipos de balde são madeira, prata e ouro.

* Os locais são as montanhas, o deserto e a praia.

* Quando um balde é chutado, ele se quebra. O jogador precisa sempre procurar mais baldes.

* Alguns baldes exigem equipamento especial para serem chutados com sucesso. Por exemplo, uma bota precisa ser forte o suficiente para aguentar um chute.

* O jogo tem um modo multiplayer. Se houver jogadores suficientes tentando chutar um balde ao mesmo tempo, uma bota específica não será necessária.

A configuração das cadeias de caracteres de Rich Presence fica assim para esse jogo.

## Configurando estatísticas para o Rich Presence

Para usar uma estatística gerada pelos Player Data do XBOX nas suas cadeias de caracteres de Rich Presence, forneça os nomes ao serviço Rich Presence.

## Exemplo de configuração de enumeração

Aqui está um exemplo de definição de algumas enumerações.

1. Crie uma enumeração para os mapas do jogo. O jogo tem três mapas. Cada um recebe um nome amigável para que possa ser referenciado facilmente.

2. Para cada localidade, crie uma cadeia de caracteres localizada para esse nome de mapa. Observe que há uma localização padrão geral e uma neutra em relação à cultura.

3. Considere as três armas do jogo. Elas têm nomes amigáveis e cadeias de caracteres localizadas. Isso vale para todas as enumerações.

| Enumeração | Estatística relacionada | Nome amigável | Localidade | Cadeia de caracteres |
| - | - | - | - | - |
| Map | CurrentMap | Map\_Mountains | Default | Mountains |
| | | | en | Mountains |
| | | | en-US | Mountains |
| | | | en-GB | Mountains |
| | | | de-DE | Gebirge |
| | | | Outras localidades | |
| | | Map\_Desert | Default | Desert |
| | | | en | Desert |
| | | | en-US | Desert |
| | | | en-GB | Desert |
| | | | de-DE | Wuste |
| | | | Outras localidades | |
| | | Map\_Beach | default | Beach |
| | | | en | Beach |
| | | | en-US | Beach |
| | | | en-GB | Beach |
| | | | de-DE | Strand |
| | | | Outras localidades | |
| Boot | CurrentWeapon | Boot\_Light | Default | Light |
| | | | en | Light |
| | | | en-US | Light |
| | | | en-GB | Light |
| | | | de-DE | Leicht |
| | | | Outras localidades | |
| | | Boot\_Medium | Default | Medium |
| | | | en | Medium |
| | | | en-US | Medium |
| | | | en-GB | Medium |
| | | | de-DE | Mittel |
| | | | Outras localidades | |
| | | Boot\_Strong | Default | Strong |
| | | | en | Strong |
| | | | en-US | Strong |
| | | | en-GB | Strong |
| | | | de-DE | Stark |
| | | | Outras localidades | |

## Exemplo de configuração de cadeias de caracteres

Agora que as enumerações e as estatísticas foram definidas, crie suas cadeias de caracteres.

Na tabela de exemplo a seguir, a primeira coluna é um nome amigável para ajudar a diferenciar um conjunto de cadeias de outro.
Neste exemplo, a cadeia "playingMap" é usada para o primeiro conjunto de cadeias, "totalKicked" para o segundo e "multiplayer" para o terceiro.

### Pares de localidade e cadeia de caracteres

As duas colunas seguintes andam juntas.
Elas são os pares de localidade e cadeia de caracteres da cadeia de Rich Presence.

No primeiro exemplo, é usada a cadeia "Playing on {0}" em inglês.
O token {0} é substituído por um valor.

Em seguida, a cadeia é localizada para outras localidades.

Assim como nas enumerações, é preciso haver uma cadeia padrão e cadeias neutras em relação à cultura. Elas são usadas quando um jogador usa uma localidade para a qual você não especificou um par de localidade e cadeia de caracteres.
As localidades usadas nas enumerações precisam corresponder às localidades das suas cadeias de caracteres.

### Parâmetros para construir uma cadeia de caracteres

A última coluna contém os parâmetros usados para preencher as lacunas na cadeia de caracteres de Rich Presence.

Se você quiser que o serviço Presence consulte o valor do parâmetro no serviço de estatísticas, precisará usar aqui o nome da estatística para referenciar o parâmetro.
Usar estatísticas nas suas cadeias permite defini-las uma única vez. Você não precisa reescrevê-las.

Se a sua cadeia de caracteres contiver o nome do mapa e você estiver usando a estatística `CurrentMap` para preencher a lacuna, o serviço Rich Presence atualizará a cadeia adequadamente à medida que os jogadores passam de um mapa para outro no jogo.
Se você não usar estatísticas nas suas cadeias de caracteres de Rich Presence, nenhum parâmetro poderá ser especificado.

Na tabela de exemplo a seguir, use o mapa atual gerado pelas estatísticas na primeira cadeia. Use a estatística `BucketsKicked` na segunda cadeia.

O terceiro exemplo não inclui parâmetros.
A cadeia é definida por si só; ela não faz referência a estatísticas.

| Nome amigável | Localidade | Cadeia de caracteres | Parâmetros |
| - | - | - | - |
| playingMap | Default | Playing on map:{0} | CurrentMap |
| | en | | Playing on map:{0} |
| | en-US | | Playing on map:{0} |
| | en-GB | | Playing on map:{0} |
| | de-DE | | Auf der Karte spielen:{0} |
| | Outras localidades | | |
| totalKicked | Default | Kicked {0} Buckets! | BucketsKicked |
| | en | | Kicked {0} Buckets! |
| | en-US | | Kicked {0} Buckets! |
| | en-GB | | Kicked {0} Buckets! |
| | de-DE | | {0} getretenen Eimer! |
| | Outras localidades | | |
| multiplayer | Default | Playing multiplayer | |
| | en | | Playing multiplayer |
| | en-US | | Playing multiplayer |
| | en-GB | | Playing multiplayer |
| | de-DE | | Mehrspieler spielen |
| | Outras localidades | | |

Não há limite para a quantidade de cadeias de caracteres que você pode criar, mas é necessário ter pelo menos uma cadeia para o seu jogo.

`BucketsKicked` é apenas um número que é substituído na sua cadeia de caracteres.
`CurrentMap` é um exemplo de estatística em que a cadeia de caracteres vem da enumeração.
Quando o seu jogo definir o Rich Presence como uma dessas cadeias, use a configuração para saber quais parâmetros são necessários.


## Related topics

- [Configurando cadeias de caracteres de Rich Presence no Partner Center](/pt-BR/services/xbox-services/community/presence/config/live-presence-config2.md)
- [Configuração do Rich Presence no portal](/pt-BR/services/xbox-services/community/presence/config/live-presence-config-nav.md)
- [Visão geral da configuração do portal](/pt-BR/services/xbox-services/fundamentals/portal-config/live-portal-config-overview.md)
- [Políticas e limites das cadeias de caracteres de Rich Presence](/pt-BR/services/xbox-services/community/presence/concepts/live-presence-limits.md)
- [Práticas recomendadas para Rich Presence](/pt-BR/services/xbox-services/community/presence/concepts/live-presence-best-practices.md)