Inicio rápido: Adición del primer artículo al inventario de un jugador
Economy v2 ya está disponible con carácter general. Para obtener soporte técnico y enviar comentarios, vaya al foro de PlayFab.
Requisitos previos
- Una cuenta de desarrollador de PlayFab
- El SDK beta de PlayFab (puede encontrar más información en la guía de inicio rápido de Postman)
- Al menos un artículo en el catálogo (puede encontrar más información en la guía de inicio rápido de Economy v2)
- Al menos un jugador con suficiente moneda virtual para comprar un artículo
Inicio de sesión como el jugador
Primero debe iniciar la sesión del jugador para recibir el token de seguridad necesario para el resto de las llamadas a la API de esta guía de inicio rápido. Puede encontrar más información en la página de autenticación de jugadores.Búsqueda del artículo
Para encontrar el artículo en el catálogo, llame aSearch. En el cuerpo de la llamada:
Searches la cadena de búsqueda con la que se realiza una búsqueda aproximada en el título, la descripción y las palabras clave de cada artículo del catálogoTopes un entero que determina cuántos resultados se devuelven; en este caso, solo necesitamos uno
Hay más campos sobre los que puede obtener información en la guía de inicio rápido de búsqueda.
Items>Id: identificador de catálogo del artículoItems>PriceOptions>Prices>Amounts>ItemId: identificador de la moneda virtual usada para comprar el artículoItems>PriceOptions>Prices>Amounts>Amount: cantidad de la moneda virtual necesaria para comprar el artículo
Solo las entidades de título pueden establecer precios para los artículos.
Compra del artículo
Para comprar el artículo, llame aPurchaseInventoryItems. En el cuerpo de la llamada:
Item.Ides el identificador del artículo (obtenido de la respuesta deSearchen el paso anterior)Amountes el número de artículos que el jugador está comprandoItemIdes el identificador de la moneda virtual usada para comprar el artículo (obtenido de la respuesta deSearchen el paso anterior)Amountes la cantidad de la moneda virtual necesaria para comprar el artículo (obtenida de la respuesta deSearchen el paso anterior)
Obtención de los artículos del inventario del jugador
Vea el artículo recién comprado del jugador medianteGetInventoryItems. En la llamada, asegúrese de que el cuerpo esté vacío: puede especificar la entidad en el cuerpo, pero no es necesario, ya que la información ya se pasa a través del token de entidad en el encabezado.
La respuesta contiene los identificadores de cada artículo que posee el jugador y la cantidad de cada artículo. El artículo recién comprado está en el inventario del jugador.
Si el jugador ya tiene ese artículo en su inventario con el mismo
StackId, no verá otra instancia del artículo después de la compra; en su lugar, verá que el campo Amount aumenta.Solución de problemas
- Fondos insuficientes
- Si llama a
PurchaseInventoryItemsy recibe un error422: InsufficientFunds, el jugador no tiene suficiente moneda virtual para comprar el artículo. Puede conceder moneda virtual al jugador llamando aAddInventoryItems(requiere un token de entidad de título) o yendo a [Title] > Players > [Player] >Inventory (V2)en Game Manager.
- Si llama a
- El artículo no se puede comprar al precio especificado.
- Si llama a
PurchaseInventoryItemsy recibe un código de error1071, el campoPriceAmountsno coincide con los precios especificados en el catálogo.
- Si llama a
Pasos siguientes
Ahora que ha comprado el primer artículo del jugador, puede consumir el artículo, agregarlo a una tienda para ponerlo a la venta, y crear y comprar un paquete que contenga el artículo.[!div class=“nextstepaction”] Tutorial de inventario del jugador
[!div class=“nextstepaction”] Tiendas
[!div class=“nextstepaction”] Paquetes
