Biblioteca PlayFab Party XBOX Live Helper
Junto com a biblioteca principal do PlayFab Party, oferecemos uma biblioteca XBOX Live Helper projetada para ajudar a cumprir as políticas do XBOX Live e, por extensão, os XRs. O uso dessa biblioteca auxiliar não é obrigatório, mas é altamente recomendado e considerado uma prática recomendada. Os exemplos apresentados aqui pressupõem o uso da biblioteca XBOX Live Helper.Alinhando o PlayFab Party com as configurações e os privilégios de chat de um usuário do XBOX Live
O PlayFab Party usa um modelo de comunicação por chat baseado em aceitação e, por padrão, restringe todas as comunicações entre dois controles de chat ao conjunto de comunicações que ambos os participantes habilitaram. Para obter mais informações, consulte a documentação sobre permissões de chat e silenciamento. A biblioteca XBOX Live Helper do PlayFab Party indica qual conjunto de permissões de chat deve ser habilitado para corresponder às preferências e aos privilégios dos usuários do XBOX Live que estão se comunicando na sessão do Party. Para obter mais informações, consulte a documentação sobre como respeitar as configurações de privacidade e as permissões de um usuário do XBOX Live. Ao usar corretamente o PlayFab Party e a biblioteca XBOX Live Helper, seu jogo pode atender integralmente aos requisitos especificados pelo XR-015 e aos requisitos de comunicação relevantes especificados pelo XR-045. Consulte a documentação técnica do XR-045 para conhecer outros requisitos fora do escopo do PlayFab Party.Mantendo um documento de sessão multijogador
O PlayFab Party não fornece nenhum tipo de lista de usuários do XBOX. Ele depende de o seu jogo usar o serviço Multiplayer Session Directory (MPSD) para manter uma lista de participantes e associar a atividade da rede do Party aos usuários na sessão de jogo. O PlayFab Party anunciará pontos de extremidade e controles de chat remotos à medida que eles entram e saem das redes do Party. As IDs de entidade do PlayFab associadas a esses objetos devem ser correlacionadas com os usuários do XBOX no documento do MPSD para reconhecer quais objetos do PlayFab Party representam usuários do XBOX na sessão de jogo. Em cenários de jogo entre plataformas, uma entidade do PlayFab não associada a um usuário do XBOX pode representar um usuário em outro ecossistema multijogador. Para reconhecer os usuários do XBOX, você deve criar mapeamentos entre IDs de entidade do PlayFab e usuários do XBOX Live. Para isso, é recomendável armazenar a lista de usuários do XBOX Live da sessão em um documento do MPSD e converter esses usuários do XBOX Live em IDs de entidade do PlayFab usando a biblioteca XBOX Live Helper. Para obter exemplos, consulte Mapeamento entre IDs de usuário do XBOX Live e IDs de entidade do PlayFab. Além de fornecer a lista de participantes da rede do Party, os documentos do MPSD também impulsionam muitas experiências multijogador no ecossistema multijogador do XBOX, como matchmaking, convites da plataforma, listas de jogadores recentes e ingresso em andamento. Para obter mais informações sobre como incorporar redes do Party a esses fluxos do MPSD, consulte Usando o PlayFab Party com o MPSD. Para obter mais informações, consulte Visão geral do MPSD.Usando clientes XBOX em redes do Party com jogo entre plataformas
Em cenários de jogo entre plataformas, tenha em mente as seguintes práticas recomendadas ao interagir com o ecossistema do XBOX Live.Esta seção fornece práticas recomendadas para usar o PlayFab Party em cenários de jogo entre plataformas com o XBOX Live, mas o uso do PlayFab Party não atende implicitamente aos requisitos de jogo entre plataformas do XR-007. Consulte a documentação técnica do XR-007 para obter informações sobre como atender a esses requisitos.
Identificando jogadores em uma sessão de jogo entre redes
Jogadores únicos devem ser identificáveis e distinguíveis entre ecossistemas multijogador. Para isso, o PlayFab Party fornece IDs de entidade do PlayFab nos vários objetos que podem estar associados a usuários na sua sessão:PartyLocalUser, PartyEndpoint, PartyChatControl.
Nomes de exibição entre redes não são fornecidos pela API do PlayFab Party. Ao exibir usuários do XBOX na interface do usuário, você deve usar o gamertag deles, e o gamertag deve ser resolvido a partir da ID de usuário do XBOX no documento do MPSD. Usuários que não são do XBOX devem ser apresentados na interface do usuário com base nas diretrizes do XR-007. Na ausência de um nome de exibição fornecido pela plataforma, o PlayFab oferece suporte a nomes de exibição por meio de GetPlayerProfile. Ao ingressar em uma rede, um jogador deve publicar seu nome de exibição em um documento de sessão compartilhado para que outros jogadores o vejam.
Embora a biblioteca do PlayFab Party associe alguns de seus objetos a usuários do PlayFab (por meio de IDs de entidade do PlayFab), a biblioteca não fornece funcionalidade para identificar a quais ecossistemas multijogador um usuário do PlayFab pode estar associado. Para distinguir usuários do PlayFab do XBOX Live de usuários de outros ecossistemas multijogador, é recomendável fazer a referência cruzada das IDs de entidade do PlayFab em uma rede do Party com o MPSD. Para obter mais informações sobre como distinguir jogadores do XBOX Live de jogadores que não são do XBOX Live por meio do MPSD, consulte a seção Mantendo um documento de sessão multijogador.
Para obter mais informações sobre os requisitos relacionados à identificação de usuários em redes de jogo entre plataformas com o XBOX Live, consulte o XR-007.
Respeitando as permissões de comunicação entre redes para usuários do XBOX Live
O PlayFab Party não cumpre implicitamente as restrições de comunicação entre redes do XBOX Live. Portanto, a biblioteca PlayFab Party XBOX Live Helper fornece funcionalidade para consultar as permissões de comunicação entre redes de um usuário do XBOX Live. Você deve usar essas informações para cumprir os requisitos de comunicação entre redes especificados no XR-007. Consulte Respeitando as comunicações entre redes para obter mais informações.Usar convites do PlayFab Party para restringir o acesso às redes quando o jogo entre plataformas não for permitido.
Os usuários do XBOX Live precisam de privilégios entre redes para interagir com usuários que não são do XBOX Live em sessões de jogo entre redes. O PlayFab Party não cumpre implicitamente essas restrições entre redes (descritas no XR-007); portanto, esse privilégio deve ser consultado fora da biblioteca do PlayFab Party. Quando esses privilégios não forem concedidos, você deverá restringir a rede do Party para permitir apenas os usuários do XBOX Live conhecidos no documento do MPSD da sessão de jogo. Você pode fazer isso ampliando nosso fluxo de ingresso em andamento de exemplo para usar convites do Party que permitam que apenas usuários do XBOX conhecidos ingressem na rede. Primeiro, garanta que a rede do Party seja criada com um convite restrito.Como você precisará converter entre IDs de usuário do XBOX Live e IDs de entidade do PlayFab, é recomendável criar um mapeamento entre as duas. Consulte Mapeamento entre IDs de usuário do XBOX Live e IDs de entidade do PlayFab para obter exemplos de como fazer isso.
Mantendo a sincronização com as configurações de perfil do XBOX Live
O PlayFab Party, por padrão, cumpre os requisitos de configurações de perfil do XR-048. A biblioteca não mantém um cache persistente de nenhuma configuração de perfil do XBOX Live. Quando as configurações de perfil são necessárias para uso do PlayFab Party, elas são consultadas no XBOX Live e permanecem válidas durante o tempo de vida do objeto de API do PlayFab Party associado à configuração, mas não persistem entre várias instâncias do objeto. Para obter informações sobre como usar dados de configurações de perfil do XBOX Live fora do PlayFab Party, consulte a documentação técnica do XR-048.Dando suporte aos fluxos de ingresso multijogador da plataforma
No XBOX, os jogadores podem ingressar em jogos multijogador por meio dos recursos de ingresso em andamento e de convite da plataforma. O PlayFab Party não se integra diretamente a esses recursos da plataforma, mas dá suporte ao uso deles por meio dos objetosPartyNetworkDescriptor e PartyInvitation. Os objetos PartyNetworkDescriptor fornecem as informações de conexão necessárias para que um usuário remoto encontre a rede do Party e se conecte a ela, e podem ser serializados por meio de PartyManager::SerializeNetworkDescriptor. Os objetos PartyInvitation fornecem aos usuários remotos uma ID usada para se autenticar e ingressar em uma rede do Party. Para permitir que usuários remotos ingressem em jogos multijogador por meio de ingresso em andamento e de convites da plataforma, integre o descritor de rede serializado e o identificador do convite do Party aos seus fluxos existentes. Fluxos de exemplo também podem ser encontrados no documento Usando o PlayFab Party com o MPSD.
Para obter mais informações sobre os requisitos dos fluxos de ingresso multijogador da plataforma, consulte a documentação técnica do XR-064 e do XR-124.
Listas de amigos
Embora o PlayFab Party não interaja nativamente com listas de amigos em nenhuma plataforma, os jogos multijogador ainda podem precisar considerar as listas de amigos em diferentes cenários. Para obter informações sobre requisitos e orientações ao interagir com listas de amigos do XBOX Live e entre redes, consulte a seguinte documentação:- Requisitos de lista de amigos do XBOX Live (XR-070)
- Requisitos de lista de amigos entre redes (XR-007)
- XBOX Social Manager
- XBOX Live Services API (XSAPI)
