Coleções

O Economy v2 agora está em disponibilidade geral. Para obter suporte e enviar comentários, acesse o Fórum do PlayFab.

O serviço de Inventário do Economy v2 introduz o conceito de coleções, que podem oferecer mais flexibilidade e suporte às suas necessidades de inventário. As coleções são o mecanismo que permite que um único jogador/PlayerId tenha vários inventários. Esse recurso pode ser usado para gerenciar vários inventários para diferentes personagens do mesmo jogador, ter inventários separados para diferentes plataformas e muito mais! As chamadas da API de Inventário podem receber um parâmetro CollectionId que especifica a coleção/inventário em que a ação será executada. A criação de uma nova coleção é feita adicionando um item/pilha a um CollectionId não utilizado.

Gerenciar coleções do inventário

GetInventoryCollectionIds

Usando a API GetInventoryCollectionIds, você pode obter uma lista de CollectionIds de um determinado jogador. Os jogadores só podem acessar a própria lista de IDs. As entidades de título podem passar um parâmetro Entity para indicar qual inventário de jogador desejam acessar. Um exemplo de solicitação GetInventoryCollectionIds:

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

Essa solicitação retornaria a seguinte resposta:

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

Tokens de continuação

O campo ContinuationToken retornado em uma resposta de pesquisa pode ser passado para uma solicitação de inventário para paginar por vários conjuntos de resultados.

Adicionar uma nova coleção do inventário

A criação de uma nova coleção para um jogador é feita executando qualquer solicitação de gravação com um novo CollectionId. Por exemplo, a seguinte solicitação AddInventoryItems usa o collectionId main_character

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

A solicitação acima criaria uma coleção de inventário totalmente nova e adicionaria 10 unidades do item a ela, ou adicionaria 10 à coleção de inventário main_character existente, caso ela já existisse.

DeleteInventoryCollection

Na API DeleteInventoryCollectionId, você pode definir o CollectionId que deseja excluir. A exclusão é uma operação assíncrona e pode demorar mais para coleções grandes. A coleção não poderá ser recriada até que a operação de exclusão seja concluída. Um exemplo de solicitação DeleteInventoryCollectionIds:

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

Atualmente, as APIs são a única forma de excluir Coleções do Inventário. No momento, o Game Manager só pode ser usado para visualizar e adicionar itens a coleções novas e existentes. Funcionalidades adicionais serão adicionadas no futuro.

API ExecuteInventoryOperations

Você pode definir um parâmetro CollectionId na API ExecuteInventoryOperations. Esse parâmetro permite definir a coleção em que você deseja que as operações sejam executadas. Um exemplo de solicitação ExecuteInventoryOperations com pilhas:

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

​Coleções

​Gerenciar coleções do inventário

​GetInventoryCollectionIds

​Tokens de continuação

​Adicionar uma nova coleção do inventário

​DeleteInventoryCollection

​API ExecuteInventoryOperations

Coleções

Gerenciar coleções do inventário

GetInventoryCollectionIds

Tokens de continuação

Adicionar uma nova coleção do inventário

DeleteInventoryCollection

API ExecuteInventoryOperations