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

> Solucione problemas da interface do usuário de entrada por convite e atividade do MPSD desabilitada verificando o estado da sessão, a área restrita e os IDs de título, o MicrosoftGame.config e a configuração do modelo.

O guia a seguir é um ponto de partida para ajudar os títulos a solucionar problemas da funcionalidade de convites e atividades usando o MPSD.

Os desenvolvedores de títulos que usam essa funcionalidade do MPSD e encontram problemas devem primeiro garantir que a sessão do MPSD usada seja válida e que não haja outros erros de API nas chamadas ao MPSD 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 sessão do MPSD não está fechada, bloqueada ou cheia.
   Os convites e as entradas são desabilitados para sessões fechadas (`"closed": true`) ou cheias. Sessões do MPSD bloqueadas (`"locked": true`) só permitem que membros anteriores da sessão voltem a ingressar.

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

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

4. Verifique se a configuração correta da sessão do MPSD está em vigor para o seu cenário.

   * A constante inviteProtocol está definida na sessão do MPSD. Os títulos devem definir a constante `"inviteProtocol": "game"` para que o comportamento dos convites seja correto.

   * A sessão do MPSD não inclui nenhuma restrição de entrada. Verifique se a propriedade joinRestriction não está definida como followed/local, o que impediria a entrada de não seguidores ou restringiria totalmente as entradas.

   * A propriedade userAuthorizationStyle da sessão do MPSD está definida corretamente. A propriedade userAuthorizationStyle deve estar habilitada para sessões do MPSD em dispositivos que não são consoles e também exige uma joinRestriction ('local' ou 'followed'). Essa é uma limitação do sistema para impedir entradas de jogadores arbitrários e não pode ser removida.

   A configuração de modelo do MPSD recomendada é:

```json theme={null}
     /Constants/System/Capabilities:
         "inviteProtocol" : "game"
         "userAuthorizationStyle": true   (required for non-console devices)
     /Properties/System:
         "joinRestriction" : "none"   (console only) - "followed" (non-console devices) will allow Joins as well as invites. - "local" invite only, no joins allowed.
```

5. Verifique se os problemas de convite/entrada não estão restritos a cenários entre dispositivos.
   Se os problemas de convite/entrada ocorrerem apenas entre tipos de console diferentes (XBOX Series X|S, XBOX One) ou entre console/PC, a configuração de crossPlay do título ou da sessão do MPSD pode estar incorreta. 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.

   * Verifique se todas as plataformas relevantes estão habilitadas na lista 'XBOX Settings'/'Device families' do Partner Center depois que seu título for lançado em plataformas adicionais além do XBOX One.

   * Verifique se a capacidade de sessão do MPSD de crossplay está habilitada (`"crossPlay": true`).

   A configuração de modelo do MPSD recomendada é:

```json theme={null}
     /Constants/System/Capabilities:
         "crossPlay" : "true"   if you want to support crossPlay between supported deviceTypes (Xbox One as the only device in Partner Center default supports Xbox Series X|S)
```

6. Verifique se o comportamento de propriedade da sessão não está causando uma restrição de convites.
   Uma sessão que tem hasOwners e um proprietário de sessão definidos também precisa definir allowNonOwnerInviteHandles como true para que não proprietários possam enviar convites. Defina essa constante de acordo com o comportamento desejado.

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

8. 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. Garanta que ambos os consoles/usuários façam parte do grupo de Private Audience, se isso estiver habilitado.

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

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


## Related topics

- [Guia de solução de problemas de convites e atividades do MPA](/pt-BR/services/xbox-services/multiplayer/mpa/concepts/live-mpa-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)