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 que use el SDK para PC.

Según el motor de juego que uses, puedes integrar C++ SDK o C# SDK. Consulta los proyectos de ejemplo que muestran 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 depende de 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 deben 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 Supporting multi game-processes de la configuración.

Asignación de API

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

Acceso con Google

El 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 APIs, asocias la cuenta de un jugador con sus compras. Las soluciones basadas en 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 la IPC.

En lugar de usar el acceso 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 aplicación directamente en el cliente con la función QueryProductDetails.

Obtén compras

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

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

Inicia el flujo de compra

En la solución de 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 LaunchPurchaseFlow de BillingClient. El SDK controla todo el trabajo necesario.

Procesa la compra

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

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

Después de recuperar el purchaseToken de la compra, como ProductPurchase.purchaseToken en la solución de la API o purchase_token de ProductPurchaseDetails 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 el derecho.

Envía el dispositivo para que se pruebe

Para enviar tu juego a pruebas, sigue estos pasos.

Paquete para el envío

Los juegos que usen 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 un paquete de aplicación de Windows para lo siguiente: