Integração com PlayFab
Como funciona
Aviso
Suportado pela PlayFab API versão: Economy v1 .
- Importe um catálogo PlayFab à In-Game Store para usar as soluções Xsolla.
- Transferência automática de itens que um usuário compra através da In-Game Store para o PlayFab.
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:
- Crie sua conta do PlayFab.
- Crie seu jogo.
- Obtenha o seu Title ID de jogo exclusivo.
- Obtenha sua chave secreta do PlayFab.
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.
- Abra seu projeto na Publisher Account e vá para Store > Catalog management > Integration with external platforms > PlayFab.
- Na aba Importação de itens especifique:
- Title ID — ID do projeto no PlayFab.
- Secret key — a chave do projeto no PlayFab.
- Clique em Save.
- Sincronize o inventário do usuário com o PlayFab (opcional):
- Vá para Inventory synchronization e especifique:
- Title ID — ID do projeto no PlayFab.
- Secret key — a chave do projeto no PlayFab.
- Defina a configuração Synchronize user inventory with PlayFab como On.
- Clique em Save.
- Vá para Inventory synchronization e especifique:
- Vá para a aba Item import e clique em Start import. A importação do catálogo será iniciada automaticamente.
- 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.
- 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:- Sincronizando o inventário do usuário com o PlayFab.
- Integrando o armazenamento PlayFab com o Xsolla Login. Nesse caso, o PlayFab ID especificado no token. No caso de uma devolução de itens no lado Xsolla, uma solicitação é enviada ao PlayFab no token.
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:
- Abra sua Conta de Distribuidor e vá para Store > Catalog management > Integration with external platforms > PlayFab.
- Vá para a sincronização de inventário e especifique:
- Title ID — ID de jogo exclusivo no PlayFab.
- Secret key — a chave do projeto no PlayFab.
- Defina a opção Synchronize user inventory with PlayFab como On.
- 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 pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.