Migración de la API al SDK

Si tus juegos nativos de Google Play Juegos para PC llaman directamente a las APIs de Play Billing, debes migrar tu juego para usar el SDK para PC.

Según el motor de juegos que uses, puedes integrar el C++ SDK o el C# SDK. Consulta los proyectos de muestra que demuestran ejemplos que se pueden usar para migrar tu juego nativo al SDK.

Configuración y preparación

En esta sección, se describen los pasos de migración de una solución basada en la API al SDK nativo de Google Play Juegos para PC.

Argumentos de la línea de comandos

El SDK nativo de Google Play Juegos para PC se basa en algunos argumentos de la línea de comandos que se pasan durante el inicio del proceso del juego para autenticar a los usuarios. Estos argumentos necesitan pasarse al proceso que llama a Initialize SDK. Si el inicio del juego involucra varios procesos, debes verificar que todos los argumentos se pasen al proceso que, en última instancia, usa el SDK. Consulta el paso de compatibilidad con varios procesos de juegos de la configuración.

Asignación de API

Para completar la migración, deberás quitar todas las llamadas directas a la API a los servidores de Play. Existen llamadas a funciones correspondientes en el SDK para lograr la misma funcionalidad. En esta sección, se muestra la asignación de cada funcionalidad.

Acceso con Google

Acceso con Google, también conocido como Acceder con Google, es un método de autenticación de OAuth que proporciona una opción de autenticación con un solo clic para los usuarios con su Cuenta de Google. En los proyectos basados en la API, asocias la cuenta de un jugador con sus compras. Las soluciones basadas en el SDK no requieren esta asociación.

Las soluciones basadas en el SDK usan la Cuenta de Google del cliente de Google Play Juegos que ya está asociada con el perfil de jugador y los derechos del jugador. Esto proporciona una experiencia más fluida para los jugadores y un entorno más seguro para los desarrolladores, ya que el SDK puede comunicarse de forma segura con el cliente de Google Play Juegos a través de IPC.

En lugar de Acceder con Google, llama a Initialize SDK lo antes posible. Actúa según el código de error para proporcionar un entorno seguro para el tiempo de ejecución de tu juego.

Obtén la lista de productos

En la solución de la API, tu servidor de backend recupera la lista de productos con el extremo inappproduct.gets de la API de Play Developer.

En el SDK, recupera la lista de productos integrados en la app directamente en el cliente con la QueryProductDetails función.

Genera compras

En la solución de la API, tu servidor de backend recupera las compras de los usuarios con el extremo purchases.products.get de la API de Play Developer.

En el SDK, usa la QueryPurchases función directamente desde el cliente del juego.

Inicia el flujo de compra

En la solución de la API, iniciar el flujo de compra requiere llamar a varios extremos para la configuración y adquirir los tokens necesarios.

En el SDK, inicia el proceso llamando a la función BillingClient's LaunchPurchaseFlow. El SDK controla todo el trabajo necesario.

Procesa la compra

El procesamiento de la compra del usuario implica confirmar y consumir la compra después de validar correctamente que es legítima. Tanto la solución de la API como la solución del SDK recomiendan que se completen los pasos desde el backend por motivos de seguridad.

El proceso es similar para la solución de la API y la solución del SDK:

Después de recuperar el purchaseToken de la compra, como ProductPurchase.purchaseToken en la solución de la API o ProductPurchaseDetails's purchase_token en la solución del SDK, envíalo a tu backend para su verificación.

Una vez que se verifique, tu backend podrá confirmar o consumir la compra de forma segura después de otorgar los derechos.

Enviar para pruebas

Para enviar tu juego para pruebas, sigue estos pasos.

Empaquétalos para el envío

Los juegos que usan el SDK deben empaquetarse en formato de paquete de aplicación para Windows y subirse a través de Play Console. Consulta la documentación para empaquetar tu juego en el paquete de aplicación para Windows para: