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 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 é:
  1. 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 é:
  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
Última modificação em 8 de outubro de 2026