Azure PlayFab Party
Use este tema para comprender cómo usar PlayFab Party con Microsoft Game Development Kit (GDK). PlayFab Party simplifica la incorporación de chat de baja latencia y comunicación de datos a su juego de una manera flexible, inclusiva y segura. Party es ideal para implementaciones multijugador cuando no se desea un servidor dedicado hospedado en la nube (a veces denominados juegos punto a punto o juegos P2P). Party impulsa las comunicaciones de voz y texto para experiencias sociales dentro de su aplicación (por ejemplo, escuadrones en el juego o lobbies posteriores a la partida), incluso si usa un servidor en la nube como host del juego. Party es el sucesor en Microsoft Game Development Kit (GDK) de la API ERA Secure Sockets de XBOX One. Party usa Azure Cognitive Services para transcribir el chat de voz de los usuarios y sintetizar texto como voz, una funcionalidad diseñada principalmente como ayuda de accesibilidad. El uso típico del chat de voz de PlayFab Party se factura por minuto. Hasta el 10 por ciento de esos minutos de voz pueden usar la transcripción y la síntesis de forma gratuita. Recomendamos vincular la activación de esta funcionalidad a una configuración de accesibilidad del usuario.[!NOTE] Party también traduce el chat en tiempo real. En el emparejamiento anónimo y en los juegos competitivos internacionales, estas funcionalidades de transcripción y traducción ofrecen una experiencia multijugador más atractiva.Un objetivo clave de PlayFab Party (y de nuestros otros servicios multijugador) es admitir una infraestructura multijugador interoperable y el juego entre redes. Compruebe que sus experiencias multijugador cumplan con las directivas de plataforma pertinentes para la actividad multijugador y entre redes de los usuarios.
Características de PlayFab Party
- Cifrado y autenticación: Party autentica los dispositivos de los usuarios mediante su identidad de usuario de PlayFab y cifra los datos con un protocolo similar a DTLS.
- Redes de datagramas de dispositivo a dispositivo: El núcleo de Party son los retransmisores hospedados globalmente en la nube de Azure. Los dispositivos de los usuarios usan estos retransmisores para crear redes de Party y enviarse datos de juego entre sí. El sistema de redes de Party incluye características de transporte configurables, como reintentos automáticos cuando se produce pérdida de paquetes.
- Chat de voz y texto: Los dispositivos de los usuarios pueden enlazar dispositivos de audio a redes de Party para el chat de voz en tiempo real. Party también admite mensajes de chat de texto entre usuarios.
- Conversión de voz a texto y síntesis de voz: Party puede transcribir el chat de voz de los usuarios y sintetizar enunciados para mensajes de texto. Esta funcionalidad tiene varios usos, pero se diseñó principalmente como ayuda de accesibilidad.
- Traducción en tiempo real: Party puede comprender y sintetizar traducciones en tiempo real del chat de voz y texto de los usuarios.
Consideraciones de Microsoft Game Development Kit (GDK)
Requisitos de XBOX services
La comunicación entre usuarios en los títulos de XBOX services debe cumplir varios requisitos de seguridad de los usuarios. El uso de PlayFab Party con el complemento de XBOX services de PlayFab Party garantiza que su título cumpla todos los requisitos de comunicación y seguridad de XBOX services.[!NOTE] Un requisito de XBOX (XR) es un requisito que un juego debe cumplir antes de poder publicarse en plataformas XBOX.
- XR-015: Administración de la comunicación entre jugadores.
- XR-045: XBOX services y privilegios de cuenta. El complemento de XBOX services solo aplica la parte de XPRIVILEGE_COMMUNICATIONS. Si su título usa otras características de XBOX services, debe realizar las comprobaciones de privilegios necesarias.
- XR-072: Compatibilidad con voz.
- Juego entre redes: PlayFab Party solo aplica la parte de juego entre redes que requiere un servidor. Su título es responsable de las comprobaciones de privilegios necesarias y de la interacción con XBOX services.
- XR-064: Sesiones de juego a las que es posible unirse y juego en línea
- XR-067: Mantenimiento de las interacciones de Jugado recientemente con
Inicialización de red
PlayFab Party no controla automáticamente la inicialización de red para los títulos de Microsoft Game Development Kit (GDK). Espere a que la red se inicialice antes de llamar a PlayFab Party. Las API de Party producen un error hasta que la red se inicializa.Suspensión y reanudación
Debe registrarse para los eventos de suspensión y reanudación medianteRegisterAppStateChangeNotification. Al suspender, limpie Party con PartyManager::Cleanup(). Al reanudar, debe volver a esperar la inicialización de red antes de llamar a PartyManager::Initialize(). Las API de Party producen un error si intenta usarlas a lo largo de un ciclo de suspensión y reanudación.
PartyManager::Cleanup() puede tardar un par de cientos de milisegundos en completarse. Recomendamos limpiar Party en paralelo con sus otras operaciones de suspensión para evitar tiempos de espera de suspensión. Si llama a Partymanager::Cleanup() de forma asincrónica, asegúrese de bloquear la notificación de suspensión hasta que la limpieza de Party devuelva un resultado.
Información de precios
PlayFab Party es gratuito para Microsoft Game Development Kit (GDK) cuando se usan identidades de XBOX services. Para obtener más información sobre precios y facturación, vea Preguntas más frecuentes sobre el programa gratuito de XBOX services.Configuración de su título en el portal de PlayFab
- Vaya a https://developer.playfab.com/ y cree una cuenta.
- Cree un estudio y un identificador de título de PlayFab con su nueva cuenta.
- Vaya al título recién creado, seleccione la sección Multiplayer y, a continuación, seleccione la pestaña Party (Preview).
- Seleccione Enable y escriba el código de acceso XBOX Live. Party se habilita después de unos instantes.
- En la pestaña API Features, copie el identificador de título de PlayFab y el ICD de entidad.
- Agregue el identificador de título y el ICD de entidad a la función de inicialización de la API de PlayFab Party del cliente. Ahora puede usar PlayFab Party en su título de Microsoft Game Development Kit (GDK).
Incorporación de la biblioteca de PlayFab Party a su proyecto de Microsoft Game Development Kit (GDK) mediante Visual Studio
- Haga clic con el botón derecho en el proyecto en el Explorador de soluciones de Visual Studio y, a continuación, seleccione Propiedades.
- En Propiedades de configuración, vaya a la sección XBOX One.
- Seleccione la lista desplegable Gaming Extension Libraries y agregue una referencia a PlayFab Party y a XBOX Live Helper.
[!NOTE] Las bibliotecas se instalan en una ubicación predeterminada en Program Files (x86)\Microsoft GDK[Version]\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\Redist\x64 (octubre de 2024 o posterior) -o- Program Files (x86)\Microsoft GDK[Version]\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\Redist\CommonConfiguration\neutral (junio de 2024 o anterior).