Adicione o Firebase ao seu projeto Unity

Aprimore seus jogos do Unity com nossos SDKs do Firebase para Unity.

Para mostrar como é fácil conectar o Firebase ao seu projeto Unity, criamos um jogo de amostra, MechaHamster. Se você quiser experimentar adicionar o Firebase a um jogo, use a versão inicial que está no GitHub . Caso queira uma versão completa, confira as versões na App Store ou na Google Play Store .

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


Descubra mais informações sobre como potencializar seus jogos com o Firebase em nossa página de jogos do Firebase .

Já adicionou o Firebase ao seu projeto Unity? Verifique se você está usando a versão mais recente do SDK do Firebase Unity .

Pré-requisitos

  • Instale o Unity 2019.1 ou posterior. Versões anteriores também podem ser compatíveis, mas não terão suporte ativo. O suporte para Unity 2019.1 é considerado obsoleto e não terá mais suporte ativo após a próxima versão principal.

  • (Somente plataformas Apple) Instale o seguinte:

    • Xcode 13.3.1 ou superior
    • CocoaPods 1.12.0 ou superior

  • Certifique-se de que seu projeto Unity atenda a estes requisitos:

    • Para iOS – direcionado ao iOS 11 ou superior
    • Para tvOS – direcionado ao tvOS 12 ou superior
    • Para Android – direcionado ao nível 19 da API (KitKat) ou superior

  • Configure um dispositivo físico ou use um emulador para executar seu aplicativo.

    • Para plataformas Apple — Configure um dispositivo físico ou use um simulador iOS ou tvOS.

    • Para Android – os emuladores devem usar uma imagem de emulador com o Google Play.

Se você ainda não tem um projeto Unity e deseja apenas testar um produto Firebase, faça download de um de nossos exemplos de início rápido .

Etapa 1 : crie um projeto Firebase

Antes de adicionar o Firebase ao seu projeto do Unity, você precisa criar um projeto do Firebase para se conectar ao seu projeto do Unity. Visite Entenda os projetos do Firebase para saber mais sobre os projetos do Firebase.

Etapa 2 : registre seu aplicativo no Firebase

Você pode registrar um ou mais aplicativos ou jogos para conectar ao seu projeto do Firebase.

  1. Vá para o console do Firebase .

  2. No centro da página de visão geral do projeto, clique no ícone Unity ( ) para iniciar o fluxo de trabalho de configuração.

    Se você já adicionou um aplicativo ao seu projeto do Firebase, clique em Adicionar aplicativo para exibir as opções da plataforma.

  3. Selecione qual destino de compilação do seu projeto Unity você gostaria de registrar ou você pode até optar por registrar ambos os alvos agora ao mesmo tempo.

  4. Insira os IDs específicos da plataforma do seu projeto Unity.

    • Para iOS : insira o ID do iOS do seu projeto do Unity no campo ID do pacote iOS .

    • Para Android : insira o ID do Android do seu projeto Unity no campo Nome do pacote Android .
      Os termos nome do pacote e ID do aplicativo são frequentemente usados ​​de forma intercambiável.

  5. (Opcional) Insira os apelidos específicos da plataforma do seu projeto Unity.
    Esses apelidos são identificadores internos e convenientes e só ficam visíveis para você no console do Firebase.

  6. Clique em Registrar aplicativo .

Etapa 3 : adicionar arquivos de configuração do Firebase

  1. Obtenha seus arquivos de configuração do Firebase específicos da plataforma no fluxo de trabalho de configuração do Console do Firebase.

    • Para iOS – clique em Baixar GoogleService-Info.plist .

    • Para Android – clique em Baixar google-services.json .

  2. Abra a janela Projeto do seu projeto Unity e mova seus arquivos de configuração para a pasta Assets .

  3. De volta ao console do Firebase, no fluxo de trabalho de configuração, clique em Avançar .

Etapa 4 : adicionar SDKs do Firebase Unity

  1. No console do Firebase, clique em Baixar Firebase Unity SDK e descompacte o SDK em algum lugar conveniente.

    • Você pode fazer download do SDK do Firebase Unity novamente a qualquer momento.

    • O SDK do Firebase Unity não é específico da plataforma.

  2. Em seu projeto aberto do Unity, navegue até Assets > Import Package > Custom Package .

  3. No SDK descompactado, selecione os produtos compatíveis do Firebase que você deseja usar no seu aplicativo.

    Análise ativada

    • Adicione o pacote Firebase para Google Analytics: FirebaseAnalytics.unitypackage
    • Adicione os pacotes de quaisquer outros produtos do Firebase que você queira usar no seu aplicativo. Por exemplo, para usar o Firebase Authentication e o Firebase Realtime Database:
      FirebaseAuth.unitypackage e FirebaseDatabase.unitypackage

    Análise não ativada

    Adicione os pacotes dos produtos do Firebase que você quer usar no seu aplicativo. Por exemplo, para usar o Firebase Authentication e o Firebase Realtime Database:
    FirebaseAuth.unitypackage e FirebaseDatabase.unitypackage

  4. Na janela Importar pacote do Unity , clique em Importar .

  5. De volta ao console do Firebase, no fluxo de trabalho de configuração, clique em Avançar .

Etapa 5 : confirme os requisitos de versão do Google Play Services

O SDK do Firebase Unity para Android requer o Google Play Services , que deve estar atualizado antes que o SDK possa ser usado.

Adicione a seguinte instrução using e o código de inicialização no início do seu aplicativo. Você pode verificar e, opcionalmente, atualizar o Google Play Services para a versão exigida pelo SDK do Firebase Unity antes de chamar qualquer outro método no SDK.

using Firebase.Extensions;

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWithOnMainThread(task => {
  var dependencyStatus = task.Result;
  if (dependencyStatus == Firebase.DependencyStatus.Available) {
    // Create and hold a reference to your FirebaseApp,
    // where app is a Firebase.FirebaseApp property of your application class.
       app = Firebase.FirebaseApp.DefaultInstance;

    // Set a flag here to indicate whether Firebase is ready to use by your app.
  } else {
    UnityEngine.Debug.LogError(System.String.Format(
      "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
    // Firebase Unity SDK is not safe to use here.
  }
});

Está tudo pronto! Seu projeto Unity está registrado e configurado para usar o Firebase.

Se você estiver tendo problemas para configurar, visite Solução de problemas e perguntas frequentes do Unity .

Configurar um fluxo de trabalho de desktop ( beta )

Ao criar um jogo, geralmente é muito mais fácil testá-lo primeiro no editor Unity e em plataformas de desktop e, em seguida, implantá-lo e testá-lo em dispositivos móveis posteriormente no desenvolvimento. Para oferecer suporte a esse fluxo de trabalho, fornecemos um subconjunto de SDKs do Firebase Unity que podem ser executados no Windows, macOS, Linux e no editor Unity.

  1. Configure um projeto Unity para plataforma de desktop seguindo as mesmas instruções de uma plataforma móvel (comece com a etapa Registre seu aplicativo no Firebase acima).

  2. Execute seu projeto Unity no Unity IDE ou selecione criar seu projeto Unity para desktop .

  3. (Opcional) Execute seu projeto Unity no modo de edição.

    O SDK do Firebase Unity também pode ser executado no modo de edição do Unity, permitindo seu uso em plug-ins de editor.

    1. Ao criar um FirebaseApp usado pelo editor, não use a instância padrão.

    2. Em vez disso, forneça um nome exclusivo para a chamada FirebaseApp.Create() .

      Isso é importante para evitar conflitos de opções entre a instância usada pelo Unity IDE e a instância usada pelo seu projeto Unity.

Produtos Firebase compatíveis

Saiba mais sobre as bibliotecas Unity Firebase na documentação de referência .

Bibliotecas Firebase disponíveis para dispositivos móveis

O SDK do Firebase para Unity é compatível com os seguintes produtos do Firebase na Apple e no Android :

Produto Firebase Pacote de unidade
AdMob Distribuído separadamente no plug-in do AdMob Unity
Análise FirebaseAnalytics.unitypackage
Verificação de aplicativo FirebaseAppCheck.unitypackage
Autenticação FirebaseAuth.unitypackage
Cloud Fire Store FirebaseFirestore.unitypackage
Funções de nuvem FirebaseFunctions.unitypackage
Mensagens na nuvem FirebaseMessaging.unitypackage
(recomendado) FirebaseAnalytics.unitypackage
Armazenamento na núvem FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(recomendado) FirebaseAnalytics.unitypackage
Links Dinâmicos FirebaseDynamicLinks.unitypackage
(recomendado) FirebaseAnalytics.unitypackage
Banco de dados em tempo real FirebaseDatabase.unitypackage
Configuração remota FirebaseRemoteConfig.unitypackage
(recomendado) FirebaseAnalytics.unitypackage

Bibliotecas Firebase disponíveis para desktop

O SDK do Firebase Unity inclui suporte ao fluxo de trabalho de desktop para um subconjunto de produtos, permitindo que certas partes do Firebase sejam usadas no editor Unity e em versões de desktop independentes no Windows, macOS e Linux.

Produto Firebase (computador) Pacote de unidade
Verificação de aplicativo FirebaseAppCheck.unitypackage
Autenticação FirebaseAuth.unitypackage
Funções de nuvem FirebaseFunctions.unitypackage
Cloud Fire Store FirebaseFirestore.unitypackage
Armazenamento na núvem FirebaseStorage.unitypackage
Banco de dados em tempo real FirebaseDatabase.unitypackage
Configuração remota FirebaseRemoteConfig.unitypackage

O Firebase fornece as bibliotecas de desktop restantes como implementações stub (não funcionais) para maior conveniência ao criar para Windows, macOS e Linux. Portanto, você não precisa compilar condicionalmente o código para direcionar a área de trabalho.

Próximos passos