As APIs do Economy v1 estão em modo de manutenção e não receberão novos recursos, apenas correções de bugs. As APIs v1 serão mantidas no futuro próximo. Confira a Visão geral do Economy v2 para saber mais sobre a próxima versão do PlayFab Economy!
O que é um catálogo?
Um catálogo é usado para definir itens que um jogador pode comprar ou que você pode conceder a um jogador. Muitos jogos oferecem ao jogador itens para compra, como um escudo, o desbloqueio de um nível ou um power-up. Esses itens são especificados em um catálogo e geralmente vendidos por moeda virtual ou dinheiro real. O catálogo do PlayFab oferece uma maneira fácil de gerenciar os itens virtuais do seu jogo e pode conter todos os itens disponíveis no seu jogo.Referências dos campos de item
Esta seção descreve cada campo na seção Catalog V2 da área Economy no Game Manager. Quando você cria um título pela primeira vez, seu catálogo está vazio. Você não verá nenhum item na seção Catalog até criá-los. As seguintes guias existem na seção Catalog v2:
Cada um deles é um tipo de item que pode ser usado no seu catálogo.
Campos de item do Catalog V2
Quando você seleciona Catalog V2, a guia Items e escolhe NEW ITEM, você verá a seguinte página:
- PROPERTIES
- Creator Entity Type: Um campo criado pelo sistema que informa o tipo do criador da entidade.
- Creator Entity ID: Uma ID exclusiva para o criador da entidade. No Game Manager, essa ID é definida como o valor do título.
- Friendly ID: Um campo que pode ser usado para facilitar a referência no código. As IDs amigáveis são opcionais para todos os itens e devem ser exclusivas dentro do catálogo.
- Title: Um campo obrigatório para o nome comum do item, que normalmente é exibido para o jogador. A localização simples de Title é compatível com o uso de chaves de localidade. Para obter mais informações, confira Localização do Economy V2.
- Default Stack ID: Os itens podem ser armazenados no inventário como pilhas, cada uma com sua própria quantidade e diferenciada por StackId. Se não for definido, as ações de inventário usarão default como StackId. Para obter mais informações, confira Pilhas do Economy.
- Keywords: As palavras-chave podem ser usadas para filtragem básica de pesquisa. Elas são um dicionário de palavras-chave localizadas em formato JSON. Para ver um exemplo, confira Localização do Economy V2.
- Description: Um dicionário de descrições de itens localizadas em formato JSON.
- Content Type: Você pode selecionar um tipo de conteúdo do item usando esta lista suspensa. Os tipos de conteúdo são definidos nas configurações do catálogo (Title Settings > Economy).
- Display Properties: Um blob JSON que você pode usar para propriedades personalizadas do item.
- Display Version: Um campo que você pode usar para controlar a versão das suas Display Properties.
- Tags: Este campo contém marcas que você pode usar para organizar seus itens de catálogo para pesquisa. As marcas podem ser inseridas como cadeias de texto delimitadas por vírgulas. Essas cadeias são predefinidas nas configurações do catálogo (Title Settings > Economy).
- Available Tags Lista suspensa prática para selecionar marcas de item já definidas na configuração do catálogo.
- OPTIONS
- Hidden: Atualmente, há uma única opção disponível para os itens listados nesta seção. Essa opção, Hidden, impede que o item seja exposto na pesquisa.
- Start Date: Um campo de data obrigatório que indica quando o item deve ser disponibilizado na pesquisa.
- End Date: Um campo de data para indicar quando o item deve ficar indisponível na pesquisa.
- PRICES
- Add New Price: Você pode usar esta seção para especificar um ou mais preços de compra para o item.
- FILES
- Upload: Aqui você pode carregar conteúdo a ser armazenado no catálogo público que pode ser associado a este item.
- IMAGES
- Upload: Aqui você pode carregar várias imagens, incluindo miniaturas e capturas de tela, para exibição de itens no catálogo do jogo.
- PLATFORMS
- Manage: Você pode especificar para quais plataformas este item se destina. A lista de plataformas é definida nas configurações do catálogo (Title Settings > Economy).
Salvando seus itens em um estado de rascunho ou publicado
O catálogo do Economy V2 oferece suporte a um estado de item Draft (rascunho). Quando você usa Save as Draft, os metadados do item ficam disponíveis por chamada direta, mas não são expostos na pesquisa pública. Quando estiver pronto para tornar seu item público, defina-o para um estado Published (publicado). Você pode ler mais sobre isso na nossa página Status do item.Exemplo de criação de item
Para criar um Item:- Abra o Game Manager e selecione Economy na barra lateral esquerda.
- Selecione a guia Catalogs V2.
- Selecione o botão NEW ITEM.
- Preencha os campos obrigatórios do item:
- Title (JSON, por ex. {“NEUTRAL”:“My New Amazing Item”}).
- Start Date (selecione a data de hoje).
- Preencha os campos obrigatórios do item:
- Selecione o botão SAVE AND PUBLISH, e você voltará para a página Items.
- Para adicionar mais itens, selecione NEW ITEM e repita as etapas 3 a 5.
Campos de moeda do Catalog V2
Quando você seleciona Catalog V2, abre a guia Currency e escolhe NEW CURRENCY, a página New Currency é aberta. As moedas contêm todos os mesmos campos dos Campos de item do Catalog V2.Campos de UGC do Catalog V2
Quando você seleciona Catalog V2, abre a guia UGC e escolhe NEW ITEM, a página New User Generated Content é aberta. O conteúdo gerado pelo usuário contém todos os mesmos campos dos Campos de item do Catalog V2, mais este campo:- MODERATION STATE
- Moderation State: Uma maneira fácil de marcar um item como Approved, Awaiting Moderation ou Rejected. O Moderation State só pode ser modificado em um item publicado.
Campos de pacote do Catalog V2
Quando você seleciona Catalog V2, abre a guia Bundles e escolhe NEW BUNDLE, a página New Bundle é aberta. Esta página contém todos os campos dos Campos de item do Catalog V2, mais estes campos:-
ITEMS
- Add: Os pacotes permitem agrupar vários itens em um único item. Você pode criar pacotes de itens que costumam ser comprados juntos ou de itens que estão disponíveis apenas por tempo limitado. Para obter mais informações, confira nossa documentação sobre Pacotes do Economy V2.
-
MARKETPLACE MAPPING
- Marketplace, Marketplace ID: Você pode vincular seu item do jogo a um ou mais itens de marketplace para cenários de resgate. Para obter mais informações, confira nossa documentação sobre Compras no aplicativo do Economy V2.
Campos de loja do Catalog V2
Quando você seleciona Catalog V2, abre a guia Stores e escolhe NEW STORE, a página New Store é aberta. As lojas contêm todos os mesmos campos dos Campos de item do Catalog V2, mais este campo:- ITEMS
- Add: As lojas podem conter qualquer outro tipo de item do catálogo. Todo o conteúdo do catálogo manterá seu custo base ou poderá ser comprado nesta loja pelos preços listados aqui. Para obter mais informações, confira nossa documentação sobre Lojas do Economy V2.