Economy v2 ya está disponible con carácter general. Para obtener soporte técnico y enviar comentarios, vaya al foro de PlayFab.
Requisitos previos
La guía de inicio rápido de PlayFab Economy v2 le dejará todo configurado y listo para realizar la validación de recibos.Validación de recibos del marketplace de Microsoft Store
Para usar la API de canje, empiece por configurar los identificadores de producto y los precios en el marketplace que use (Apple Store, Steam, Google Play, etc.). Inicialmente, todos los productos son anónimos: entradas digitales que el jugador puede comprar, pero que no tienen ningún significado en PlayFab. Para dar significado a esas entradas, necesitamos reflejarlas en el catálogo de PlayFab. Al reflejarlas, esas entidades anónimas se convertirán en paquetes de catálogo. Cuando llame aRedeemMicrosoftStoreInventoryItems en el nuevo servicio, buscamos un paquete coincidente en el catálogo para concederlo al inventario virtual del jugador de entidad.
Cada paquete se puede vincular a uno o varios productos de marketplaces asociados agregándole un AlternateId. El AlternateId es el vínculo entre PlayFab y cualquier mercado de compras dentro de la aplicación (IAP) externo. Cuando el título llama a Redeem para una entidad de jugador determinada, pasamos este identificador al mercado de IAP para su comprobación. El flujo general es el siguiente:
- Cree una (o varias) ofertas del mundo real en Microsoft Store
- Rellene los complementos en PlayFab con los permisos de llamada al mercado de IAP y cree los paquetes correspondientes en PlayFab que se vinculen a las ofertas que creó
- Llame a
RedeemMicrosoftStoreInventoryItems
A diferencia de las versiones anteriores de PlayFab, en el nuevo sistema solo crea una oferta de paquete y, a continuación, agrega cada SKU de mercado que deba referenciarse a la lista de AlternateId. No es necesario crear un artículo nuevo para cada mercado de IAP.
Paso 1: Configuración de la integración con el marketplace
Debe configurar cada integración con un mercado de IAP en GameManager, en la sección Add-ons, para permitir que PlayFab llame al mercado en nombre del título.Paso 2: Creación de un paquete para la validación de recibos
Puede crear un paquete desde GameManager o llamando aCreateDraftItem. Como mínimo, un paquete requiere un título, una descripción y artículos. En GameManager, puede vincular las entradas del marketplace mediante la sección Marketplace Mapping.
Si crea el paquete mediante la API, debe agregar las asignaciones del marketplace de IAP en la sección alternateIds de un paquete. Las enumeraciones de marketplace son específicas y distinguen mayúsculas de minúsculas; debe usar uno de los siguientes complementos:
- Apple = “AppleAppStore”
- Google Play = “GooglePlay”
- Nintendo = “NintendoEShop”
- Microsoft = “MicrosoftStore”
- PlayStation = “PlayStationStore”
- Steam = “Steam”
Paso 3: Llamada a Redeem desde el juego
El juego llama a la APIRedeemMicrosoftStoreInventoryItems con los detalles de la entidad y del recibo para “canjear” la oferta del mundo real y rellenar el inventario de entidad correspondiente. Debe proporcionar algunos elementos en la llamada para que funcione correctamente:
- Obligatorio en el encabezado de la solicitud
- X-EntityToken: el token que identifica de forma única una entidad de PlayFab
- Content-Type: Application/Json
- Obligatorio en el cuerpo de la solicitud
CollectionsIdKey
Parte 4: Compra de un artículo
Game Manager
Puede comprobar que los artículos o las monedas existen en las vistas individuales de jugador. En GameManager, seleccione Players y vaya a una entidad de jugador individual. Use las pestañas de inventario para ver y actualizar lo que posee ese jugador de entidad.API
En el juego, inicie sesión como un jugador al que se le haya concedido moneda virtual. Llame aSearchItems para usar un itemId de catálogo publicado anteriormente.
Llame a PurchaseInventoryItems con el itemId del artículo de catálogo y el identificador de la moneda virtual concedida.
Por último, llame a GetInventoryItems y vea el resultado de ese método.
Puede obtener más información sobre la monetización en la plataforma de Microsoft aquí.