Integração com PlayFab

Como funciona

Aviso
Suportado pela PlayFab API versão: Economy v1.
A PlayFab oferece aos desenvolvedores de jogos soluções de servidor prontas para uso para gerenciar o catálogo de itens e a monetização. Após a integração com o PlayFab, você pode:

Quem pode usar

  • Parceiros que integraram a PlayFab e agora querem aumentar a área de distribuição de itens (moedas virtuais e itens virtuais) via soluções Xsolla.
  • Parceiros que integraram soluções Xsolla e agora querem monetizar seus itens na PlayFab (vender itens por moeda real).

Regras de importação

Ao importar itens da PlayFab, a seguinte lógica se aplica:

  • Bens duráveis da PlayFab são importados como itens virtuais (não moedas virtuais nem conjuntos).
  • Todos os itens, bem como quaisquer pacotes de moedas virutais e itens dentro de um conjunto PlayFab, são importados como consumíveis (parâmetro consumable = true ou não especificado).
  • A moeda virtual é importada com o status Parcialmente disponível e sem um preço especificado (API flags: is_show_in_store = false, is_enabled = true, is_free = true).
  • Um conjunto contendo apenas um tipo de moeda virtual é importado como um pacote de moedas virtuais.
  • Um conjunto contendo múltiplos tipos de moedas virtuais é importado como pacotes de moedas virtuais separados. Para cada combinação única de SKU e quantidade, é criado um pacote de moedas virtuais grátis com o status Parcialmente disponível (API flags: is_show_in_store = false, is_enabled = true, is_free = true).
  • Um conjunto contendo diferentes tipos de itens é importado como um conjunto.
  • Se o campo Description de um item não for preenchido no PlayFab, o campo Name será usado como a descrição do item; se não houver Name, o SKU será usado.

Limitações de importação

Limitações da In-Game Store

  • Contêineres e conjuntos que possuam contêineres não são importados.
  • DropTables e conjuntos contendo DropTables não são importados.
  • Parâmetros específicos à PlayFab, tais como isStackable, isTradable, UsageCount, UsagePeriod, UsagePeriodGroup são ignorados.
  • Itens consumíveis são criados sem considerar a quantidade (o item desaparece do inventário após o primeiro uso).

Limitações da PlayFab

  • PlayFab não armazena preços em moedas reais. Só são utilizadas moedas virtuais pré-configuradas e codificadas como RM (Dinheiro real), equivalentes a uma moeda real—1 centavo (100 RM = 1 USD). Portanto, Preços de itens só podem ser definidos em moedas virtuais ou RM.
  • SKUs de itens devem ser únicos e consistir de números, letras latinas, hifens e sublinhados.

Como obtê-lo

Como importar o catálogo do PlayFab

Observação
Você precisará de um ID de projeto e uma chave secreta de projeto no PlayFab. Além disso, o catálogo que você quiser importar à Xsolla deve ser configurado no PlayFab como básico (Base).

Se você ainda não configurou o PlayFab, faça o seguinte:

Acesse a Conta de Distribuidor e importe o catálogo de itens do PlayFab para a In-Game Store.

Observação
Você pode importar itens virtuais, moedas virtuais ou pacotes de moedas virtuais.

  1. Abra seu projeto na Publisher Account e vá para Store > Catalog management > Integration with external platforms > PlayFab.
  2. Na aba Importação de itens especifique:
  3. Clique em Save.
  4. Sincronize o inventário do usuário com o PlayFab (opcional):
    1. Vá para Inventory synchronization e especifique:
    2. Defina a configuração Synchronize user inventory with PlayFab como On.
    3. Clique em Save.
  5. Vá para a aba Item import e clique em Start import. A importação do catálogo será iniciada automaticamente.
  6. Para vender itens virtuais na loja virtual criada pelo Site Builder, configure grupos de itens na Publisher Account e atribua um ou mais deles a cada item.
  7. Para exibir imagens de itens, envie-as à sua Publisher Account.

Para verificar se a importação foi concluída com sucesso, vá para a seção Store no menu lateral e verifique se os itens, a moeda e os pacotes estão habilitados nas abas Virtual currency, Virtual items e Bundles.

Aviso
Ao verificar os resultados da importação, considere que um pacote de moeda virtual é um pacote contendo apenas um tipo de moeda. PlayFab usa a moeda virtual RM (Real Money, dinheiro real em inglês) que é equivalente à moeda real - 1 centavo (100 RM = 1 USD). Por exemplo, se você importar 400 RM do PlayFab, você verá 4 USD em sua Conta de Distribuidor.

Reimportação de catálogo

Ao reimportar o catálogo, você precisa considerar que:
  • Os itens que já estão na Store serão atualizados.
  • Os itens que não estão disponíveis na Store serão adicionados.
  • Os itens que já foram removidos da fonte de importação permanecerão na Store. Você pode excluí-los em sua Conta de Distribuidor ou via API.

Adicione itens ao inventário PlayFab

Você pode configurar a adição de itens comprados na Xsolla In-Game Store ao seu inventário do PlayFab das seguintes maneiras:
Observação
O Playfab permite que você não defina o nome ou a descrição do produto. Nesse caso, uma cadeia de caracteres vazia é retornada nas chamadas de API.

Se você quiser sincronizar o inventário do usuário com o PlayFab:

  1. Abra sua Conta de Distribuidor e vá para Store > Catalog management > Integration with external platforms > PlayFab.
  2. Vá para a sincronização de inventário e especifique:
  3. Defina a opção Synchronize user inventory with PlayFab como On.
  4. Clique em Save.

Agora, as informações sobre itens comprados na In-Game Store são automaticamente transferidas para o PlayFab.

Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Última atualização: 27 de Dezembro de 2024

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!