Licencias de Game Pass en las comprobaciones de licencia del cliente
Los derechos de Game Pass no se pueden detectar desde el cliente del juego. Cuando un usuario tiene derecho a su título a través de Game Pass, XStoreQueryGameLicenseAsync devuelve una licencia conisActive = true, igual que una compra directa. La estructura XStoreGameLicense no incluye un campo que identifique cómo se adquirió la licencia.
Para registrar cómo adquirieron los usuarios su título, por ejemplo con fines de telemetría, envíe la identidad del usuario desde el cliente a su propio servicio. A continuación, su servicio llama a la API publisherQuery y comprueba acquisitionType. Un valor de Recurring indica un derecho a través de Game Pass y Single indica propiedad directa.
Comportamiento de los datos de respuesta para publicadores autorizados y no autorizados
Si su publicador no está autorizado, los artículos con derecho a través de Game Pass aparecen como derechos de propiedad directa. Por ejemplo,acquisitionType aparece como Single y los ProductIds de Game Pass no aparecen en satisfiedByProductIds.
Para los publicadores autorizados, solo se devuelven las suscripciones activas a Game Pass. Si la suscripción a Game Pass del usuario se cancela o finaliza, las consultas posteriores dejarán de contener la información de Game Pass. Además, EndDate se normaliza al valor máximo, por lo que no se puede usar para detectar el final de la suscripción.
Retraso el día del lanzamiento en Game Pass en los resultados de derechos de servidor a servidor
Cuando los títulos o complementos se publican en Game Pass, prevea un retraso entre la disponibilidad en el cliente y la visibilidad enpublisherQuery. Este comportamiento se debe a los distintos intervalos de actualización de las cachés en los sistemas de la tienda. En la práctica, las licencias locales suelen actualizarse primero, y publisherQuery puede retrasarse entre dos y tres horas.
Las comprobaciones directas de los ProductIds de Game Pass no se ven afectadas; el retraso afecta principalmente a los artículos concedidos mediante derechos satisfechos.
Pruebas de suscripciones a Game Pass en su sandbox de desarrollo
Los niveles de XBOX Game Pass deben estar habilitados y ser accesibles buscándolos en la aplicación XBOX Store dentro de su sandbox de desarrollo. Las cuentas de prueba de XBOX se crean con una tarjeta de crédito de prueba y podrán suscribirse a los niveles de Game Pass en su sandbox. Si no puede encontrar los niveles de Game Pass en su sandbox, póngase en contacto con su Developer Partner Manager o su contacto de Microsoft para obtener ayuda.El estado de la suscripción a Game Pass no se conserva entre sandboxes. Al agregar Game Pass a una cuenta de prueba en un sandbox, no mueva esa cuenta de prueba a otro sandbox para pruebas o depuración de Game Pass u otras funciones relacionadas con el comercio.
Solicitud del estado de la suscripción a Game Pass
Para solicitar el estado de la suscripción a Game Pass del usuario, agregue los ProductIds correspondientes a los niveles de suscripción que está autorizado a ver en la lista productSkuIds de la solicitud de consulta (consulte la tabla).
Si el usuario tiene una suscripción en el nivel que solicitó, la respuesta de la consulta incluye un artículo con el ProductId del nivel de suscripción a Game Pass correspondiente.
Comportamiento al solicitar niveles incluidos en niveles superiores
Algunos niveles de Game Pass están incluidos cuando un suscriptor tiene un nivel superior. Cualquiera de sus niveles autorizados que esté incluido en niveles superiores se devuelve cuando el usuario está suscrito al nivel superior. Ejemplo: nuestro publicador está autorizado para XBOX Game Pass Essential. El usuario tiene XBOX Game Pass Ultimate y, cuando consulta todos los ProductIds de Game Pass, publisherQuery solo devuelve un resultado para XBOX Game Pass Essential. Si su publicador tiene acceso para ver alguno de los otros niveles, esos niveles también se devolverían.XBOX Game Pass (Starter Edition) es una excepción a la herencia y es un nivel independiente. No está incluido en ninguno de los otros niveles.
Concesión de ventajas en el juego a los suscriptores de Game Pass
Se recomienda solicitar acceso al nivel más bajo de Game Pass necesario para conceder ventajas y beneficios en el juego a los suscriptores. Ejemplo: va a conceder una recompensa en el juego a todos los suscriptores de Game Pass en la consola. Solo necesita acceso a XBOX Game Pass Essential (CFQ7TTC0K5DJ) porque Premium y Ultimate incluyen Essential.Detección de productos con derecho a través de una suscripción a Game Pass con satisfiedByProductIds
Después de la autorización, identifique los derechos derivados de Game Pass comprobando los valoressatisfiedByProductIds y acquisitionType. Un derecho basado en Game Pass tiene un acquisitionType de tipo Recurring, y satisfiedByProductIds incluirá el ProductID del nivel más alto de Game Pass para el que está autorizado.
Si usa la opción de filtro excludeDuplicates, el derecho relacionado con Game Pass se filtra si el usuario posee el título directamente.
satisfiedByProductIds de un artículo le indicará si el artículo tiene derecho a través de Game Pass, pero no es suficiente para determinar si el usuario es miembro de Game Pass. Por lo tanto, al comprobar el estado de la suscripción a Game Pass de un usuario, es mejor incluir los valores de ProductId de Game Pass en el campo productSkuIds de su solicitud.
Ejemplo de artículo duplicado con XBOX Game Pass
Si el usuario tiene tanto la propiedad directa como el derecho a través de Game Pass para el mismo producto, pueden aparecer dos entradas cuandoexcludeDuplicates es false. Cuando excludeDuplicates es true, se devuelve el artículo de compra directa.
Para conocer todas las reglas de resolución de duplicados y el comportamiento de prioridad de origen, consulte Descripción de los artículos duplicados en la respuesta.