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

# Atividades

> Divulgue experiências multiplayer nas quais outros jogadores do XBOX podem ingressar com o Multiplayer Activity, incluindo campos de atividade, restrições de entrada e contagens de jogadores.

Este tópico descreve como divulgar experiências multiplayer nas quais outros jogadores podem ingressar. Em seguida, eles podem ingressar nessas experiências.

## Usando atividades

Quando um jogador inicia ou ingressa em uma experiência multiplayer, o título deve divulgar
isso no Multiplayer Activity (MPA) criando uma atividade. Ao contrário de um
modelo baseado em sessões, as atividades são por jogador. Cada jogador deve criar sua
própria atividade, mesmo que estejam jogando juntos.

O título deve criar essa atividade assim que o jogador estiver em uma experiência
multiplayer. Durante a experiência, o título deve modificar a atividade se a contagem de
jogadores aumentar ou diminuir. O título deve excluir a atividade se o jogador
encerrar ou sair da experiência multiplayer. Se um título falhar ou, por algum outro motivo,
não remover uma atividade, o MPA tentará remover a atividade se
detectar que o jogador parou de jogar o título. As atividades são removidas automaticamente
após 24 horas se não tiverem sido atualizadas.

## Conteúdo das atividades

As atividades contêm as informações mostradas na tabela a seguir.

| Campo | Finalidade | Observações |
| - | - | - |
| `xuid` | O `XboxUserId` do usuário que criou a atividade. | Usado somente ao consultar atividades. Os jogadores só podem definir atividades para si mesmos. |
| `connectionString` | Uma cadeia de caracteres definida pelo título que é opaca para o MPA. Contém informações que um título pode usar para se conectar a outro jogador. | Deve ter menos de 512 caracteres. |
| `joinRestriction` | Representa quem pode ver a cadeia de conexão nesta atividade. Para obter mais detalhes, consulte a seção Privacidade mais adiante neste tópico. | Deve ser `Public`, `Followed`, `InviteOnly`. |
| `maxPlayers` | O número máximo de jogadores permitidos nesta atividade. | Opcional. Se especificado, deve ser maior que 1 e menor ou igual a 100. |
| `currentPlayers` | O número atual de jogadores nesta atividade. | Opcional. Se especificado, deve ser maior que 0 e menor ou igual a 100. |
| `groupId` | Um ID definido pelo título. Jogadores com o mesmo `groupId` são reconhecidos no MPA como jogando juntos. | Deve ter menos de 128 caracteres e ser usado somente para identificação de grupo. |
| `platform` | Quando definido como uma plataforma específica, limita o crossplay por meio de convites e entradas somente a essa plataforma. Se não estiver definido, o crossplay é habilitado com todas as plataformas definidas. | Para obter mais informações, consulte a seção Suporte a atividades de crossplay mais adiante neste tópico. |

## Privacidade

Um título pode querer permitir que apenas um subconjunto dos jogadores do seu grafo social ingresse
com o jogador. O campo `joinRestriction` determina se outros jogadores recebem
a cadeia de conexão ao visualizar essa atividade. Os valores e seus significados são mostrados na tabela a seguir.

| Valor | Significado |
| - | - |
| `Public` | Todos os jogadores podem ingressar nesta atividade. |
| `Followed` | Se o criador da atividade seguir outro jogador, esse jogador poderá ingressar. |
| `InviteOnly` | Nenhum jogador pode ingressar nesta atividade, a menos que esteja respondendo a um convite. |

## Suporte a atividades de crossplay

Ao criar uma atividade no Microsoft Game Development Kit (GDK), os títulos podem especificar um sinalizador `allowCrossplay`.
Se for `false`, o Microsoft Game Development Kit (GDK) preencherá automaticamente o campo de plataforma de um convite com a
plataforma atual. Se for `true`, o Microsoft Game Development Kit (GDK) deixará o campo de plataforma como `null`, indicando que
o convite é multiplataforma. A lista de plataformas permitidas por meio do crossplay é definida pela configuração
do título. As gerações de consoles são consideradas crossplay nesse cenário.

## Recuperando atividades

Ao recuperar atividades de outros jogadores, às vezes a cadeia de conexão fica
oculta. Isso indica que o jogador não tem permissão para ingressar nessa atividade. Por
exemplo, a cadeia de conexão pode estar oculta devido à
`joinRestriction` da atividade, ou a atividade está cheia.


## Related topics

- [URIs de atividade multijogador](https://docs.xbox.com/pt-BR/reference/live/rest/uri/multiplayeractivity/atoc-reference-multiplayer-activity.md)
- [Relatar atividade de anúncios](https://docs.xbox.com/pt-BR/services/playfab/api-references/rest/client/advertising/report-ad-activity.md)
- [Recompensar atividade de anúncios](https://docs.xbox.com/pt-BR/services/playfab/api-references/rest/client/advertising/reward-ad-activity.md)
- [Solução de problemas de convites e atividades do MPSD](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-invite-troubleshooting.md)
- [Integração com PlayFab Lobby e Match](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpa/concepts/live-mpa-playfab-integration.md)