Preguntas frecuentes

En este documento, se responden preguntas comunes sobre los SDKs y la publicación para Google Play Juegos para PC.

Monetización

  1. ¿Por qué falla mi flujo de compra con el código de error 6 después de agregar una nueva clave de facturación o de licencia?

    Las claves de licencia recién generadas en Google Play Console experimentan un almacenamiento en caché de varias horas y una demora en la propagación en el backend de comercio antes de que las memorias caché internas de Google Play se sincronicen en todos los entornos de publicación. Aunque el cliente de tu juego puede consultar los detalles del producto correctamente, las solicitudes de compra fallarán con el código de error 6 hasta que se complete la sincronización. Espera varias horas después de subir o actualizar tu clave de licencia antes de probar las compras.

  2. ¿Puedo usar el flujo de compra sin un servidor backend?

    Desde una perspectiva de seguridad, Google recomienda usar un servidor backend.

    Para obtener más información, consulta Procesar sin un servidor backend.

  3. ¿Se permiten los sistemas de pago existentes basados en la API después de integrar el SDK de Google Play Juegos para PC?

    El SDK de Google Play Juegos para PC debe controlar todos los pagos con la Facturación Google Play. No puedes usar tu forma de pago existente basada en la API en el mismo juego.

  4. ¿Cómo podemos consumir compras en el modo de desarrollador?

    Consume la compra en el modo de desarrollador en un plazo de 3 minutos; de lo contrario, se reembolsará la compra.

  5. ¿Se admiten suscripciones o pagos recurrentes?

    No en el futuro inmediato, aunque puedes proporcionar casos de uso específicos para que los agreguemos a nuestra planificación futura.

  6. ¿Qué es el error de facturación en mis llamadas de compra?

    BillingError es la respuesta del resultado del pago. LaunchPurchaseFlow mostrará un valor de inmediato sin bloquear, pero debes escuchar la devolución de llamada para saber cuándo finalizó y capturar el resultado.

  7. ¿Cómo puedo usar la verificación de compra del cliente?

    Te recomendamos que uses la compra del servidor y su proceso de verificación. Para procesar compras desde tu app cliente, tu juego debe estar en una lista de entidades permitidas. Comunícate con tu socio de Google si tu juego requiere acceso. Para obtener más información, consulta Procesar sin un servidor backend.

  8. ¿Cuáles son los límites de la API para consultar detalles del producto?

    La cantidad máxima de productos que se pueden consultar en una sola llamada a la QueryProductDetails API es de 50. Si superas este límite, debes dividir la solicitud en varias llamadas.

  9. ¿Qué parámetros se requieren cuando se llama a Query Purchases o Launch Purchase Flow en el cliente de facturación?

    La función acepta QueryPurchasesContinuation, que es una devolución de llamada de función con la firma std::function<void(QueryPurchasesResult)>. La devolución de llamada te pasa el resultado con todos los ProductPurchaseDetails. Esta información está disponible en los archivos de encabezado del SDK en el archivo includes/billing/models.h.

    El launch_purchase_flow_result resultante tiene funciones ok() y code(). La función ok() muestra si el flujo es correcto. La función code() muestra la enumeración BillingError (includes/billing/enums.h), que tiene 10 casos de error posibles, como el usuario canceló o error de red.

  10. ¿Se admite un pedido personalizado para el flujo de compra de lanzamiento en el cliente de facturación?

    En el diseño actual del SDK, no hay forma de pasar tu propia carga útil. Sin embargo, puedes proporcionar cualquier combinación de obfuscated_account_id y obfuscated_profile_id. Puedes proporcionar ninguno, solo uno o ambos.

    El campo offer_token es obligatorio y especifica la oferta de compra que el usuario intenta comprar en el proceso de confirmación de compra. Por ahora, cada SKU en Google Play tiene exactamente una oferta (por ejemplo, comprar un artículo por USD 10). En el futuro, el equipo de facturación de Play proporcionará compatibilidad con varias ofertas.

    Para garantizar que los metadatos estén asociados con las interrupciones del flujo de compra, almacena los metadatos en tu servidor backend antes de iniciar el cuadro de diálogo de compra y los asocies con el ID de cuenta del usuario, el SKU de la compra en cuestión y la marca de tiempo correspondiente. Para obtener más información, consulta Cómo asociar una compra con datos internos.

  11. ¿Cuáles son los requisitos previos para cambiar de la facturación de Google con OAuth a la facturación de Google basada en DLL?

    Los juegos pueden seguir usando el acceso con OAuth a Google para administrar la cuenta con la que se accedió, pero Google recomienda que dejes de usar las APIs de facturación de REST heredadas. El cambio de las APIs de facturación de REST (con acceso a OAuth2) al flujo del SDK puede ser una operación marcada con una marca de función, por lo que ambas pueden coexistir durante un período mientras el juego cambia.

  12. ¿Se procesa la llamada a la API de flujo de compra de lanzamiento a través de un navegador web?

    No, el flujo de compra ahora se completa por completo en el juego con una superposición de WebView sin problemas, sin salir del cliente del juego.

  13. ¿Un usuario debe acceder por separado a cada juego para realizar una compra?

    La cuenta en primer plano de Google Play Juegos se usa para cada sesión de juego, por lo que no es necesario volver a acceder. La cuenta que usas en Google Play Juegos cuando comienza la sesión de juego es la cuenta con la que se emiten las llamadas a la API. El flujo de compra usará esta cuenta automáticamente.

  14. ¿Un juego puede admitir el SDK para PC y los sistemas de pago heredados al mismo tiempo?

    El sistema de pago opera con un modelo de flujo doble según la versión binaria del juego. Los usuarios de compilaciones heredadas continúan en el flujo existente, y los usuarios de compilaciones nuevas realizan la transición a pagos basados en el SDK. Los usuarios de ambos flujos de pago coexisten durante el período de transición.

Windows App Bundle

  1. Cuando se envía un WAB con un launcher de terceros, ¿se requiere el paquete del juego para su revisión?

    Solo puedes enviar el instalador y no necesitas enviar todo el paquete del juego. El revisor podrá descargar el paquete del juego con el instalador.

  2. ¿Existen limitaciones en el tamaño del archivo WAB?

    Puedes subir un tamaño de archivo de hasta 10 GB para un WAB.

  3. ¿Por qué mi juego no se instala ni aparece después de subir mi WAB?

    Si tu juego se incorpora sin una versión para PC preexistente (un "WAB por primera vez"), es posible que el sistema lo coloque automáticamente en un estado de retención de publicación administrada. Esto sucede porque no hay una línea de base existente para actualizar. Para lanzar por completo el WAB y hacer que el juego esté disponible para la instalación, debes navegar a Google Play Console y ejecutar manualmente la acción de publicación requerida (por ejemplo, hacer clic en "Publicar cambios").

  4. ¿Cómo subo el WAB para pruebas internas?

    Comparte las cuentas de la lista de entidades permitidas con Google para que pueda habilitarlas para pruebas internas. Después de que Google tenga la lista, se asegurará de que se incluyan en el proceso de incorporación.

  5. ¿Dónde se debe subir el paquete WAB?

    Puedes subir el paquete WAB en la ubicación mencionada en la primera pregunta. Sin embargo, no puedes publicarlo de forma manual. Debes proporcionar al personal de backend de Google una hora UTC precisa (hasta la hora). Luego, Google configura el cronograma de lanzamiento y se asegura de que se publique a tiempo.

SDK para PC

  1. ¿Cuáles son las diferencias entre la API heredada y el SDK de Google Play Juegos para PC?

    • La API heredada solo ofrece funcionalidad de facturación.
    • El SDK para PC admite el Servicio de escritorio de Google (GDS) y las funciones completas de PC.
    • No se requiere el acceso a Google basado en navegador con el SDK para PC.

  2. ¿Existe una forma alternativa de inicializar el SDK iniciando el juego directamente con el launcher del juego, sin pasar por Google Play Juegos para PC?

    Tu juego debe iniciarse a través del cliente de Google Play Juegos para PC. Para obtener más detalles, consulta este documento para desarrolladores.

  3. ¿El SDK para PC admite caracteres multibyte en el archivo de certificación PEM?

    Sí, el SDK admite caracteres multibyte para la certificación.

  4. ¿Cómo controla el SDK el acceso a la Cuenta de Google para varias instancias o cuentas?

    Cada lanzamiento de juego en Google Play Juegos se trata como una "sesión de juego", y cada "sesión de juego" puede tener una cuenta asociada. Pueden ser diferentes. Por lo tanto, si inicias el juego con la cuenta A y, luego, cambias a la cuenta B y vuelves a iniciar, ambos pueden ejecutarse al mismo tiempo.

  5. ¿La integración de la URL de referencia de instalación de Play funciona con el SDK para PC?

    El SDK para PC (25.5.409.0 y versiones posteriores) admite la API de URL de referencia de instalación de Play. Para obtener más información, consulta API de URL de referencia de instalación de Play.

Launcher

  1. Si un jugador usa un launcher de terceros en lugar del cliente de Google Play, ¿se sincronizará automáticamente su cuenta de Servicios de Play Games?

    Para que funcionen las funciones del SDK, el juego debe iniciarse directamente a través del cliente de Google Play Juegos. Si otro proceso, como un instalador o una aplicación de launcher, inicia el juego, ese proceso debe iniciarse desde el cliente de Google Play Juegos. El juego debe pasar todos los parámetros recibidos del cliente al proceso del cliente.

  2. ¿Cómo manejo la inicialización si Google Play Juegos inicia un launcher de juegos de terceros?

    No es necesario que integres el SDK directamente en tu launcher. Sin embargo, debes pasar todos los argumentos de la línea de comandos que recibe el launcher del cliente de Google Play Juegos directamente al proceso secundario generado (el ejecutable del juego). Si falla la inicialización (por ejemplo, si se muestra kActionRequiredShutdownClientProcess), se deben finalizar todos los procesos, incluido el launcher, para que Google Play Juegos pueda intentar recuperar y reiniciar el juego automáticamente. Para obtener más detalles, consulta el paso 5 de la guía de configuración.

  3. ¿Cómo puedo manejar las actualizaciones y el mantenimiento de mi juego y launcher después de que estén en producción?

    Las actualizaciones y el mantenimiento posteriores deben implementarse a través de tu launcher. El cliente de Google Play Juegos no admite funciones de actualización, por lo que el launcher debe poder actualizar el juego y el launcher.

  4. ¿Cómo recibe el instalador el token de sesión de GPG para la reproducción automática?

    GPG pasa el token de sesión con el --g_session_token=<token> argumento de línea de comandos al instalador. Para habilitar esto, debes establecer acceptsCommandLineArguments="true" en tu play_publishing_config.xml.

    El instalador es responsable de extraer este token y usarlo para iniciar el juego. Si falla la generación de tokens, GPG inicia el instalador sin el token (reserva).

Inicialización

  1. Cuando inicio un juego con la app de Google Play Juegos, ¿se sincronizan los detalles de mi Cuenta de Google?

    Después de iniciar el juego a través del cliente de Google Play Juegos, la cuenta se sincroniza automáticamente y no es necesario volver a acceder a través del proceso de acceso de Google.

  2. ¿Es posible volver a usar los parámetros de inicialización varias veces?

    Esto es posible siempre que el cliente de Google Play Juegos esté en ejecución y la información de acceso sea válida. Sin embargo, en situaciones como la que se describe en la guía, se deben finalizar todos los procesos que inicia el juego cuando el usuario lo cierra o cuando el juego se cierra debido a una falla de inicialización del SDK, como kActionRequiredShutdownClientProcess.

  3. ¿Hay alguna forma de crear un acceso directo para abrir el juego directamente?

    Puedes usar el siguiente URI para abrir el juego directamente:

    googleplaygames://launch/?pid=2&id=com.company.gamename

    El URI admite la detección de si se abrió el cliente de Google Play Juegos para PC. Si el cliente no está abierto, el cliente de Google Play Games se abre antes de que se ejecute el juego o el launcher. Debes administrar el juego o el launcher para evitar que se ejecuten varias instancias.

  4. ¿Hay alguna forma de verificar la instalación de Google Play Juegos para PC sin usar el SDK?

    Puedes verificar el estado de instalación de Google Play Juegos para PC sin integrar el SDK. Para ello, verifica la presencia de la siguiente clave del Registro de Windows:

    HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games Services

    La presencia de esta clave indica que los servicios de Google Play Juegos (necesarios para ejecutar juegos en la PC) están instalados en la máquina. Si falta la clave, debes dirigir al usuario a la página de instalación de Google Play Juegos para PC para descargar e instalar el cliente.

Pruebas

  1. ¿Existen entornos de pruebas abiertas o cerradas similares a los dispositivos móviles?

    Si bien no hay una zona de pruebas de extremo a extremo dedicada, reconocemos la necesidad de un entorno de pruebas similar a la producción para los desarrolladores. Pronto se ofrecerá una solución más sólida.

  2. ¿Cómo puedo agregar verificadores nuevos?

    Tu punto de contacto de Google crea un grupo de correo electrónico para cada proyecto de PC, en el que se deben agregar las Cuentas de Google de los verificadores. Solo los miembros de este grupo de correo electrónico están autorizados para descargar los paquetes de prueba en Google Play Juegos.

Varios

  1. ¿Puedo usar una VPN?

    Para los desarrolladores que necesitan probar su juego en regiones en las que no se admite Google Play Juegos para PC, te recomendamos que uses una VPN para obtener una dirección IP de una región admitida.

    Asegúrate de habilitar el modo TUN en la VPN. En el manual de operaciones del proveedor de VPN, puedes encontrar instrucciones para habilitar el modo TUN y configurar el firewall.

    Después de habilitar el modo TUN, instala Google Play Juegos para PC y el emulador para realizar pruebas.

  2. ¿Cómo puedo comenzar a desarrollar para Google Play Juegos para PC en Unity o el editor de UE?

  3. ¿Cómo puedo usar las claves de registro correctamente?

    Debes crear claves de registro basadas en el subárbol raíz. Puedes establecer el subárbol raíz como HKEY_LOCAL_MACHINE o HKEY_CURRENT_USER, según tu propósito y la naturaleza de los datos. El subárbol HKEY_LOCAL_MACHINE se usa como ejemplo en los lineamientos.

  4. ¿Cuáles son los requisitos para la revisión de Google de los paquetes de PC?

    Los paquetes de PC se someten a un análisis de software malicioso, después de lo cual los revisores solo prueban la instalación del juego, el inicio correcto y los procesos de desinstalación.

  5. ¿Es necesario integrar todas las APIs?

    No se requieren otras APIs, pero ofrecen beneficios adicionales. google::play::billing es necesario para las compras directas desde la aplicación y la venta de contenido digital. google::play::install_referrer es necesario para hacer un seguimiento de los datos de referencia y ayudarte a comprender qué fuentes de tráfico envían la mayor cantidad de usuarios para descargar tu app. google::play::games::integrity es necesario para proteger tu app de los actores maliciosos mediante la detección de dispositivos potencialmente riesgosos y emuladores desconocidos.

  6. ¿Por qué se finalizan algunos procesos del juego cuando se cierra el cliente de Google Play Juegos, mientras que otros no?

    Google no controla los subprocesos ni los procesos del juego en ejecución. El comportamiento depende de si el juego es un juego emulado de Android o un juego para PC. Los juegos emulados se instalan dentro de su propio entorno, por lo que su comportamiento depende en gran medida de la inicialización y el cierre del emulador.

  7. ¿Debo usar la capacidad de desinstalación de Google Play Juegos o un desinstalador personalizado?

    Google recomienda usar nuestra capacidad de desinstalación de Google Play Juegos.

Asistencia adicional

Si necesitas más ayuda que no se incluye en estas preguntas frecuentes, comunícate con google-play-games-pc@google.com