Preguntas frecuentes

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

Monetización

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

    Desde el punto de vista de la seguridad, Google recomienda usar un servidor de backend.

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

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

    Todos los pagos deben procesarse con el SDK de Google Play Juegos para PC a través de 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 desarrollo?

    Procesa 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 devolverá el control de inmediato sin bloquearse, 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 compras 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. Si tu juego requiere acceso, comunícate con tu socio de Google. Para obtener más información, consulta Procesa sin un servidor de backend.

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

    La cantidad máxima de productos que se pueden consultar en una sola llamada a la API de QueryProductDetails 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() devuelve un valor que indica si el flujo se completó correctamente. La función code() devuelve el enum BillingError (includes/billing/enums.h), que tiene 10 posibles casos de error, como cancelación del usuario o error de red.

  9. ¿Se admite un orden personalizado para el flujo de compra de lanzamiento en BillingClient?

    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 adquirir en el proceso de confirmación de compra. Por el momento, cada SKU de Google Play tiene exactamente una oferta (por ejemplo, compra un elemento por USD 10). En el futuro, el equipo de facturación de Play brindará asistencia para varias ofertas.

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

  10. ¿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 de 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 a OAuth2) al flujo del SDK puede ser una operación controlada por una marca de función, por lo que ambos pueden coexistir durante un período mientras el juego realiza el cambio.

  11. ¿La llamada a la API de Launch Purchase Flow se procesa 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 interrupciones, sin salir del cliente del juego.

  12. ¿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 que vuelvas 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. El flujo de compra usará esta cuenta automáticamente.

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

    El sistema de pagos funciona con un modelo de flujo dual según la versión binaria del juego. Los usuarios de compilaciones heredadas continuarán con el flujo existente, y los usuarios de compilaciones nuevas realizarán la transición a los 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 selector de 3P, ¿se requiere el paquete del juego para la revisión?

    Solo puedes enviar el instalador, sin necesidad de enviar el paquete completo 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 archivos de hasta 10 GB para un WAB.

  3. ¿Por qué no se instala mi juego o no aparece después de que subí 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 espera de Publicación administrada. Esto sucede porque no hay un modelo de referencia existente para actualizar. Para lanzar por completo el WAB y que el juego esté disponible para su 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 las pruebas internas?

    Comparte las cuentas de la lista de entidades permitidas con Google para que pueda habilitarlas para las pruebas internas. Una vez que Google tiene la lista, se asegura de que se incluyan en el proceso de incorporación.

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

    Puedes subir el paquete de WAB a la ubicación que se menciona 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 funciones de facturación.
    • El SDK para PC admite el servicio de Google Desktop (GDS) y las funciones completas para PC.
    • No se requiere el acceso con Google basado en el navegador con el SDK para PC.

  2. ¿Existe otra forma de inicializar el SDK lanzando el juego directamente con el selector 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 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 inicio de un juego en Google Play Games se considera 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 el juego, ambos se pueden ejecutar al mismo tiempo.

  5. ¿La integración de Play Install Referrer funciona con el SDK para PC?

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

Launcher

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

    Para que las funciones del SDK operen, 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 inicio, 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 Games inicia un selector de juegos de terceros?

    No es necesario que integres el SDK directamente en tu selector. Sin embargo, debes pasar todos los argumentos de la línea de comandos que recibe el iniciador del cliente de Google Play Juegos directamente al proceso secundario generado (el ejecutable del juego). Si falla la inicialización (por ejemplo, si se devuelve kActionRequiredShutdownClientProcess), se deben finalizar todos los procesos, incluido el selector, para que Google Play Juegos pueda intentar recuperarse y volver a iniciar 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 el launcher después de que estén en producción?

    Las actualizaciones y el mantenimiento posteriores se deben implementar a través del selector. El cliente de Google Play Juegos no admite funciones de actualización, por lo que el selector debe poder actualizar tanto el juego como el selector en sí.

  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 argumento de línea de comandos --g_session_token=<token> al instalador. Para habilitar esta opción, 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 del token, GPG inicia el instalador sin el token (resguardo).

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 reutilizar los parámetros de inicialización varias veces?

    Esto es posible siempre y cuando 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, todos los procesos que inicia el juego deben finalizar cuando el usuario cierra el juego o este sale debido a una falla en la 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, se abrirá el cliente de Google Play Juegos antes de que se ejecute el juego o el selector. Debes administrar el juego o el selector 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, busca 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 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 que descargue e instale el cliente.

Prueba

  1. ¿Hay entornos de pruebas abiertas o cerradas similares a los de 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 al de 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 a 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 Google Play Juegos para PC no es compatible, recomendamos que usen una VPN para adquirir una dirección IP de una región compatible.

    Asegúrate de habilitar el modo TUN en la VPN. En el manual de funcionamiento del proveedor de VPN, se pueden 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 con fines de prueba.

  2. ¿Cómo puedo comenzar a desarrollar para Google Play Juegos para PC en Unity o en 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 la colmena raíz como HKEY_LOCAL_MACHINE o HKEY_CURRENT_USER según tu propósito y la naturaleza de los datos. La colmena HKEY_LOCAL_MACHINE se usa como ejemplo en los lineamientos.

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

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

  5. ¿Es necesario integrar todas las APIs?

    No se requieren otras APIs, pero ofrecen beneficios adicionales. Se requiere google::play::billing para las compras directas desde la app 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 que descarguen tu app. google::play::games::integrity es necesario para proteger tu app de los infractores, ya que detecta dispositivos potencialmente riesgosos y emuladores desconocidos.

  6. ¿Por qué se finalizan algunos procesos del juego cuando se cierra el cliente de Google Play Juegos y 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 de Android emulado o un juego para PC. Los juegos emulados se instalan en 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 función de desinstalación de Google Play Juegos o un desinstalador personalizado?

    Google recomienda usar nuestra función 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.