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

# Visão geral do recurso Multiplayer Activity

> Visão geral de como o Multiplayer Activity simplifica a integração com o XBOX para atividades, convites e jogadores recentes, e permite entradas a partir do grafo social de um jogador.

Este tópico descreve como o recurso Multiplayer Activity (MPA) simplifica a integração com os serviços do XBOX para
atividades de jogadores (entradas), convites e jogadores recentes. O MPA também permite
que os jogadores iniciem seu jogo a partir do grafo social, mesmo que o título
em si não esteja em execução.

## Terminologia

Os quatro termos a seguir são usados com frequência no contexto do MPA.

* **Cadeia de conexão:** uma cadeia de caracteres criada e compreendida apenas pelo título,
  que contém as informações necessárias para que um jogador se conecte a outro.
  Ela geralmente contém o endereço IP de um servidor, mas tem formato livre para dar flexibilidade
  aos títulos. Essa cadeia de caracteres é opaca para o MPA, que simplesmente a repassa de um jogador
  para outro para permitir que os jogadores ingressem uns nos jogos dos outros.

* **Atividade:** representa um anúncio de que o jogador está em uma experiência
  multiplayer. Ela contém uma cadeia de conexão e um pequeno conjunto de
  propriedades para restringir quem pode ingressar na experiência. As atividades permitem que o
  shell exiba essas informações, incluindo a possibilidade de entrada. Uma atividade
  deve sempre estar presente quando um jogador estiver em uma experiência multiplayer.

* **Convite:** representa uma solicitação para que um jogador ingresse em uma experiência
  multiplayer. Ele também contém uma cadeia de conexão. Em geral, um jogador
  deve ter criado uma atividade antes de enviar convites para outros jogadores.

* **Jogador recente:** alguém que teve uma interação significativa com um
  jogador. Os jogadores recentes são armazenados pelo MPA em uma lista. Um jogador pode usá-los
  para formar relações de amizade, enviar mensagens e convites ou relatar comentários
  depois de jogar uma partida.

## Usando o MPA

### Fluxo do cliente

Um título deve ter o fluxo a seguir para tratar experiências multiplayer.

1. Quando o jogador A inicia ou ingressa em uma experiência multiplayer, o título deve [definir uma
   atividade](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md#setting-an-activity) para representar
   isso.
   * Outros jogadores no título e nos serviços do XBOX podem [recuperar essa
     atividade](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md#getting-an-activity). Dependendo
     da relação deles com o jogador A, a atividade que recebem também pode
     incluir uma cadeia de conexão. Eles podem usá-la para ingressar no jogo em
     andamento.
2. O jogador A pode enviar [Convites](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md#invites)
   para outros jogadores, solicitando ativamente que ingressem no jogo.
3. À medida que os jogadores entram e saem, o título deve atualizar o número de jogadores na
   atividade [definindo-a
   novamente](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md#setting-an-activity) com as informações
   atualizadas.
4. O título deve [atualizar a lista de jogadores recentes
   do jogador](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md#updating-recent-players) com todos os
   jogadores com quem ele teve interações significativas.
5. Quando o jogador A encerra ou sai da experiência multiplayer, o título deve [excluir a
   atividade](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md#deleting-an-activity).

### Fluxo do servidor externo

Um servidor pode agir em nome dos clientes em qualquer um dos itens mencionados anteriormente. Além disso, um
servidor pode:

* Registrar [listas
  bidirecionais](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpa/concepts/live-mpa-recent-players.md#Unidirectional-players-vs-Bidirectional-groups)
  de jogadores recentes.
* Enviar um convite em nome de um jogador.
* Recuperar atividades de vários jogadores ao mesmo tempo, em vez de um de cada vez.

Para obter mais informações, consulte a [referência RESTful dos serviços do XBOX](https://docs.xbox.com/pt-BR/reference/live/rest/atoc-xboxlivews-reference.md).

## Confira também

[Atividades](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpa/concepts/live-mpa-activities.md)

[Convites](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpa/concepts/live-mpa-invites.md)

[Jogadores recentes](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpa/concepts/live-mpa-recent-players.md)


## Related topics

- [Visão geral do multijogador dos serviços XBOX](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/overviews/live-multiplayer-intro.md)
- [Multiplayer Activity (MPA)](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpa/live-mpa-nav.md)
- [Convites entre versões de título do Xbox One Software Development Kit/GDK](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/invites/concepts/live-multiplayer-xdkinvites.md)
- [Visão geral do Multiplayer Manager](https://docs.xbox.com/pt-BR/services/xbox-services/multiplayer/mpm/live-multiplayer-manager-overview.md)
- [Visão geral do serviço Real-Time Activity](https://docs.xbox.com/pt-BR/services/xbox-services/fundamentals/rta/live-real-time-activity-service-overview.md)