Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Ajouter Firebase à votre projet Unity

Boostez vos Unity jeux avec notre unité Firebase SDKs.

Pour montrer combien il est facile de brancher Firebase dans votre projet Unity, nous avons fait un jeu échantillon, MechaHamster, que vous pouvez télécharger à partir GitHub, l'App Store et le Google Play Store.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


Pour en savoir plus d' informations sur la mise sous tension vos jeux avec Firebase sur notre page jeux Firebase .

Vous avez déjà ajouté Firebase à votre projet Unity ? Assurez - vous que vous utilisez la dernière version de l' unité Firebase SDK .

Conditions préalables

  • Installez Unity 2017.4 ou une version ultérieure. Les versions antérieures peuvent également être compatibles mais ne seront pas activement prises en charge.

  • (iOS uniquement) Installer les éléments suivants:

    • Xcode 9.4.1 ou supérieur
    • CocoaPods 1.10.0 ou supérieur
  • Assurez-vous que votre projet Unity répond aux exigences suivantes :

    • Pour iOS - iOS cible 10 ou plus
    • Pour Android - les cibles de niveau API 16 (Jelly Bean) ou plus

  • Configurez un appareil physique ou utilisez un émulateur pour exécuter votre application.

    • Pour iOS - Mettre en place un appareil iOS physique ou utiliser le simulateur iOS.

    • Pour Android - émulateurs doit utiliser une image de l' émulateur avec Google Play.

Si vous ne possédez pas déjà un projet Unity et que vous voulez juste essayer un produit Firebase, vous pouvez télécharger un de nos échantillons de démarrage rapide .

Étape 1: Créer un projet Firebase

Avant de pouvoir ajouter Firebase à votre projet Unity, vous devez créer un projet Firebase pour vous connecter à votre projet Unity. Visitez Comprendre Firebase projets pour en savoir plus sur les projets Firebase.

Étape 2: Enregistrez votre application avec Firebase

Vous pouvez enregistrer une ou plusieurs applications ou jeux pour vous connecter à votre projet Firebase.

  1. Allez à la console Firebase .

  2. Au centre de la page d'aperçu du projet, cliquez sur l'icône de l' unité ( ) pour lancer le flux de travail de configuration.

    Si vous avez déjà ajouté une application à votre projet Firebase, cliquez sur Ajouter application pour afficher les options de plate - forme.

  3. Sélectionnez la cible de build de votre projet Unity que vous souhaitez enregistrer, ou vous pouvez même choisir d'enregistrer les deux cibles maintenant en même temps.

  4. Saisissez le ou les identifiants spécifiques à la plate-forme de votre projet Unity.

    • Pour iOS - Entrez votre ID iOS projet Unity dans l' ID de paquet iOS champ.

    • Pour Android - Entrez Android ID de votre projet Unity dans le nom du package Android champ.
      Les termes nom du package et l' ID d'application sont souvent utilisés de façon interchangeable.

  5. (Facultatif) Entrez votre projet surnom spécifique à la plateforme Unity (s).
    Ces surnoms sont des identifiants de commodité internes et ne sont visibles que par vous dans la console Firebase.

  6. Cliquez sur l' application de vous inscrire.

Étape 3: Ajouter des fichiers de configuration Firebase

  1. Obtenez vos fichiers de configuration Firebase spécifiques à la plate-forme dans le workflow de configuration de la console Firebase.

    • Pour iOS - Cliquez sur Télécharger GoogleService-Info.plist.

    • Pour Android - Cliquez sur Télécharger google-services.json.

  2. Ouvrez la fenêtre Projet de votre projet Unity, puis déplacez votre fichier de configuration (s) dans l' Assets dossier.

  3. Retour dans la console Firebase, dans le flux de travail de configuration, cliquez sur Suivant.

Étape 4: Ajouter Firebase Unité SDKs

  1. Dans la console Firebase, cliquez sur Télécharger Firebase SDK Unity, puis décompressez le SDK endroit pratique.

    • Vous pouvez télécharger le SDK Unity Firebase à tout moment.

    • Le SDK Firebase Unity n'est pas spécifique à la plate-forme.

  2. Dans votre projet open Unity, accédez à l' actif> Importer le package> Package personnalisé.

  3. À partir du SDK décompressé, sélectionnez les produits Firebase pris en charge que vous souhaitez utiliser dans votre application.

    Analytique activée

    • Ajoutez le package Firebase pour Google Analytics: FirebaseAnalytics.unitypackage
    • Ajoutez les packages pour tous les autres produits Firebase que vous souhaitez utiliser dans votre application. Par exemple, pour utiliser Firebase Authentication et Firebase Realtime Database :
      FirebaseAuth.unitypackage et FirebaseDatabase.unitypackage

    Analytics non activé

    Ajoutez les packages des produits Firebase que vous souhaitez utiliser dans votre application. Par exemple, pour utiliser Firebase Authentication et Firebase Realtime Database :
    FirebaseAuth.unitypackage et FirebaseDatabase.unitypackage

  4. Dans la fenêtre d' importation Package unité, cliquez sur Importer.

  5. Retour dans la console Firebase, dans le flux de travail de configuration, cliquez sur Suivant.

Étape 5: Confirmer les exigences Google Play version des services

Le SDK pour Android Unity Firebase nécessite des services Google Play , qui doit être mis à jour avant le SDK peut être utilisé.

Ajoutez le code suivant au démarrage de votre application. Vous pouvez rechercher et éventuellement mettre à jour les services Google Play vers la version requise par le SDK Firebase Unity avant d'appeler toute autre méthode du 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.
  }
});

Vous êtes prêt ! Votre projet Unity est enregistré et configuré pour utiliser Firebase.

Si vous éprouvez des difficultés se mettre en place, bien que, visitez le dépannage et l' unité FAQ .

Mettre en place un flux de travail de bureau (bêta)

Lorsque vous créez un jeu, il est souvent beaucoup plus facile de tester d'abord votre jeu dans l'éditeur Unity et sur les plates-formes de bureau, puis de le déployer et de le tester sur des appareils mobiles plus tard dans le développement. Pour prendre en charge ce flux de travail, nous fournissons un sous - ensemble de l'unité Firebase SDKs qui peut fonctionner sous Windows, Mac OS, Linux, et à partir de l'éditeur Unity.

  1. Mettre en place un projet Unity bureau-plateforme en suivant les mêmes instructions que pour une plate - forme mobile (commencer par le registre de votre application avec Firebase étape ci - dessus).

  2. Exécutez votre projet Unity dans l'IDE Unity ou sélectionnez pour construire votre projet Unity pour le bureau.

  3. (Facultatif) Exécutez votre projet Unity en mode Edit.

    Le SDK Firebase Unity peut également être exécuté en mode d'édition de Unity, permettant son utilisation dans les plugins d'éditeur.

    1. Lorsque vous créez un FirebaseApp utilisé par l'éditeur, ne pas utiliser l'instance par défaut.

    2. Au lieu de cela, fournir un nom unique au FirebaseApp.Create() appel.

      Ceci est important pour éviter un conflit d'options entre l'instance utilisée par l'IDE Unity et l'instance utilisée par votre projet Unity.

Produits Firebase pris en charge

En savoir plus sur les bibliothèques Unity Firebase dans la documentation de référence .

L'unité Firebase SDK prend en charge les produits suivants Firebase sur iOS et Android:

Produit Firebase Paquet d'unité
AdMob Distribué séparément dans le plug-in AdMob Unity
Analytique FirebaseAnalytics.unitypackage
Authentification FirebaseAuth.unitypackage
Cloud Firestore (beta) FirebaseFirestore.unitypackage
Fonctions Cloud FirebaseFunctions.unitypackage
Messagerie Cloud FirebaseMessaging.unitypackage
(recommandé) FirebaseAnalytics.unitypackage
Stockage en ligne FirebaseStorage.unitypackage
Crashlytiques FirebaseCrashlytics.unitypackage
(recommandé) FirebaseAnalytics.unitypackage
Liens dynamiques FirebaseDynamicLinks.unitypackage
(recommandé) FirebaseAnalytics.unitypackage
Base de données en temps réel FirebaseDatabase.unitypackage
Configuration à distance FirebaseRemoteConfig.unitypackage
(recommandé) FirebaseAnalytics.unitypackage

Produits Firebase pris en charge (ordinateur de bureau)

Le SDK inclut l' unité Firebase support de flux de travail de bureau pour un sous - ensemble de produits, ce qui permet certaines parties de Firebase à utiliser dans l'éditeur Unity et bureau autonome construit sur Windows, Mac OS, et Linux.

Produit Firebase (ordinateur de bureau) Paquet d'unité
Authentification FirebaseAuth.unitypackage
Fonctions Cloud FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Stockage en ligne FirebaseStorage.unitypackage
Base de données en temps réel FirebaseDatabase.unitypackage
Configuration à distance FirebaseRemoteConfig.unitypackage

Firebase fournit les bibliothèques de bureau restantes en tant qu'implémentations stub (non fonctionnelles) pour plus de commodité lors de la création pour Windows, macOS et Linux. Par conséquent, vous n'avez pas besoin de compiler le code de manière conditionnelle pour cibler le bureau.

Prochaines étapes