Colecciones

Economy v2 ya está disponible con carácter general. Para obtener soporte técnico y enviar comentarios, vaya al foro de PlayFab.

El servicio de inventario de Economy v2 introduce el concepto de colecciones, que puede agregar mayor flexibilidad y compatibilidad para sus necesidades de inventario. Las colecciones son el mecanismo que permite que un único jugador/PlayerId tenga varios inventarios. Esta característica se puede usar para administrar varios inventarios para diferentes personajes del mismo jugador, tener inventarios independientes para distintas plataformas, ¡y mucho más! Las llamadas a la API de inventario pueden aceptar un parámetro CollectionId que especifica la colección o el inventario en el que se realizará la acción. Para crear una colección nueva, se agrega un artículo o una pila a un CollectionId sin usar.

Administración de las colecciones de inventario

GetInventoryCollectionIds

Con la API GetInventoryCollectionIds, puede obtener una lista de CollectionId de un jugador determinado. Los jugadores solo pueden acceder a su propia lista de identificadores. Las entidades de título pueden pasar un parámetro Entity para indicar a qué inventario de jugador quieren acceder. Un ejemplo de solicitud GetInventoryCollectionIds:

{
  "Entity": {
    "Type": "title_player_account",
    "Id": "ABCD12345678"
  },
  "Count": 15,
  "ContinuationToken": "abc="
}

Esta solicitud devolvería la siguiente respuesta:

{
  "data": {
  "CollectionIds": [
    "default",
    "main_character"
    ]
  }
}

Tokens de continuación

El campo ContinuationToken que se devuelve en una respuesta de búsqueda se puede pasar en una solicitud de inventario para paginar entre varios conjuntos de resultados.

Adición de una nueva colección de inventario

Para crear una colección nueva para un jugador, se realiza cualquier solicitud de escritura con un CollectionId nuevo. Por ejemplo, la siguiente solicitud AddInventoryItems usa el collectionId main_character

{
    "Entity": {
        "Type": "title_player_account",
        "Id": "ABCD12345678"
    },
    "CollectionId": "main_character",
    "Item": {
        "Id": "0b440353-bdbc-48d8-8873-f0988c1f9d8b",
    },
    "Amount": 10,
}

La solicitud anterior crearía una colección de inventario completamente nueva y agregaría 10 unidades del artículo, o bien agregaría 10 a la colección de inventario main_character existente si ya existiera.

DeleteInventoryCollection

En la API DeleteInventoryCollectionId, puede definir el CollectionId que quiere eliminar. La eliminación es una operación asincrónica y puede tardar más en el caso de colecciones grandes. La colección no se podrá volver a crear hasta que se complete la operación de eliminación. Un ejemplo de solicitud DeleteInventoryCollectionIds:

{
  "Entity": {
    "Type": "title_player_account",
    "Id": "ABCD12345678"
  },
  "CollectionId": "main_character"
}

Actualmente, las API son la única forma de eliminar colecciones de inventario. Por ahora, Game Manager solo se puede usar para ver y agregar artículos a colecciones nuevas y existentes. En el futuro se agregará más funcionalidad.

API ExecuteInventoryOperations

Puede establecer un parámetro CollectionId en la API ExecuteInventoryOperations. Este parámetro le permite definir la colección en la que quiere que se realicen las operaciones. Un ejemplo de solicitud ExecuteInventoryOperations con pilas:

{
    "Entity": {
        "Type": "title_player_account",
        "Id": "ABCD12345678"
    },
    "CollectionId": "main_character",
    "Operations": [
        {
            "Update": {
                "Item" {
                    "Id": "0b440353-bdbc-48d8-8873-f0988c1f9d8b",
                    "Amount": 10
                }
            }
        },
        {
            "Subtract": {
                "Item" {
                    "Id": "0b440353-bdbc-48d8-8873-f0988c1f9d8b",
                },
                "Amount": 5
            }
        }
    ]
}

XBOX Services

PlayFab

Colecciones de inventario

Colecciones

Administración de las colecciones de inventario

GetInventoryCollectionIds

Tokens de continuación

Adición de una nueva colección de inventario

DeleteInventoryCollection

API ExecuteInventoryOperations

​Colecciones

​Administración de las colecciones de inventario

​GetInventoryCollectionIds

​Tokens de continuación

​Adición de una nueva colección de inventario

​DeleteInventoryCollection

​API ExecuteInventoryOperations

Colecciones

Administración de las colecciones de inventario

GetInventoryCollectionIds

Tokens de continuación

Adición de una nueva colección de inventario

DeleteInventoryCollection

API ExecuteInventoryOperations