Pular para o conteúdo principal
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 para representar isso.
    • Outros jogadores no título e nos serviços do XBOX podem recuperar essa atividade. 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 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 com as informações atualizadas.
  4. O título deve atualizar a lista de jogadores recentes do jogador 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.

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

Confira também

Atividades Convites Jogadores recentes
Última modificação em 20 de outubro de 2026