Collections

Economy v2 est désormais en disponibilité générale. Pour obtenir de l’aide et donner votre avis, rendez-vous sur le forum PlayFab.

Le service Inventory d’Economy v2 introduit le concept de collections, qui offre davantage de flexibilité et de prise en charge pour vos besoins en matière d’inventaire. Les collections sont le mécanisme qui permet à un même joueur/PlayerId de disposer de plusieurs inventaires. Cette fonctionnalité peut servir à gérer plusieurs inventaires pour différents personnages d’un même joueur, à disposer d’inventaires distincts pour différentes plateformes, et bien plus encore ! Les appels d’API Inventory peuvent accepter un paramètre CollectionId qui spécifie la collection/l’inventaire dans lequel effectuer l’action. Pour créer une collection, il suffit d’ajouter un article/une pile à un CollectionId inutilisé.

Gestion des collections d’inventaire

GetInventoryCollectionIds

L’API GetInventoryCollectionIds vous permet d’obtenir la liste des CollectionId d’un joueur donné. Les joueurs ne peuvent accéder qu’à leur propre liste d’ID. Les entités de titre peuvent transmettre un paramètre Entity pour indiquer à quel inventaire de joueur elles souhaitent accéder. Exemple de requête GetInventoryCollectionIds :

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

Cette requête retourne la réponse suivante :

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

Jetons de continuation

Le champ ContinuationToken retourné dans une réponse de recherche peut être transmis dans une requête d’inventaire pour parcourir plusieurs pages de résultats.

Ajout d’une nouvelle collection d’inventaire

Pour créer une nouvelle collection pour un joueur, il suffit d’effectuer n’importe quelle requête d’écriture avec un nouveau CollectionId. Par exemple, la requête AddInventoryItems suivante utilise le collectionId main_character

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

La requête ci-dessus crée une toute nouvelle collection d’inventaire et y ajoute 10 exemplaires de l’article, ou ajoute 10 exemplaires à la collection d’inventaire main_character existante si elle existe déjà.

DeleteInventoryCollection

Dans l’API DeleteInventoryCollectionId, vous pouvez définir le CollectionId que vous souhaitez supprimer. La suppression est une opération asynchrone qui peut prendre plus de temps pour les collections volumineuses. La collection ne peut pas être recréée tant que l’opération de suppression n’est pas terminée. Exemple de requête DeleteInventoryCollectionIds :

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

Actuellement, les API sont le seul moyen de supprimer des collections d’inventaire. Game Manager ne peut actuellement servir qu’à afficher des collections nouvelles et existantes et à y ajouter des articles. D’autres fonctionnalités seront ajoutées à l’avenir.

API ExecuteInventoryOperations

Vous pouvez définir un paramètre CollectionId dans l’API ExecuteInventoryOperations. Ce paramètre vous permet de définir la collection dans laquelle vous souhaitez que les opérations soient effectuées. Exemple de requête ExecuteInventoryOperations avec des piles :

{
    "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
            }
        }
    ]
}

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Collections d'inventaire

Collections

Gestion des collections d’inventaire

GetInventoryCollectionIds

Jetons de continuation

Ajout d’une nouvelle collection d’inventaire

DeleteInventoryCollection

API ExecuteInventoryOperations

​Collections

​Gestion des collections d’inventaire

​GetInventoryCollectionIds

​Jetons de continuation

​Ajout d’une nouvelle collection d’inventaire

​DeleteInventoryCollection

​API ExecuteInventoryOperations

Collections

Gestion des collections d’inventaire

GetInventoryCollectionIds

Jetons de continuation

Ajout d’une nouvelle collection d’inventaire

DeleteInventoryCollection

API ExecuteInventoryOperations