Skip to main content

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.
Familiarícese con los inventarios de jugador usando el SDK beta de PlayFab para comprar un artículo y comprobar que se agregó al inventario de su jugador. Después de obtener un token de entidad para interactuar con el título mediante las API, buscará un artículo en el catálogo, lo comprará y, a continuación, obtendrá el inventario del jugador para encontrar el artículo comprado.

Requisitos previos

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 a Search. En el cuerpo de la llamada:
  • Search es 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álogo
  • Top es 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.
En la respuesta, tome los campos siguientes:
  • Items > Id: identificador de catálogo del artículo
  • Items > PriceOptions > Prices > Amounts > ItemId: identificador de la moneda virtual usada para comprar el artículo
  • Items > 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 a PurchaseInventoryItems. En el cuerpo de la llamada:
  • Item.Id es el identificador del artículo (obtenido de la respuesta de Search en el paso anterior)
  • Amount es el número de artículos que el jugador está comprando
  • ItemId es el identificador de la moneda virtual usada para comprar el artículo (obtenido de la respuesta de Search en el paso anterior)
  • Amount es la cantidad de la moneda virtual necesaria para comprar el artículo (obtenida de la respuesta de Search en el paso anterior)

Obtención de los artículos del inventario del jugador

Vea el artículo recién comprado del jugador mediante GetInventoryItems. 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 PurchaseInventoryItems y recibe un error 422: InsufficientFunds, el jugador no tiene suficiente moneda virtual para comprar el artículo. Puede conceder moneda virtual al jugador llamando a AddInventoryItems (requiere un token de entidad de título) o yendo a [Title] > Players > [Player] > Inventory (V2) en Game Manager.
  • El artículo no se puede comprar al precio especificado.
    • Si llama a PurchaseInventoryItems y recibe un código de error 1071, el campo PriceAmounts no coincide con los precios especificados en el catálogo.

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
Última modificación el 28 de agosto de 2026