Integración con PlayFab Lobby y Match - XBOX Game Development Documentation

Este tema describe cómo integrar MPA con los servicios PlayFab Lobby y Match. Esto incluye procedimientos recomendados y una guía general aplicable a otros servicios de sala y emparejamiento similares.

Información general del diseño

Para integrar MPA con PlayFab Lobby y Match o servicios similares, un título o un servicio del título tiene que consultar la información relevante del estado de la sala y, después, migrar esta información al servicio MPA. El servicio MPA no está pensado para la información de estado de la sala ni de la sesión.

Actividad

Para MPA Activity, la información de origen debe ser la información de la sala subyacente. Un título o servicio necesita establecer la información relevante en los campos de contenido de la actividad de MPA siguiendo estos procedimientos recomendados:

Frecuencia de actualización La migración de estado desde los datos de la sala debe realizarse a un ritmo razonable para reflejar los cambios, como las actualizaciones de la información de CurrentPlayers. Las llamadas de actualización no deben superar los límites de llamadas descritos en Limitación de velocidad específica. Tampoco se debe eliminar o volver a crear una actividad de MPA para actualizar información.
Identidad de usuario de XBOX (XUID) El XUID de un jugador suele ser información no validada en servicios ajenos a los servicios de XBOX y no es el identificador principal para los servicios entre redes. PlayFab Lobby usa un identificador de entidad de usuario de PlayFab entre redes para los jugadores, que se puede convertir en un XUID para el usuario activo mediante llamadas de API o de servicio. Para obtener más detalles, consulte el tutorial de PlayFab Tutorial: Obtención del perfil de un jugador. Solo este XUID resuelto debe considerarse seguro. El XUID de los demás jugadores no se puede recuperar de esta manera. Como solución, los XUID se pueden proporcionar como propiedades de cadena personalizadas de un jugador en la sala. Estas cadenas no deben considerarse seguras y siempre deben validarse a través del servicio de PlayFab mediante PFAccountManagementClientGetPlayFabIDsFromXboxLiveIDsGetResult para comparar el identificador de entidad de usuario de PlayFab esperado y el real para un XUID. Una discrepancia indica un XUID incorrecto. Para todos los servicios, los XUID proporcionados como cadenas no seguras no son seguros y pueden dar lugar a ataques de suplantación de identidad sin validación.
Cadena de conexión Para la integración con el servicio PlayFab Lobby, la cadena de conexión de una actividad de MPA debe establecerse en la cadena de conexión de la sala, que se puede recuperar mediante PFLobbyGetConnectionString. Otros servicios deben usar una cadena de unión equivalente.
Reflejo de la capacidad de unión de la sala Una actividad está pensada para permitir que los jugadores se unan a experiencias de juego y debe coincidir con la capacidad de unión del estado de la sala subyacente. Una actividad se vuelve automáticamente no unible cuando está llena (CurrentPlayers alcanza el valor de MaxPlayers). Los títulos que quieran hacer que una actividad sea temporalmente no unible también pueden usar este comportamiento. Una actividad solo debe eliminarse cuando no sean posibles uniones futuras. Tenga en cuenta que modificar la configuración de privacidad de la actividad solo restringe las uniones, pero no puede bloquearlas todas. Debido a la latencia de las uniones a actividades, los títulos siempre deben tener en cuenta los flujos en los que las uniones se realizan contra sesiones llenas o no unibles, y proporcionar los errores adecuados al jugador.
Reflejo de los cambios de privacidad El estado y los cambios de la privacidad de la actividad a través de las restricciones de unión deben reflejar la directiva de acceso definida para la sala de PlayFab subyacente. Lo mismo se aplica a servicios similares y puede requerir la asignación de valores de privacidad.

Invitaciones

Para MPA Invites, el origen recomendado también debe ser la información de la sala subyacente. Este enfoque de procedimiento recomendado es más confiable que una invitación a una malla de red como PlayFab Party y puede proporcionar información de estado a través de los datos de la sala de inmediato. Para la integración con el servicio PlayFab Lobby, la cadena de conexión de una invitación de MPA debe establecerse en la cadena de conexión de la sala. Esta cadena se puede recuperar mediante PFLobbyGetConnectionString. Además, se debe establecer el valor de unión multiplataforma adecuado para la invitación.

Jugadores recientes

El uso de la funcionalidad de MPA Recent Players no está estrechamente vinculado a la sala subyacente y puede controlarse mediante la lógica del título. Las llamadas de jugadores recientes no deben superar los límites de llamadas descritos en Limitación de velocidad específica. Como procedimiento recomendado, la actividad de jugadores recientes debe procesarse por lotes dentro de un intervalo de tiempo razonable para respetar los límites de llamadas. No se espera que la notificación de jugadores recientes por parte de un título sea inmediata, y se prefiere el envío por lotes.

Emparejamiento

La integración de PlayFab Match o servicios de emparejamiento similares no requiere ninguna funcionalidad directa de MPA. Es posible que los títulos quieran actualizar la capacidad de unión de una actividad de MPA durante el emparejamiento si no es posible unirse. Como procedimiento recomendado, PlayFab Match debe usarse junto con PlayFab Lobby. Al igual que para la identidad de usuario de la sala, PlayFab Match usa un identificador de entidad de usuario de PlayFab entre redes para los jugadores, que se puede convertir en un XUID para el usuario activo mediante llamadas de API o de servicio. El XUID de los demás jugadores no se puede recuperar de esta manera. Como solución similar a la de la sala, los XUID se pueden proporcionar como propiedades de cadena personalizadas de un jugador en la sala. Estas cadenas no deben considerarse seguras y siempre deben validarse a través del servicio de PlayFab comparando el identificador de entidad de usuario de PlayFab esperado y el real para un XUID, tal como se describe anteriormente para PlayFab Lobby. Una discrepancia indica un XUID incorrecto. Para el emparejamiento, los XUID proporcionados como cadenas no seguras no son seguros y pueden dar lugar a ataques de suplantación de identidad sin validación.

Procedimientos recomendados generales

El servicio MPA está diseñado como un punto de integración ligero para la funcionalidad de XBOX sobre servicios de sala o emparejamiento, como PlayFab Lobby y Match. Esta integración puede ser ligera y realizarse solo en puntos de conexión específicos para reflejar la información necesaria y las actualizaciones relevantes en la funcionalidad de actividades, invitaciones y jugadores recientes. Además, la integración del servicio MPA también debe tener en cuenta los puntos de conexión de servicio a servicio. Según la arquitectura del juego, del multijugador y del servidor, las llamadas directas de servicio a servicio pueden ser drásticamente más simples y confiables que las llamadas de cliente. Esto suele aplicarse a los títulos MMO. Al igual que para la información de XUID almacenada en cadenas personalizadas como parte de PlayFab Lobby y Match, cualquier otra información de identidad personalizada debe considerarse siempre no segura y validarse antes de su uso. La falta de validación puede dar lugar a ataques de suplantación de identidad, especialmente cuando el juego incluye plataformas con más acceso de usuario y protecciones.

​Información general del diseño

​Actividad

​Invitaciones

​Jugadores recientes

​Emparejamiento

​Procedimientos recomendados generales