Uso en el cliente de los privilegios de usuario de los servicios XBOX

​

Tabla de contenido

• Requisitos previos
• Gestión en el cliente y experiencia del jugador para privilegios y ventas adicionales
• Procedimientos recomendados para la gestión de privilegios en la aplicación
• Probar el control de acceso basado en privilegios en sus juegos
• Identificadores de privilegios que se deben comprobar

​

Requisitos previos

​

Gestión en el cliente y experiencia del jugador para privilegios y ventas adicionales

1. El jugador ve una opción para iniciar una sesión multijugador e intenta iniciar una partida seleccionando la opción correspondiente en la IU.
2. El juego comprueba la “sugerencia” mediante la API XUserCheckPrivilege.
   • Si está presente, se asume que el jugador tiene el privilegio y se continúa.
   • Si no está presente, se pasa al paso siguiente.

   [!NOTE] Las API de los servicios XBOX devuelven un código de estado 403 (HTTP_E_STATUS_FORBIDDEN) cuando se deniega el acceso a una característica debido a la falta de un privilegio en el XToken. Todos los puntos de conexión de los servicios XBOX aplican el control de acceso basado en privilegios según corresponda.

3. En respuesta al código de error, el juego llama a XUserResolvePrivilegeWithUiAsync con el identificador de privilegio adecuado para el que se intenta resolver. Esta función llama a los servicios XBOX para ver si el jugador tiene el privilegio y, a continuación, indica al jugador por qué falló la acción o le muestra la IU para resolverlo. Esta llamada a la API puede dar los siguientes resultados.
   • Mostrar la IU relacionada con el estado de cumplimiento del jugador emitido por los moderadores de directivas y cumplimiento de los servicios XBOX.
   • Mostrar la IU relacionada con sus controles parentales.
   • Promocionar un servicio de suscripción aplicable, como una suscripción a XBOX Game Pass Essential.
   • Devolver el resultado al juego (un éxito o un error, con un motivo).

   [!NOTE] Si los servicios XBOX o la red no están accesibles, XUserResolvePrivilegeWithUiAsync falla. Este error debe tratarse como si el jugador no tuviera el privilegio.

4. Al volver de XUserResolvePrivilegeWithUiAsync:
   1. Si se devuelve un error, el juego debe permitir que el jugador siga seleccionando el botón, porque (por ejemplo) las expulsiones del jugador pueden expirar o los controles parentales pueden cambiar.
   2. Si se devuelve un éxito, el problema del jugador se ha corregido y su juego puede intentar la acción de nuevo. El token del jugador contendrá los privilegios necesarios como parte de la corrección realizada por XUserResolvePrivilegeWithUiAsync.

Para obtener más información sobre qué privilegios son aplicables a su título, consulte XR-015 en el tema Directivas y requisitos de XBOX.

​

Código de ejemplo

XUserPrivilegeDenyReason reason;
bool hasPrivilege = false;

// check the Multiplayer (254) privilege
HRESULT hr = XUserCheckPrivilege(userHandle, XUserPrivilegeOptions::None, XUserPrivilege::Multiplayer, &hasPrivilege, &reason);

// error with the user such that we can't yet check privileges
if(E_GAMEUSER_RESOLVE_USER_ISSUE_REQUIRED == hr)
{
      asyncBlock.callback = [](XAsyncBlock *async)
      {
         HRESULT hr = XUserResolveIssueWithUiResult(async);
         // if SUCCEEDED(hr), the issue is resolved, try the privilege check again
         // if FAILED(hr), the issue is not resolved, the title should deny access to the user, and perhaps try again later
      };

      hr = XUserResolveIssueWithUiAsync(userHandle, nullptr, &asyncBlock);
}

// user doesn't have the requested privilege, try to resolve the issue
else if(!hasPrivilege)
{
      asyncBlock.callback = [](XAsyncBlock *async)
      {
         HRESULT hr = XUserResolvePrivilegeWithUiResult(async);
         // if SUCCEEDED(hr), all privilege issues are now resolved, the user has the privilege,
         //    and the title should continue. It is not necessary to call XUserCheckPrivilege again.
         // if FAILED(hr), the user did not resolve all privileges, the title should deny access to the user and perhaps try again later
      };

      hr = XUserResolvePrivilegeWithUiAsync(userHandle, XUserPrivilegeOptions::None, XUserPrivilege::Multiplayer, &asyncBlock);
}
else if(hasPrivilege)
{
      // the user has the privilege, continue!
}

​

Procedimientos recomendados para la gestión de privilegios en la aplicación

​

Frecuencia de resolución de privilegios en la aplicación

• Para las aplicaciones de transmisión multimedia, como los reproductores de vídeo, resuelva las comprobaciones de privilegios una vez por cada selección del botón Play (inicio de la transmisión) o al comienzo de una lista de reproducción (para varias transmisiones, como una lista de reproducción de música).
• Para las aplicaciones de mensajería, compruebe los privilegios una vez para el primer mensaje que se envíe.
• Para los juegos multijugador que usan servicios de emparejamiento de terceros, resuelva las comprobaciones de privilegios al inicio de cada sesión (partida).

​

Nunca dé por supuesto el nivel de suscripción de un usuario

​

Modo sin conexión

​

Dirigirse al jugador correcto

​

Comprobar sin IU, o con la IU fuera del foco

​

Probar el control de acceso basado en privilegios en sus juegos

• Los derechos de suscripción efectivos del jugador
• Los derechos de privilegios efectivos del dispositivo
• Los derechos de privilegios efectivos de la plataforma cliente
• Los derechos de privilegios efectivos del juego actual
  • Es posible empaquetar un juego con una colección de privilegios de modo que todos los jugadores del juego obtengan automáticamente estos privilegios para usarlos en el juego en ejecución. Si su juego requiere esta característica, póngase en contacto con su administrador de cuenta de Microsoft.
• Los controles parentales para que los padres decidan qué privilegios agregar o quitar a los menores de su familia
• Los moderadores de XBOX pueden prohibir privilegios a los jugadores o dispositivos que hayan sido identificados por abuso del servicio

​

Administrar y comprobar los privilegios y permisos de los jugadores

• En PC: vaya a https://aka.ms/XboxPrivSettings.
• En XBOX: vaya a Settings -> General -> Online safety & family -> Privacy & online safety -> XBOX privacy

​

Privilegios comprobados con XUserCheckPrivilege

XUserPrivilege::CrossPlay

• Descripción: permite a un jugador participar en una sesión de juego con otros jugadores reales que no han iniciado sesión en los servicios XBOX en escenarios como: juego sincrónico jugador contra jugador en la misma sesión, juego asincrónico por turnos, juego en equipo, emparejamiento iniciado por el usuario, envío o aceptación de invitaciones, sesiones con incorporación en curso.
• Requisito: XR-045 - XBOX services and Account Privileges
• Identificador de privilegio: 185
• Configuración en PC: You can play with people outside of XBOX services
• Configuración en XBOX: You can join cross-network play

XUserPrivilege::Sessions

• Descripción: permite a un jugador participar en experiencias conectadas de un solo jugador en entornos compartidos o en escenarios en los que un título es un título híbrido multijugador gratuito y de pago y usa este privilegio para controlar esas experiencias en las consolas XBOX. Las experiencias de un solo jugador no deben tener ninguna característica cubierta por los privilegios 252 o 254 (Communications y Multiplayer, respectivamente). El uso de este privilegio es una capacidad del título que requiere la aprobación de la plataforma.
• Requisito: XR-045 - XBOX services and Account Privileges
• Identificador de privilegio: 189
• Configuración en PC: You can join multiplayer games
• Configuración en XBOX: You can join multiplayer games

XUserPrivilege::Multiplayer

• Descripción: permite a un jugador unirse a sesiones de juego multijugador en línea con usuarios reales (no bots) en escenarios como: juego sincrónico jugador contra jugador en la misma sesión, juego asincrónico por turnos, juego en equipo, emparejamiento iniciado por el usuario, envío o aceptación de invitaciones, sesiones con incorporación en curso. Tenga en cuenta que este privilegio no se aplica a los juegos multijugador locales que se ejecutan en el mismo dispositivo.
• Requisito: XR-045 - XBOX services and Account Privileges
• Identificador de privilegio: 254
• Configuración en PC: You can join multiplayer games
• Configuración en XBOX: You can join multiplayer games

XUserPrivilege::UserGeneratedContent

• Descripción: permite a un jugador ver en línea el contenido generado por otros usuarios (UGC), descargar el UGC de otros usuarios o compartir su propio UGC en línea. Esto no restringe el uso del UGC descargado previamente.
• Requisito: XR-045 - XBOX services and Account Privileges
• Identificador de privilegio: 247
• Configuración en PC: You can see and upload community creations
• Configuración en XBOX: You can see and upload community creations

XUserPrivilege::SocialNetworkSharing

• Descripción: solo consolas XBOX: permite a un jugador compartir información, incluidos el progreso del juego, el contenido generado por Kinect, los clips de juego, etc., fuera de la red XBOX.
• Requisito: XR-045 - XBOX services and Account Privileges
• Identificador de privilegio: 220
• Configuración en XBOX: You can share outside of XBOX

XUserPrivilege::Communications

• Descripción: permite a un jugador comunicarse con cualquier otro usuario de los servicios XBOX mediante voz o texto.
• Requisito: XR-045 - XBOX services and Account Privileges
• Identificador de privilegio: 252
• Configuración en PC: Others can communicate with voice, text or invites
• Configuración en XBOX: Others can communicate with voice, text or invites

​

Permisos comprobados con XblPrivacyCheckPermissionAsync

XblPermission::CommunicateUsingText

• Descripción: compruebe si el jugador puede enviar o no un mensaje con contenido de texto al usuario de destino. Este valor no cambia si el jugador ha silenciado al usuario de destino. Use CommunicateUsingVoice en su lugar. Este valor será false si, por ejemplo, ha configurado sus comunicaciones solo para amigos y el destinatario no es un amigo. Este valor será false si, por ejemplo, el jugador de destino le ha bloqueado. Este valor será false si, por ejemplo, ha configurado sus opciones de comunicación como bloqueadas.
• Requisito: XR-015 - Managing Player Communication
  • Al comprobar a otro usuario de los servicios XBOX
    • Configuración en PC: Others can communicate with voice, text or invites
    • Configuración en XBOX: Others can communicate with voice, text or invites
  • Al comprobar a un usuario anónimo
    • Configuración en PC: You can communicate outside of XBOX services with voice & text
    • Configuración en XBOX: You can communicate outside of XBOX with voice & text

XblPermission::CommunicateUsingVoice

• Descripción: compruebe si el jugador puede comunicarse o no mediante voz con el usuario de destino. Este valor será false si el jugador ha silenciado al usuario de destino.
• Requisito: XR-015 - Managing Player Communication
  • Al comprobar a otro usuario de los servicios XBOX
    • Configuración en PC: Others can communicate with voice, text or invites
    • Configuración en XBOX: Others can communicate with voice, text or invites
  • Al comprobar a un usuario anónimo
    • Configuración en PC: You can communicate outside of XBOX services with voice & text
    • Configuración en XBOX: You can communicate outside of XBOX with voice & text

​

Probar privilegios proporcionados por suscripciones

​

Probar privilegios proporcionados por el juego en ejecución

​

Probar privilegios eliminados por el control parental

​

Identificadores de privilegios que se deben comprobar

​

Lógica de cálculo de privilegios

​

Derechos de privilegios derivados del tipo de dispositivo

​

Derechos de privilegios efectivos derivados de suscripciones

• El jugador ha comprado el producto de suscripción.
• Otro jugador activo en el mismo dispositivo ha comprado el producto de suscripción.
• El producto de suscripción está asociado al dispositivo que el jugador está usando actualmente.

​

Derechos promocionales

​

Privilegios que se quitan a las cuentas de invitados patrocinados

​

Seguridad en línea y medidas de cumplimiento de Microsoft

​

Controles parentales

​

Privilegios para los suscriptores de XBOX Game Pass Essential

​

Suscripciones de asociados y privilegios

​

Títulos gratuitos (free-to-play) y privilegios multijugador

​

Títulos híbridos y privilegios multijugador

​

Consulte también