Azure PlayFab Party
Use este tópico para entender como usar o PlayFab Party com o Microsoft Game Development Kit (GDK). O PlayFab Party simplifica a adição de chat de baixa latência e comunicação de dados ao seu jogo de forma flexível, inclusiva e segura. O Party é ideal para implementações multijogador quando não se deseja um servidor dedicado hospedado na nuvem (às vezes chamados de jogos ponto a ponto ou jogos P2P). O Party alimenta comunicações de voz e texto para experiências sociais dentro do seu aplicativo (por exemplo, esquadrões no jogo ou lobbies pós-jogo), mesmo que você esteja usando um servidor na nuvem como host do jogo. O Party é o sucessor no Microsoft Game Development Kit (GDK) da API Secure Sockets do ERA do XBOX One. O Party usa os Serviços Cognitivos do Azure para transcrever o chat de voz do usuário e sintetizar texto como fala, o que foi projetado principalmente como um auxílio de acessibilidade. O uso típico do chat de voz do PlayFab Party é cobrado por minuto. Até 10 por cento desses minutos de voz podem usar transcrição e síntese gratuitamente. Recomendamos vincular a ativação desse recurso a uma configuração de facilidade de acesso do usuário.[!NOTE] O Party também traduz o chat em tempo real. Em matchmaking anônimo e em jogos competitivos internacionais, esses recursos de transcrição e tradução proporcionam uma experiência multijogador mais envolvente.Um objetivo fundamental do PlayFab Party (e dos nossos outros serviços multijogador) é facilitar uma infraestrutura multijogador interoperável e a jogabilidade entre redes. Verifique se suas experiências multijogador estão em conformidade com as políticas de plataforma relevantes para multijogador e atividades de usuários entre redes.
Recursos do PlayFab Party
- Criptografia e autenticação: o Party autentica os dispositivos dos usuários usando a identidade de usuário do PlayFab e criptografa os dados com um protocolo semelhante ao DTLS.
- Rede de datagramas de dispositivo para dispositivo: no núcleo do Party estão as retransmissões hospedadas globalmente na nuvem do Azure. Os dispositivos dos usuários usam essas retransmissões para criar redes do Party e enviar dados de jogo uns aos outros. O sistema de rede do Party inclui recursos de transporte configuráveis, como novas tentativas automáticas ao encontrar perda de pacotes.
- Chat de voz e texto: os dispositivos dos usuários podem associar dispositivos de áudio a redes do Party para chat de voz em tempo real. O Party também dá suporte a mensagens de chat de texto entre usuários.
- Conversão de fala em texto e síntese de voz: o Party pode transcrever o chat de voz do usuário e sintetizar falas para mensagens de texto. Essa funcionalidade tem vários usos, mas foi projetada principalmente como um auxílio de acessibilidade.
- Tradução em tempo real: o Party pode entender e sintetizar traduções em tempo real do chat de voz e texto do usuário.
Considerações sobre o Microsoft Game Development Kit (GDK)
Requisitos do XBOX services
A comunicação entre usuários em títulos do XBOX services deve atender a vários requisitos de segurança do usuário. Usar o PlayFab Party com o plug-in do XBOX services do PlayFab Party garante que seu título atenda a todos os requisitos de comunicação e segurança do XBOX services.[!NOTE] Um XBOX Requirement (XR) é um requisito que um jogo deve atender antes de poder ser publicado nas plataformas XBOX.
- XR-015: Gerenciamento da comunicação entre jogadores.
- XR-045: XBOX services e privilégios da conta. O plug-in do XBOX services impõe apenas a parte XPRIVILEGE_COMMUNICATIONS. Se o seu título usar outros recursos do XBOX services, você precisará executar as verificações de privilégio necessárias.
- XR-072: Suporte a voz.
- Jogo entre redes: o PlayFab Party impõe apenas a parte de jogabilidade entre redes que requer um servidor. Seu título é responsável pelas verificações de privilégio necessárias e pela interação com o XBOX services.
- XR-064: Sessões de jogo em que é possível ingressar e jogo online
- XR-067: Manutenção das interações de Jogados recentemente
Inicialização da rede
O PlayFab Party não lida automaticamente com a inicialização da rede para títulos do Microsoft Game Development Kit (GDK). Aguarde a inicialização da rede antes de chamar o PlayFab Party. As APIs do Party falham até que a rede seja inicializada.Suspensão e retomada
Você deve se registrar para receber eventos de suspensão e retomada por meio deRegisterAppStateChangeNotification. Na suspensão, limpe o Party com PartyManager::Cleanup(). Na retomada, você deve aguardar novamente a inicialização da rede antes de chamar PartyManager::Initialize(). As APIs do Party falharão se você tentar usá-las ao longo de um ciclo de suspensão/retomada.
Pode levar algumas centenas de milissegundos para que PartyManager::Cleanup() seja concluído. Recomendamos limpar o Party em paralelo com suas outras operações de suspensão para evitar tempos limite de suspensão. Ao chamar Partymanager::Cleanup() de forma assíncrona, você deve bloquear a notificação de suspensão até que a limpeza do Party retorne.
Informações sobre preços
O PlayFab Party é gratuito para o Microsoft Game Development Kit (GDK) usando identidades do XBOX services. Para obter mais informações sobre preços e cobrança, confira Perguntas frequentes sobre o programa gratuito do XBOX services.Configuração do seu título no portal do PlayFab
- Acesse https://developer.playfab.com/ e crie uma conta.
- Crie um estúdio do PlayFab e uma ID de título usando sua nova conta.
- Acesse o título recém-criado, selecione a seção Multiplayer e, em seguida, selecione a guia Party (Preview).
- Selecione Enable e insira o código de acesso XBOX Live. O Party é habilitado após alguns instantes.
- Na guia API Features, copie a ID de título do PlayFab e o ICD da entidade.
- Adicione a ID de título e o ICD da entidade à função de inicialização da API do PlayFab Party no cliente. Agora você pode usar o PlayFab Party no seu título do Microsoft Game Development Kit (GDK).
Adição da biblioteca do PlayFab Party ao seu projeto do Microsoft Game Development Kit (GDK) usando o Visual Studio
- Clique com o botão direito do mouse no projeto no Gerenciador de Soluções do Visual Studio e selecione Properties.
- Em Configuration Properties, acesse a seção XBOX One.
- Selecione a lista suspensa Gaming Extension Libraries e adicione uma referência ao PlayFab Party e ao XBOX Live Helper.
[!NOTE] As bibliotecas são instaladas em um local padrão em Program Files (x86)\Microsoft GDK[Version]\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\Redist\x64 (outubro de 2024 ou posterior) -ou- Program Files (x86)\Microsoft GDK[Version]\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\Redist\CommonConfiguration\neutral (junho de 2024 ou anterior).