Pular para o conteúdo principal

Início rápido: biblioteca de cliente do PlayFab para C# no Unity

Comece a usar a biblioteca de cliente do PlayFab para C# no Unity. Siga as etapas para instalar o pacote e experimentar o código de exemplo para uma tarefa básica. Este início rápido ajuda você a fazer sua primeira chamada à API do PlayFab no mecanismo Unity.

Requisitos

O SDK do PlayFab para Unity é compatível com o Unity Editor versão 5.3 (lançado em dezembro de 2015) e superiores.
  • Um projeto do Unity de qualquer um dos seguintes tipos:
  • O SDK do PlayFab para Unity.

Baixar e instalar o SDK do PlayFab

Use o pacote PlayFab Editor Extensions para instalar o SDK ou instale o SDK diretamente. As PlayFab Editor Extensions são um plug-in autônomo do Unity que simplifica a instalação do SDK e a definição de algumas configurações do PlayFab para o seu título. Para obter informações sobre como instalar o SDK sem usar as PlayFab Editor Extensions, consulte Instalando o SDK do PlayFab sem as Editor Extensions para Unity.
  1. Baixe o pacote de ativos das PlayFab Unity Editor Extensions.
  2. Abra seu projeto do Unity.
  3. Navegue até o local em que você baixou o arquivo e clique duas vezes no arquivo PlayFabEditorExtensions.UnityPackage para abrir a caixa de diálogo Import Unity Package no Unity Editor. Import Unity Asset package
  4. Para importar as PlayFab Unity Editor Extensions no seu projeto, selecione Import.
  5. Quando a importação for concluída, o painel PlayFab Unity Editor Extensions deverá abrir automaticamente, exibindo a caixa de diálogo de instalação do SDK.
Se o painel não abrir, ou se você fechá-lo e quiser abri-lo novamente, selecione Window > PlayFab > Editor Extensions
Install PlayFab SDK 6. Selecione Install PlayFab SDK para importar automaticamente o SDK no seu projeto ou atualizar a versão instalada no momento.

Definir as configurações do título

Antes de fazer uma chamada à API, você precisa criar um PlayFabSharedSettings.asset e especificar o ID do título que receberá a chamada. Para definir o ID do título:
  1. Selecione PlayFab > MakePlayFabSharedSettings, o que deve criar o ativo de configurações e abri-lo no painel Inspector.
  2. Defina o Title ID no Inspector. PlayFab Title ID Setting
  3. A qualquer momento, você também pode ver e alterar o ID do título atual na guia Settings do painel Editor Extensions.
A Developer Secret Key não é definida por padrão. Se você estiver criando um build de servidor, forneça a chave secreta no PlayFabSharedSettings.asset. PlayFab Developer Secret Key Setting A Developer Secret Key é definida automaticamente como a chave secreta padrão do título. Para obter mais informações sobre chaves secretas, consulte Gerenciamento de chaves secretas. Caso contrário, verifique se a chave secreta não está definida ao compilar o cliente do jogo. Para obter mais informações sobre chaves secretas, consulte Gerenciamento de chaves secretas.
As extensões permitem personalizar o transporte HTTP usado para fazer requisições ao PlayFab. O padrão recomendado é o Unity Web Request. Há outras opções para oferecer compatibilidade com versões mais antigas do mecanismo ou com implementações de HTTP específicas do jogo.

Fazendo sua primeira chamada à API

Esta parte do guia fornece as etapas mínimas para fazer sua primeira chamada à API do PlayFab. Este exemplo não fornece nenhuma GUI nem feedback na tela. A confirmação é exibida no log do Console.
  1. Se o seu projeto do Unity ainda não tiver uma pasta Scripts (os modelos HDRP e LWRP/URP têm uma por padrão), clique com o botão direito do mouse na pasta Assets no painel Project e selecione Create > Folder.
  2. Na janela Assets, nomeie a pasta como Scripts.
  3. Clique com o botão direito do mouse na pasta Scripts e selecione Create > C# Script.
  4. Nomeie o script como PlayFabLogin.
  5. Clique duas vezes no arquivo para abri-lo em um editor de código.
  6. No editor de código, substitua o conteúdo de PlayFabLogin.cs pelo código fornecido e salve o arquivo.
O código fornecido não deve ser usado em títulos para dispositivos móveis. Este é apenas um exemplo e mostra como fazer logon com um CustomID. Para implementar o logon em um título para dispositivos móveis, use
LoginWithAndroidDeviceID, LoginWithIOSDeviceID ou alguma forma de logon social, como LoginWithFacebook. 7. No painel Hierarchy, clique com o botão direito do mouse na sua cena e selecione Create Empty (ou Game Object > Create Empty em versões mais antigas do Unity). 8. Selecione o novo Game Object e, no painel Inspector, selecione Add Component. 9. No menu suspenso de componentes, selecione Scripts > PlayFabLogin. Para obter mais informações sobre como criar e usar scripts no Unity Editor, consulte Creating and Using Scripts na documentação do Unity.

Concluir e executar

Agora você está pronto para testar este exemplo.
  • Salve todos os arquivos e volte ao Unity Editor
  • Pressione o botão Play na parte superior do editor
Você verá a seguinte mensagem no painel Console do Unity. Console log of first API call
Como alternativa, você pode entrar no PlayFab, navegar até o título no Game Manager e selecionar a guia PlayStream Monitor. Cada vez que você tira o foco do título do Unity em execução, ele envia um evento que você pode ver e confirmar no PlayStream Monitor.
Para obter uma lista de todas as chamadas disponíveis da API de cliente, consulte Referências de API do PlayFab.

Próximas etapas

Este início rápido mostra um procedimento simplificado para autenticar um usuário. Para obter mais informações sobre autenticação de usuários, consulte Noções básicas e práticas recomendadas de logon. Saiba como vincular uma conta a vários dispositivos e mecanismos de logon: Início rápido da vinculação de contas.
Última modificação em 8 de outubro de 2026