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

# Guia de solução de problemas de convites e atividades do MPA

> Solucione problemas de convites e atividades do Multiplayer Activity do XBOX verificando restrições de entrada, sinalizadores de crossplay, área restrita, ID do título e a configuração do Partner Center.

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](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Overview) 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.


## Related topics

- [Guia de solução de problemas de convites e atividades do MPSD](/pt-BR/services/xbox-services/multiplayer/mpsd/concepts/live-multiplayer-invite-troubleshooting.md)
- [Perguntas frequentes e guia de solução de problemas do XBOX PC Remote Tools](/pt-BR/tools/tools-pc/xbox-pc-remote-tools/faq.md)
- [Solução de problemas de desenvolvimento do XStore](/pt-BR/publishing/xstore-commerce/xstore-troubleshooting.md)
- [Solução de problemas de entrada e de área restrita](/pt-BR/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)
- [Solução de problemas do chat de voz](/pt-BR/services/playfab/community/voice-communications/concepts-audio-troubleshooting.md)