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. ¿Puedo usar el flujo de compra sin un servidor de backend?

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

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

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

    Todos los pagos deben manejarse con el SDK de Google Play Juegos para PC mediante la Facturación Google Play. No puedes usar tu forma de pago existente basada en la API en el mismo juego.

  3. ¿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.

  4. ¿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.

  5. ¿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.

  6. ¿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 de backend.

  7. ¿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.

  8. ¿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.

  9. ¿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.

  10. ¿Se pretende que se produzca un error de tiempo de espera si un usuario cierra el navegador sin pagar durante un flujo de compra?

    Sí, este es un problema conocido y un comportamiento previsto en el flujo basado en el navegador. Estamos trabajando de forma activa en una función de compra fluida (basada en WebView) que mantendrá el flujo de pago dentro del juego y resolverá este inconveniente de tiempo de espera.

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

    Los juegos pueden seguir usando el acceso de OAuth con 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. Cambiar de las APIs de facturación de REST (con acceso de 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?

    Sí, por ahora se procesa a través de un navegador. Google planea completar todo el flujo sin salir del juego, lo que se puede lograr a través del SDK.

  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 desde la que se emiten las llamadas a la API. Cuando inicias un flujo de compra en el navegador, debes haber accedido y usar la misma cuenta que la sesión de juego. Si el usuario accedió con una cuenta diferente, el flujo web le solicitará que cambie de cuenta.

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

    El sistema de pago opera con un modelo de flujo dual 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 de juego para la revisión?

    Solo puedes enviar el instalador y no necesitas enviar todo el paquete de juego. El revisor podrá descargar el paquete de 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 Google 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 la programación 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 Google Play Juegos para PC?

    PC?

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

  2. ¿Hay alguna forma alternativa de inicializar el SDK iniciando el juego directamente con el launcher de juegos, 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 nativo 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 maneja el SDK el acceso a la Cuenta de Google para varias instancias o cuentas?

    Cada inicio 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 Play Install Referrer funciona con el SDK para PC?

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

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é 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 la 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 cierra el juego o este 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 abre 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.

Prueba

  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 disponible, 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 adquirir 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 para PC?

    Los paquetes para PC se someten a un análisis de software malicioso, después del 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 necesaria para las compras directas desde la aplicación y la venta de contenido digital. google::play::install_referrer es necesaria 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 necesaria 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 nativo 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