Características del lado cliente
El GDK permite a los juegos implementar varios tipos de complementos dentro del juego y tipos de productos, como consumibles, duraderos (contenido descargable), suscripciones, agrupaciones (bundles) y versiones de prueba. El conjunto de API de XStore proporciona la funcionalidad necesaria para consultar, anunciar y administrar estos productos desde el lado cliente. Para ver un ejemplo de una tienda dentro del juego completamente funcional, consulte el ejemplo In-Game Store del GDK. Los siguientes artículos de la sección Aspectos básicos tratan estas API y escenarios:- Operaciones básicas de la Store: consulte qué está disponible para vender y qué posee el usuario
- Cómo usar un producto duradero sin paquete: uso de un producto duradero que no tiene un paquete de descarga independiente.
- Administración y licencia de contenido descargable (DLC): uso de productos duraderos tradicionales con paquetes de descarga.
- Ecosistemas basados en consumibles: instalación y configuración de un modelo de monetización basado en consumibles dentro del juego.
- Implementación de versiones de prueba para el juego: implementación de una versión de prueba integrada en el juego.
- Agrupaciones y pases de temporada: uso de agrupaciones y pases de temporada para ofrecer valor e interacción a los clientes con sus productos.
- Modelo de uso compartido de productos para juegos: el modelo de licencias de los juegos del GDK tanto en la consola XBOX como en PC con Windows y cómo se aplica el uso compartido entre usuarios.
Características del lado servidor
Los servicios de Microsoft Store que respaldan las API del lado cliente y permiten llamadas de servicio a servicio se dividen en los servicios siguientes:- Collections: proporciona información sobre qué productos posee el usuario o a cuáles tiene derecho, y completa productos consumibles. También se puede usar para detectar el estado de la suscripción a Game Pass para asociados autorizados.
- Clawback: permite a los servicios de asociados detectar y administrar los reembolsos emitidos a los usuarios por consumibles ya completados.
- Purchase: permite a los servicios de asociados agregar artículos gratuitos a la cuenta del usuario.
- Recurrence: proporciona información detallada sobre las suscripciones de un usuario y permite a los servicios de asociados administrar esas suscripciones en nombre del usuario.
Autenticación con los servicios de Microsoft Store
Para obtener información detallada sobre cómo autenticar su servicio con los servicios de Microsoft Store, consulte Solicitud de un User Store ID para la autenticación de servicio a servicio.Si está familiarizado con la autenticación con tokens X, el servicio Collections sí admite tokens X.
Información clave para los desarrolladores que usaron el XDK
Si está familiarizado con los sistemas de comercio del XDK, las definiciones siguientes deberían ayudarle a saber cómo se denominan los servicios equivalentes del GDK- Inventory Service: la funcionalidad del servicio Inventory del XDK (consultar la propiedad, completar consumibles, etc.) ahora la gestiona el servicio Collections. Esto incluye todos los escenarios de servidor a servidor para validar la propiedad y las cantidades de consumibles. Aunque los tokens X usados para Inventory funcionan para llamar a Collections, se recomienda que los asociados pasen al flujo de autenticación con tokens de Microsoft Entra ID y User Store ID para usar la funcionalidad ampliada de los servicios de Microsoft Store.
Ejemplo: https://collections.mp.microsoft.com/v8.0/collections/b2bLicensePreview - Inventory Client APIs: toda la funcionalidad del lado cliente relacionada con la consulta de la propiedad de artículos ahora se gestiona a través de las API de XStore.
Ejemplo: XStoreQueryEntitledProductsAsync devuelve los artículos que el usuario actual tiene derecho a usar en ese momento. - Catalog Browse APIs: toda la funcionalidad del lado cliente relacionada con la consulta de los productos disponibles para comprar dentro del juego ahora se gestiona a través de las API de XStore. No hay ninguna opción de servidor a servidor para consultar los productos disponibles para vender dentro del título.
Ejemplo: XStoreQueryAssociatedProductsAsync devuelve los productos que se pueden vender como parte de una tienda dentro del juego. - Trials and Licenses: toda la funcionalidad del lado cliente relacionada con las licencias de prueba ahora forma parte de las API de XStore. Ejemplo: XStoreQueryGameLicenseAsync devuelve la información de licencia del juego actual, incluida cualquier información de licencia de prueba. Para poder validar una licencia del lado cliente en su propio servicio, consulte Uso de tokens de licencia para validar las licencias en sus servicios.