Skip to main content
Si su juego está destinado a consolas XBOX, debe cumplir un conjunto de requisitos para garantizar una funcionalidad y un comportamiento coherentes al interactuar con XBOX Live. Este conjunto de requisitos se enumera en los Requisitos de XBOX (XR, para abreviar). Los XR interactúan y se superponen con las directivas que se requieren para hacer uso de XBOX Live en su juego en PC y otras plataformas. Aquí se describen los procedimientos recomendados para PlayFab Party que le ayudarán a cumplir estos requisitos. Como referencia rápida, consulte la tabla siguiente, que relaciona los escenarios de PlayFab Party con los XR que abordan:

Biblioteca auxiliar de XBOX Live de PlayFab Party

Junto a la biblioteca principal de PlayFab Party, ofrecemos una biblioteca auxiliar de XBOX Live diseñada para ayudar a cumplir las directivas de XBOX Live y, por extensión, los XR. El uso de esta biblioteca auxiliar no es obligatorio, pero es muy recomendable y se considera un procedimiento recomendado. En los ejemplos presentados aquí se asumirá el uso de la biblioteca auxiliar de XBOX Live.

Alinear PlayFab Party con la configuración de chat y los privilegios de un usuario de XBOX Live

PlayFab Party usa un modelo de participación voluntaria para la comunicación de chat y, de forma predeterminada, restringe todas las comunicaciones entre dos controles de chat al conjunto de comunicaciones que ambos participantes han habilitado. Para obtener más información, consulte la documentación sobre permisos de chat y silenciamiento. La biblioteca auxiliar de XBOX Live de PlayFab Party indica qué conjunto de permisos de chat se debe habilitar para coincidir con las preferencias y los privilegios de los usuarios de XBOX Live que se comunican actualmente en la sesión de Party. Para obtener más información, consulte la documentación sobre respetar la configuración de privacidad y los permisos de un usuario de XBOX Live. Al hacer un uso adecuado de PlayFab Party y de la biblioteca auxiliar de XBOX Live, su juego puede cumplir por completo los requisitos especificados en XR-015 y puede cumplir los requisitos de comunicación pertinentes especificados en XR-045. Consulte la documentación técnica de XR-045 para conocer otros requisitos fuera del ámbito de PlayFab Party.

Mantener un documento de sesión multijugador

PlayFab Party no proporciona ningún tipo de lista de usuarios de XBOX. Se basa en que su juego use el servicio Multiplayer Session Directory (MPSD) para mantener una lista y asociar la actividad de red de Party con los usuarios de la sesión de juego. PlayFab Party anunciará los puntos de conexión y los controles de chat remotos a medida que entren y salgan de las redes de Party. Los identificadores de entidad de PlayFab asociados a estos objetos deben cotejarse con los usuarios de XBOX del documento de MPSD para reconocer qué objetos de PlayFab Party representan a usuarios de XBOX en la sesión de juego. En escenarios de juego cruzado, una entidad de PlayFab no asociada a un usuario de XBOX puede representar a un usuario de otro ecosistema multijugador. Para reconocer a los usuarios de XBOX, debe crear asignaciones entre los identificadores de entidad de PlayFab y los usuarios de XBOX Live. Para lograrlo, se recomienda almacenar la lista de usuarios de XBOX Live de la sesión en un documento de MPSD y traducir esos usuarios de XBOX Live a identificadores de entidad de PlayFab mediante la biblioteca auxiliar de XBOX Live. Para ver ejemplos, consulte Asignación entre identificadores de usuario de XBOX Live e identificadores de entidad de PlayFab. Además de proporcionar la lista de la red de Party, los documentos de MPSD también controlan muchas experiencias multijugador del ecosistema multijugador de XBOX, como el emparejamiento, las invitaciones de plataforma, las listas de jugadores recientes y la unión a partidas en curso. Para obtener más información sobre cómo incorporar las redes de Party en estos flujos de MPSD, consulte Uso de PlayFab Party con MPSD. Para obtener más información, consulte la Información general de MPSD.
Esta sección proporciona procedimientos recomendados al usar PlayFab Party junto con MPSD, pero PlayFab Party por sí mismo no satisface implícitamente los requisitos de MPSD de XR-067. Consulte la documentación técnica de XR-067 para obtener información sobre cómo satisfacer estos requisitos.

Uso de clientes XBOX en redes de Party de juego cruzado

En escenarios de juego cruzado, tenga en cuenta los siguientes procedimientos recomendados al interactuar con el ecosistema de XBOX Live.
Esta sección proporciona procedimientos recomendados para usar PlayFab Party en escenarios de juego cruzado con XBOX Live, pero el uso de PlayFab Party no satisface implícitamente los requisitos de juego cruzado de XR-007. Consulte la documentación técnica de XR-007 para obtener información sobre cómo satisfacer estos requisitos.

Identificar a los jugadores en una sesión de juego entre redes

Los jugadores únicos deben ser identificables y distinguibles entre ecosistemas multijugador. Para ello, PlayFab Party proporciona identificadores de entidad de PlayFab en los distintos objetos que pueden estar asociados a usuarios de su sesión: PartyLocalUser, PartyEndpoint, PartyChatControl. La API de PlayFab Party no proporciona nombres para mostrar entre redes. Al mostrar usuarios de XBOX en la interfaz de usuario, debe usar su gamertag, y el gamertag debe resolverse a partir del identificador de usuario de XBOX del documento de MPSD. Los usuarios que no sean de XBOX deben presentarse en la interfaz de usuario según las directrices de XR-007. A falta de un nombre para mostrar proporcionado por la plataforma, PlayFab ofrece compatibilidad con nombres para mostrar mediante GetPlayerProfile. Al unirse a una red, un jugador debe publicar su nombre para mostrar en un documento de sesión compartido para que otros jugadores lo vean. Aunque la biblioteca de PlayFab Party asocia algunos de sus objetos con usuarios de PlayFab (mediante identificadores de entidad de PlayFab), la biblioteca no proporciona funcionalidad para identificar con qué ecosistemas multijugador podría estar asociado un usuario de PlayFab. Para distinguir a los usuarios de PlayFab de XBOX Live de los usuarios de otros ecosistemas multijugador, se recomienda cotejar los identificadores de entidad de PlayFab de una red de Party con MPSD. Para obtener más información sobre cómo distinguir a los jugadores de XBOX Live de los que no lo son mediante MPSD, consulte la sección sobre Mantener un documento de sesión multijugador. Para obtener más información sobre los requisitos relativos a la identificación de usuarios en redes de juego cruzado con XBOX Live, consulte XR-007.

Respetar los permisos de comunicación entre redes de los usuarios de XBOX Live

PlayFab Party no cumple implícitamente las restricciones de comunicación entre redes de XBOX Live. Por lo tanto, la biblioteca auxiliar de XBOX Live de PlayFab Party proporciona funcionalidad para consultar los permisos de comunicación entre redes de un usuario de XBOX Live. Debe usar esta información para cumplir los requisitos de comunicación entre redes especificados en XR-007. Consulte Respetar las comunicaciones entre redes para obtener más información.

Usar invitaciones de PlayFab Party para restringir el acceso a las redes cuando no se permite el juego cruzado.

Los usuarios de XBOX Live necesitan privilegios entre redes para interactuar con usuarios que no sean de XBOX Live en sesiones de juego entre redes. PlayFab Party no cumple implícitamente estas restricciones entre redes (descritas en XR-007), por lo que este privilegio debe consultarse fuera de la biblioteca de PlayFab Party. Cuando no se conceden estos privilegios, debe restringir la red de Party para permitir solo a los usuarios de XBOX Live conocidos en el documento de MPSD de la sesión de juego. Puede lograrlo ampliando nuestro flujo de unión a partidas en curso de ejemplo para usar invitaciones de Party que solo permitan unirse a la red a usuarios de XBOX conocidos. En primer lugar, asegúrese de que la red de Party se cree con una invitación restringida.
De forma similar al flujo de unión a partidas en curso, cuando un nuevo usuario de XBOX quiera unirse a la red, primero se agregará a sí mismo al documento de sesión. Cuando el jugador que quiere permitirle entrar en la red vea la actualización, actualizará el conjunto de invitaciones para reflejar el documento de sesión. Esto garantizará que solo los usuarios del documento de sesión (que con seguridad son usuarios de XBOX Live) puedan unirse a la red.
Dado que necesitará traducir entre identificadores de usuario de XBOX Live e identificadores de entidad de PlayFab, se recomienda crear una asignación entre ambos. Consulte Asignación entre identificadores de usuario de XBOX Live e identificadores de entidad de PlayFab para ver ejemplos de cómo hacerlo.

Mantenerse sincronizado con la configuración del perfil de XBOX Live

PlayFab Party, de forma predeterminada, cumple los requisitos de configuración de perfil de XR-048. La biblioteca no mantiene una caché persistente de ninguna configuración de perfil de XBOX Live. Cuando PlayFab Party necesita usar la configuración del perfil, la configuración se consulta en XBOX Live y sigue siendo válida durante la vigencia del objeto de la API de PlayFab Party asociado a la configuración, pero no se conservará entre varias instancias del objeto. Para obtener información sobre el uso de los datos de configuración del perfil de XBOX Live fuera de PlayFab Party, consulte la documentación técnica de XR-048.

Compatibilidad con los flujos de unión multijugador de la plataforma

En XBOX, los jugadores pueden unirse a juegos multijugador mediante las características de unión a partidas en curso e invitaciones de plataforma. PlayFab Party no se integra directamente con estas características de plataforma, pero admite su uso a través de los objetos PartyNetworkDescriptor y PartyInvitation. Los objetos PartyNetworkDescriptor proporcionan la información de conexión necesaria para que un usuario remoto encuentre la red de Party y se conecte a ella, y se pueden serializar mediante PartyManager::SerializeNetworkDescriptor. Los objetos PartyInvitation proporcionan a los usuarios remotos un identificador que se usa para autenticarse y unirse a una red de Party. Para permitir que los usuarios remotos se unan a juegos multijugador mediante la unión a partidas en curso y las invitaciones de plataforma, integre el descriptor de red serializado y el identificador de invitación de Party en sus flujos preexistentes. También puede encontrar flujos de ejemplo en el documento Uso de PlayFab Party con MPSD. Para obtener más información sobre los requisitos de los flujos de unión multijugador de la plataforma, consulte la documentación técnica de XR-064 y XR-124.

Listas de amigos

Aunque PlayFab Party no interactúa de forma nativa con las listas de amigos en ninguna plataforma, es posible que los juegos multijugador aún deban tener en cuenta las listas de amigos en distintos escenarios. Para obtener información sobre los requisitos y las directrices al interactuar con las listas de amigos de XBOX Live y entre redes, consulte la siguiente documentación:

Respetar la directiva de reintentos del servicio XBOX Live y las limitaciones de acceso al servicio.

PlayFab Party no interactúa directamente con los servicios de XBOX Live fuera de la biblioteca auxiliar de XBOX Live. La biblioteca auxiliar de XBOX Live cumple internamente las directivas de reintento y las limitaciones de acceso de los servicios de XBOX Live pertinentes, tal y como se describe en XR-074 y XR-132. Asimismo, puede reconocer los errores de la API resultantes del cumplimiento de estas directivas de servicio a través de los siguientes códigos de error notificados por la biblioteca auxiliar de XBOX Live: PartyXblChatPermissionMaskReason::XboxLiveServiceError y PartyXblStateChangeResult::PartyServiceError. Para obtener más información sobre el cumplimiento de estas directivas de servicio fuera de la biblioteca auxiliar de XBOX Live, consulte la documentación técnica de XR-074 y XR-132.
Última modificación el 1 de septiembre de 2026