Saltar al contenido principal

Introducción a PlayFab (Economy heredado), Unity IAP y Android

Las API de Economy v1 están en modo de mantenimiento y no recibirán nuevas características, solo correcciones de errores. Las API v1 se mantendrán en el futuro previsible. Consulte la información general de Economy v2 para obtener más información sobre la próxima versión de PlayFab Economy.
Este tutorial le muestra cómo configurar las compras desde la aplicación (IAP) mediante PlayFab, el servicio Unity + IAP y la API de facturación de Android.

Antes de empezar

Configurar IAP puede ser tedioso, especialmente si no está seguro de cómo se supone que los distintos servicios se integran y cooperan. La imagen siguiente ilustra cómo la API de facturación de Android y PlayFab funcionan conjuntamente para proporcionar una experiencia de IAP sólida a su cliente. Facturación de Android - PlayFab - cronología de la integración Empiece por configurar sus Product IDs y Prices a través de PlayMarket. Inicialmente, todos los productos carecen de identidad: son entidades digitales que el jugador puede comprar, pero no tienen ningún significado para los jugadores de PlayFab. Para que esas entidades sean útiles, es necesario reflejarlas en los catálogos de elementos de PlayFab. Esto convierte las entidades sin identidad en lotes, contenedores y elementos individuales. Cada uno tiene su propia identidad única, con:
  • Títulos
  • Descripciones
  • Etiquetas
  • Tipos
  • Imágenes
  • Comportamientos
Todos ellos están vinculados a los productos del mercado mediante identificadores compartidos. La mejor manera de acceder a los elementos con dinero real disponibles para su compra es usar GetCatalogItems y GetStoreItems. Estos son los mismos métodos de API que usan las tiendas de moneda gratuita, por lo que el proceso debería resultarle familiar. El identificador del elemento es el vínculo entre PlayFab y cualquier sistema de IAP externo. Por lo tanto, pasamos el identificador del elemento al servicio de IAP. En este punto, comienza el proceso de compra. El jugador interactúa con la interfaz de IAP y, si la compra se realiza correctamente, usted obtiene un recibo. A continuación, PlayFab puede validar el recibo y registrar la compra, concediendo al jugador de PlayFab los elementos que acaba de comprar. Esta es una idea aproximada de cómo funciona la integración de IAP, y el ejemplo siguiente muestra la mayor parte en acción.

Configuración de una aplicación cliente

En esta sección se muestra cómo configurar una aplicación muy básica para probar IAP mediante PlayFab, UnityIAP y la API de facturación de Android. Requisitos previos:
  • Un proyecto de Unity.
  • El SDK de PlayFab importado y configurado para funcionar con su título.
Nuestro primer paso es configurar UnityIAP:
  1. Vaya a Services.
  2. Asegúrese de que la pestaña Services está seleccionada.
  3. Seleccione su perfil u organización de Unity Services.
  4. Seleccione el botón Create.
Configuración del servicio UnityIAP
  1. A continuación, vaya al servicio In-App Purchasing (IAP).
Ir al servicio UnityIAP
  1. Asegúrese de habilitar el Service, estableciendo el botón de alternancia Simplify cross-platform IAP.
  2. A continuación, seleccione el botón Continue.
Habilitar el servicio UnityIAP Aparecerá una página con una lista de complementos.
  1. Seleccione el botón Import.
Servicio UnityIAP - Importar complementos Continúe con la instalación de Unity y el procedimiento de importación hasta el punto en que haya importado todos los complementos.
  1. Compruebe que los complementos están en su lugar.
  2. A continuación, cree un nuevo script llamado AndroidIAPExample.cs.
UnityIAP - Crear nuevo script AndroidIAPExample.cs contendrá el código que se muestra a continuación (consulte los comentarios del código para obtener más explicaciones).
  1. Cree un nuevo objeto de Game llamado Code.
  2. Agréguele el componente AndroidIAPExample (proceso de 2 pasos).
  3. Agréguele el componente AndroidIAPExample.
  4. Asegúrese de guardar la escena.
UnityIAP - Crear objeto de juego de ejemplo Por último, vaya a Build Settings.
  1. Compruebe que la escena se ha agregado al área Scenes In Build.
  2. Asegúrese de que la plataforma Android está seleccionada.
  3. Vaya al área Player Settings.
  4. Asigne su Package Name.
Asegúrese de crear su propio nombre de paquete para evitar colisiones en PlayMarket.
UnityIAP - Agregar objeto de juego de ejemplo Por último, compile la aplicación como de costumbre y asegúrese de tener un APK a buen recaudo. Todavía no tenemos medios para probarlo. Primero es necesario configurar PlayMarket y PlayFab, lo que se describe en las secciones siguientes.

Configuración de una aplicación de PlayMarket para IAP

En esta sección se describen los detalles de cómo habilitar IAP para su aplicación de PlayMarket.
La configuración de la aplicación en sí queda fuera del ámbito de este tutorial. Suponemos que ya tiene una aplicación y que está configurada para publicar al menos versiones Alpha.
Habilitar la aplicación de PlayMarket Notas útiles:
  • Para llegar a ese punto será necesario que tenga un APK cargado. Use el APK que construimos en la sección anterior.
  • Cuando se le pida cargar el APK, puede cargarlo como aplicación Alpha o Beta para habilitar el sandbox de IAP.
  • La configuración de Content Rating incluirá preguntas sobre cómo está habilitado IAP en la aplicación.
  • PlayMarket no permite a los publicadores usar ni probar IAP, así que elija otra cuenta de Google para las pruebas y agréguela como evaluador de su compilación Alpha/Beta.
Una vez que tenga publicada la compilación de la aplicación:
  1. Seleccione In-app products en el menú.
    • Si se le pide una Merchant Account, vincule o cree una.
  2. Seleccione el botón Add New Product.
PlayMarket - Agregar nuevo producto
  1. En la pantalla que se muestra a continuación, seleccione Managed Product.
  2. Asígnele un Product ID descriptivo.
  3. Seleccione Continue.
PlayMarket - Agregar identificador de producto PlayMarket requiere que rellene un Title (1) y una Description (2). Sin embargo, en nuestro caso no son de mucha utilidad. Tomaremos los datos del Data Item exclusivamente del servicio de PlayFab, y solo es necesario que los identificadores coincidan. PlayMarket - Agregar título y descripción del producto
  1. Desplácese más abajo y seleccione el botón Add a price.
PlayMarket - Agregar precio del producto
  1. Escriba un precio válido (observe cómo el precio se convierte para cada país o región de forma independiente).
  2. Seleccione el botón Apply.
PlayMarket - Agregar producto y aplicar precios locales
  1. Por último, vuelva a la parte superior de la pantalla y cambie el estado del elemento a Active.
PlayMarket - Activar el producto Aunque esto concluye la configuración de la aplicación, necesitamos un par de ajustes más. En primer lugar, guardemos la Licensing Key (resultará útil para vincular PlayFab con PlayMarket).
  1. Vaya a Services & APIs en el menú.
  2. A continuación, busque y guarde la versión Base64 de la Key.
PlayMarket - Guardar la clave de licencia del producto El paso siguiente es habilitar las pruebas de IAP. Aunque el sandbox se habilita automáticamente para las compilaciones Alpha y Beta, es necesario configurar las cuentas autorizadas para probar la aplicación:
  1. Vaya a Home.
  2. Busque y seleccione Account details en el menú de la izquierda.
  3. Busque el área License Testing.
  4. Compruebe que sus Test Accounts están en la lista.
  5. Asegúrese de que License Test Response está establecido en RESPOND_NORMALLY.
No olvide aplicar la configuración. PlayMarket - Habilitar las pruebas de IAP En este punto, la parte de Play Market de la integración debería estar configurada.

Configuración de un título de PlayFab

Nuestro último paso es configurar un título de PlayFab para reflejar nuestros productos e integrarlo con la API de facturación de Google.
  1. Seleccione Add-ons.
  2. A continuación, seleccione el complemento de Google.
PlayFab - Abrir el complemento de Google
  1. Rellene su Package ID.
  2. Rellene la Google App License Key que obtuvo en la sección anterior.
  3. Confirme los cambios seleccionando el botón Install Google.  PlayFab - Instalar el complemento de Google
El paso siguiente es reflejar nuestro elemento Golden Sword en PlayFab:
  1. Seleccione Economy.
  2. Compruebe que la subpestaña Catalogs está seleccionada.
  3. Seleccione New Catalog.
  4. Proporcione un nombre de Catalog version.
  5. Seleccione Save Catalog.
PlayFab - Guardar catálogo Si el catálogo no tiene elementos, se quita automáticamente. Por eso, cualquier catálogo nuevo incluye un elemento agregado previamente llamado One. Siempre podemos crear un elemento nuevo, pero para mantener las cosas ordenadas, modifiquemos el elemento One existente.
  1. Seleccione el elemento para editar el Item ID de modo que coincida con el identificador de PlayMarket.
  2. Ahora, edite el Display name y agregue una Description.
Tenga en cuenta que estos datos no tienen nada que ver con el Play Market Item Title y la Description: son totalmente independientes.
  1. Asigne un Price a su Item.
  2. Seleccione Save Item para confirmar los cambios.
PlayFab - Editar y guardar el elemento del catálogo
En este tutorial, IAP se refiere principalmente a las compras con dinero real. Por eso usamos RM, la moneda especial de dinero real. El importe de PlayFab se define en centavos de dólar estadounidense.
  1. Observe su elemento en la lista Item ID.
PlayFab - Lista de elementos del catálogo Esto concluye la configuración de su título de PlayFab.

Pruebas

Para las pruebas, descargue la aplicación mediante la versión Alpha/Beta.
  • Asegúrese de usar una cuenta de prueba y un dispositivo Android real.
  • Una vez que inicie la aplicación, debería ver IAP inicializado y un botón que representa su elemento.
  • Seleccione ese botón.
Aplicación de prueba - botón Buy Golden Sword Se iniciará la compra de IAP. Siga las instrucciones de Google Play hasta el punto en que la compra se realice correctamente. Aplicación de prueba - Google Play - pago correcto Por último, vaya a su título en el panel de Game Manager de PlayFab y busque New Events. Nuevos eventos en el panel de Game Manager Esto significa que la compra se proporcionó, se validó y se canalizó correctamente al ecosistema de PlayFab. En este punto, ha integrado correctamente UnityIAP y la API de facturación de Android en su aplicación de PlayFab.
Última modificación el 20 de octubre de 2026