Pular para o conteúdo principal
O guia a seguir é um ponto de partida para ajudar os títulos a solucionar problemas da funcionalidade de convites e atividades usando o serviço MPA. Os desenvolvedores de títulos devem primeiro garantir que não haja erros nas chamadas de API do MPA nem erros HTTP. Sem erros, a interface do usuário de entrada por convite/atividade desabilitada geralmente é causada por uma configuração incorreta do título ou do serviço. A melhor abordagem de solução de problemas é seguir estas etapas:
  1. Verifique se a atividade atual não tem uma JoinRestriction limitante; valores definidos como Followed ou InviteOnly limitam a possibilidade de entrada.
  2. Verifique se a propriedade platform da atividade ou o sinalizador de convite allowCrossPlatformJoin não restringe o crossplay. Definir um valor específico de platform (por exemplo, XboxOne) limita as entradas pela interface do usuário da plataforma e os convites da atividade a essa plataforma. Definir o sinalizador de convite allowCrossPlatformJoin como false preenche automaticamente o campo de plataforma com a plataforma atual. O convite só é recebido por jogadores nessa plataforma.
  3. Verifique a área restrita e o titleID de todas as instâncias do título no teste. Todas as instâncias do título precisam estar em áreas restritas idênticas, usar o mesmo titleID (e SCID), e o modelo de sessão do MPSD precisa estar configurado nessa área restrita.
  4. Verifique se todos os IDs no arquivo MicrosoftGame.config estão definidos corretamente. O MicrosoftGame.config deve incluir o titleID, o SCID e as informações de identidade corretos, correspondentes à configuração do Partner Center (visível em ‘Game Setup’) do seu título.
  5. Verifique a disponibilidade de dispositivos do seu título no Partner Center. As configurações ‘Game Setup’/‘Device family availability’ no Partner Center podem restringir a funcionalidade e a disponibilidade do seu título. Garanta que todas as plataformas relevantes estejam habilitadas. Por padrão, os dispositivos XBOX One oferecerão suporte a crossplay se a família de dispositivos XBOX Series X|S não estiver definida.
  6. Verifique se o seu título não está limitado a grupos de Private Audience. Restringir a visibilidade do título a Private Audiences (‘Pricing and availability’/‘Visibility’ no Partner Center) pode restringir o acesso ao título e a funcionalidade dos serviços. Por exemplo, se o usuário conectado não fizer parte da Private Audience, as informações de jogadores recentes retornadas não incluirão um nome de título adequado. Garanta que ambos os consoles/usuários façam parte do grupo de Private Audience, se isso estiver habilitado.
  7. Verifique se a configuração MultiplayerProtocol está presente no arquivo MicrosoftGame.config para títulos de PC. A configuração MultiplayerProtocol deve ser definida como true para que os títulos do Windows habilitem a integração correta com a interface do usuário da XBOX Game Bar. Consulte a visão geral do MicrosoftGame.config para obter mais detalhes.
  8. Verifique se você não está misturando acidentalmente chamadas dos serviços MPA e MPSD. Os serviços MPSD e MPA não podem ser usados ao mesmo tempo. Fazer isso resultará em comportamento inesperado de Atividade/Entrada/Convite. Os títulos devem escolher apenas um serviço.
  9. A interface do usuário da plataforma não desabilitará atividades que estejam cheias (currentPlayers igual a maxPlayers). Isso serve principalmente para evitar condições de corrida, mas também porque currentPlayers é um campo opcional. Se você quiser limitar a possibilidade de entrada quando a atividade estiver cheia, precisará excluir a atividade ou tratar o caso de erro quando um jogador ingressar e ela estiver cheia. Recomenda-se exibir mensagens de erro, pois esse caso já precisa ser tratado pelo jogo.
Última modificação em 8 de outubro de 2026