Pular para o conteúdo principal
Este guia mostra como fazer chamadas às APIs de serviço do PlayFab usando o SDK unificado. Você aprenderá a chamar vários serviços do PlayFab para gerenciar os dados do jogador, recuperar arquivos e interagir com outros recursos do PlayFab.

Pré-requisitos

Antes de começar, verifique se você:
Este guia pressupõe que você já inicializou o SDK do PlayFab e autenticou um jogador seguindo o guia de início rápido do Core. Se ainda não fez isso, conclua esse guia primeiro.

O que você vai realizar

Ao final deste início rápido, você terá:
  • Recuperado a chave de entidade de um jogador autenticado
  • Feito sua primeira chamada à API de serviço do PlayFab
  • Processado a resposta de um serviço do PlayFab

Fazendo sua primeira chamada à API de serviço

Após a autenticação bem-sucedida, você pode fazer chamadas à API do PlayFab usando o PFEntityHandle obtido durante o logon. Este exemplo mostra como recuperar os arquivos armazenados para o jogador atual.

Etapa 1: Obter a chave de entidade

Primeiro, recupere a chave de entidade a partir do seu identificador de entidade autenticado:

Etapa 2: Chamar a API GetFiles

Agora faça sua primeira chamada de serviço do PlayFab para obter os arquivos associados ao jogador:
🎉 Parabéns! Você fez com sucesso sua primeira chamada à API de serviço do PlayFab usando o SDK unificado.

Entendendo o padrão de chamada à API

Todas as chamadas às APIs de serviço do PlayFab seguem um padrão semelhante:
  1. Preparar a requisição - Crie e preencha uma estrutura de requisição
  2. Iniciar a chamada assíncrona - Chame a função *Async
  3. Aguardar a conclusão - Use XAsyncGetStatus para aguardar a operação
  4. Obter o tamanho do resultado - Chame *GetResultSize para determinar o tamanho do buffer necessário
  5. Recuperar o resultado - Chame *GetResult para obter os dados reais
Esse padrão se aplica a todas as APIs de serviço do PlayFab, o que facilita o trabalho com diferentes serviços depois que você entende o básico.

Próximas etapas

Agora que você chamou com sucesso um serviço do PlayFab, explore estes recursos adicionais:

APIs de serviço comuns

  • Gerenciamento de dados do jogador - Armazene e recupere dados personalizados do jogador
  • Estatísticas do jogador - Acompanhe as estatísticas e conquistas do jogador
  • Dados do título - Acesse os dados de configuração do jogo
  • Cloud Script - Execute lógica do lado do servidor

Recursos avançados

  • Placares - Implemente recursos competitivos com classificações
  • Economia e monetização - Adicione moedas virtuais e itens
  • Multiplayer - Integre os serviços de matchmaking e lobby
  • Análise - Acompanhe o comportamento dos jogadores e as métricas do jogo

Práticas recomendadas

Solução de problemas

Problemas comuns e soluções: Para obter informações de erro mais detalhadas, habilite o rastreamento e diagnóstico no seu aplicativo.

Documentação de referência

Última modificação em 8 de outubro de 2026