Potencialize seus jogos Unity com nossos SDKs do Firebase Unity.
Para mostrar como é fácil conectar o Firebase ao seu projeto Unity, criamos um jogo de amostra, MechaHamster, que você pode baixar no GitHub , na App Store e na Google Play Store .
Encontre 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 Firebase Unity SDK .
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.
(Apenas plataformas Apple) Instale o seguinte:
- Xcode 13.3.1 ou superior
- CocoaPods 1.10.0 ou superior
Certifique-se de que seu projeto Unity atenda a estes requisitos:
- Para iOS — destina-se ao iOS 11 ou superior
- Para tvOS - visa o tvOS 12 ou superior
- Para Android — segmenta API de nível 19 (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 de iOS ou tvOS.
Para Cloud Messaging no iOS ou tvOS, aqui estão os pré-requisitos:
- Configure um dispositivo físico .
- Obtenha uma chave de autenticação de notificação por push da Apple para sua conta de desenvolvedor da Apple .
- Ative as notificações por push no XCode em App > Capabilities .
Para Android — os emuladores devem usar uma imagem de emulador com o Google Play.
- Faça login no Firebase usando sua conta do Google.
Se você ainda não tem um projeto Unity e quer apenas experimentar um produto Firebase, pode baixar um de nossos exemplos de início rápido .
Etapa 1 : criar um projeto do Firebase
Antes de adicionar o Firebase ao seu projeto Unity, você precisa criar um projeto Firebase para se conectar ao seu projeto Unity. Acesse 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 se conectar ao seu projeto Firebase.
Acesse o console do Firebase .
No centro da página de visão geral do projeto, clique no ícone do Unity (
) para iniciar o fluxo de trabalho de configuração.Se você já adicionou um aplicativo ao seu projeto Firebase, clique em Adicionar aplicativo para exibir as opções da plataforma.
Selecione qual destino de construção do seu projeto Unity você gostaria de registrar, ou você pode até mesmo selecionar para registrar ambos os destinos agora ao mesmo tempo.
Insira o(s) ID(s) específico(s) da plataforma do seu projeto Unity.
Para iOS — insira o ID do iOS do seu projeto Unity no campo ID do pacote do iOS .
Para Android — Insira a ID do Android do seu projeto Unity no campo Android package name .
Os termos nome do pacote e ID do aplicativo geralmente são usados de forma intercambiável.
Abra seu projeto Unity em seu Unity IDE e navegue até a seção de configurações de cada plataforma:
Para iOS — Navegue até Build Settings > iOS .
Para Android — Navegue até Android > Configurações do player > Outras configurações .
O ID do seu projeto Unity é o valor do identificador de pacote (ID de exemplo:
com.yourcompany.yourproject
).(Opcional) Insira o(s) apelido(s) específico(s) da plataforma do seu projeto Unity.
Esses apelidos são identificadores internos de conveniência e só são visíveis para você no console do Firebase.Clique em Registrar aplicativo .
Etapa 3 : adicionar arquivos de configuração do Firebase
Obtenha o(s) arquivo(s) de configuração do Firebase específico(s) da plataforma no fluxo de trabalho de configuração do Firebase console.
Para iOS — Clique em Baixar GoogleService-Info.plist .
Para Android — Clique em Baixar google-services.json .
O arquivo de configuração do Firebase contém identificadores exclusivos, mas não secretos, para seu projeto. Para saber mais sobre esse arquivo de configuração, visite Entenda os projetos do Firebase .
Você pode baixar o arquivo de configuração do Firebase novamente a qualquer momento.
Certifique-se de que o nome do arquivo de configuração não contenha caracteres adicionais, como
(2)
.
Abra a janela Project do seu projeto Unity e mova seu(s) arquivo(s) de configuração para a pasta
Assets
.De volta ao Firebase console, no fluxo de trabalho de configuração, clique em Next .
Etapa 4 : adicionar SDKs do Firebase Unity
No console do Firebase, clique em Download Firebase Unity SDK e descompacte o SDK em algum lugar conveniente.
Você pode baixar o Firebase Unity SDK novamente a qualquer momento.
O Firebase Unity SDK não é específico da plataforma.
Em seu projeto Unity aberto, navegue até Assets > Import Package > Custom Package .
No SDK descompactado, selecione os produtos compatíveis do Firebase que você deseja usar em seu aplicativo.
Análise habilitada
- Adicione o pacote Firebase para Google Analytics:
FirebaseAnalytics.unitypackage
- Adicione os pacotes para quaisquer outros produtos Firebase que você deseja usar em seu aplicativo. Por exemplo, para usar o Firebase Authentication e o Firebase Realtime Database:
FirebaseAuth.unitypackage
eFirebaseDatabase.unitypackage
Análise não habilitada
Adicione os pacotes para os produtos Firebase que você deseja usar em seu aplicativo. Por exemplo, para usar o Firebase Authentication e o Firebase Realtime Database:
FirebaseAuth.unitypackage
eFirebaseDatabase.unitypackage
- Adicione o pacote Firebase para Google Analytics:
Na janela Importar pacote do Unity , clique em Importar .
De volta ao Firebase console, no fluxo de trabalho de configuração, clique em Next .
Etapa 5 : confirme os requisitos de versão do Google Play Services
O Firebase Unity SDK para Android requer serviços do Google Play , que devem estar atualizados antes que o SDK possa ser usado.
Adicione o código a seguir no início do seu aplicativo. Você pode verificar e, opcionalmente, atualizar os serviços do Google Play para a versão exigida pelo Firebase Unity SDK antes de chamar qualquer outro método no SDK.
Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(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 a solução de problemas e perguntas frequentes do Unity .
Configurar um fluxo de trabalho de desktop ( beta )
Quando você está criando um jogo, geralmente é muito mais fácil testá-lo no editor do Unity e em plataformas de desktop primeiro e, posteriormente, implantar e testar em dispositivos móveis no desenvolvimento. Para oferecer suporte a esse fluxo de trabalho, fornecemos um subconjunto dos SDKs do Firebase Unity que podem ser executados no Windows, macOS, Linux e no editor do Unity.
Configure um projeto Unity de plataforma de desktop seguindo as mesmas instruções de uma plataforma móvel (comece com a etapa Register your app with Firebase acima).
Execute seu projeto Unity no Unity IDE ou selecione para criar seu projeto Unity para desktop .
(Opcional) Execute seu projeto do Unity no modo de edição.
O Firebase Unity SDK também pode ser executado no modo de edição do Unity, permitindo seu uso em plug-ins de edição.
Ao criar um
FirebaseApp
usado pelo editor, não use a instância padrão.Em vez disso, forneça um nome exclusivo para a chamada
FirebaseApp.Create()
.Isso é importante para evitar um conflito de opções entre a instância usada pelo Unity IDE e a instância usada pelo seu projeto Unity.
Produtos compatíveis do Firebase
Saiba mais sobre as bibliotecas Unity Firebase na documentação de referência .
Bibliotecas do Firebase disponíveis para dispositivos móveis
O Firebase Unity SDK é compatível com os seguintes produtos Firebase em Apple e Android :
Produto Firebase | pacote Unity |
---|---|
AdMob | Distribuído separadamente no plug-in Unity da AdMob |
Análise | FirebaseAnalytics.unitypackage |
Autenticação | FirebaseAuth.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
Funções da 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 do Firebase disponíveis para desktop
O Firebase Unity SDK inclui suporte para fluxo de trabalho de desktop para um subconjunto de produtos, permitindo que certas partes do Firebase sejam usadas no editor Unity e em compilações autônomas de desktop no Windows, macOS e Linux.
Produto Firebase (desktop) | pacote Unity |
---|---|
Autenticação | FirebaseAuth.unitypackage |
Funções da nuvem | FirebaseFunctions.unitypackage |
Cloud Firestore | 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 conveniência ao compilar para Windows, macOS e Linux. Portanto, você não precisa compilar código condicionalmente para direcionar a área de trabalho.
Próximos passos
Explore exemplos de aplicativos do Firebase .
Prepare-se para lançar seu aplicativo:
- Configure alertas de orçamento para seu projeto no Console do Google Cloud.
- Monitore o painel de uso e cobrança no console do Firebase para obter uma visão geral do uso do seu projeto em vários serviços do Firebase.
- Revise a lista de verificação de lançamento do Firebase .
Está tendo problemas com o Firebase e seu projeto Unity? Visite a solução de problemas e perguntas frequentes do Unity .