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.
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. 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
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.
- Vaya a Services.
- Asegúrese de que la pestaña Services está seleccionada.
- Seleccione su perfil u organización de Unity Services.
- Seleccione el botón Create.
- A continuación, vaya al servicio In-App Purchasing (IAP).
- Asegúrese de habilitar el Service, estableciendo el botón de alternancia Simplify cross-platform IAP.
- A continuación, seleccione el botón Continue.
- Seleccione el botón Import.
- Compruebe que los complementos están en su lugar.
- A continuación, cree un nuevo script llamado AndroidIAPExample.cs.
AndroidIAPExample.cs contendrá el código que se muestra a continuación (consulte los comentarios del código para obtener más explicaciones).
- Cree un nuevo objeto de Game llamado Code.
- Agréguele el componente
AndroidIAPExample(proceso de 2 pasos). - Agréguele el componente
AndroidIAPExample. - Asegúrese de guardar la escena.
- Compruebe que la escena se ha agregado al área Scenes In Build.
- Asegúrese de que la plataforma Android está seleccionada.
- Vaya al área Player Settings.
- Asigne su Package Name.
Asegúrese de crear su propio nombre de paquete para evitar colisiones en PlayMarket.
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.
- 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.
- Seleccione In-app products en el menú.
- Si se le pide una Merchant Account, vincule o cree una.
- Seleccione el botón Add New Product.
- En la pantalla que se muestra a continuación, seleccione Managed Product.
- Asígnele un Product ID descriptivo.
- Seleccione Continue.
- Desplácese más abajo y seleccione el botón Add a price.
- Escriba un precio válido (observe cómo el precio se convierte para cada país o región de forma independiente).
- Seleccione el botón Apply.
- Por último, vuelva a la parte superior de la pantalla y cambie el estado del elemento a Active.
- Vaya a Services & APIs en el menú.
- A continuación, busque y guarde la versión Base64 de la Key.
- Vaya a Home.
- Busque y seleccione Account details en el menú de la izquierda.
- Busque el área License Testing.
- Compruebe que sus Test Accounts están en la lista.
- Asegúrese de que License Test Response está establecido en RESPOND_NORMALLY.
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.- Seleccione Add-ons.
- A continuación, seleccione el complemento de Google.
- Rellene su Package ID.
- Rellene la Google App License Key que obtuvo en la sección anterior.
- Confirme los cambios seleccionando el botón Install Google.
- Seleccione Economy.
- Compruebe que la subpestaña Catalogs está seleccionada.
- Seleccione New Catalog.
- Proporcione un nombre de Catalog version.
- Seleccione Save Catalog.
- Seleccione el elemento para editar el Item ID de modo que coincida con el identificador de PlayMarket.
- 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.
- Asigne un Price a su Item.
- Seleccione Save Item para confirmar los cambios.
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.
- Observe su elemento en la lista Item ID.
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.
