Ajoutez Firebase à votre projet Unity

Améliorez vos jeux Unity avec nos SDK Firebase Unity.

Pour montrer à quel point il est facile de connecter Firebase à votre projet Unity, nous avons créé un exemple de jeu, MechaHamster. Si vous souhaitez essayer d'ajouter Firebase à un jeu, utilisez la version de démarrage disponible sur GitHub . Si vous souhaitez une version complète, consultez les versions dans l' App Store ou le Google Play Store .

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


Découvrez plus d'informations sur la mise à niveau de vos jeux avec Firebase sur notre page de jeux Firebase .

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

Conditions préalables

  • Installez Unity 2019.1 ou version ultérieure. Les versions antérieures peuvent également être compatibles mais ne seront pas activement prises en charge. La prise en charge de Unity 2019.1 est considérée comme obsolète et ne sera plus activement prise en charge après la prochaine version majeure.

  • (Plateformes Apple uniquement) Installez les éléments suivants :

    • Xcode 13.3.1 ou supérieur
    • CocoaPods 1.12.0 ou supérieur
  • Assurez-vous que votre projet Unity répond à ces exigences :

    • Pour iOS – cible iOS 11 ou supérieur
    • Pour tvOS - cible tvOS 12 ou supérieur
    • Pour Android : cible le niveau d'API 19 (KitKat) ou supérieur
  • Configurez un appareil physique ou utilisez un émulateur pour exécuter votre application.

    • Pour les plateformes Apple : configurez un appareil physique ou utilisez un simulateur iOS ou tvOS.

    • Pour Android : les émulateurs doivent utiliser une image d'émulateur avec Google Play.

Si vous n'avez pas encore de projet Unity et que vous souhaitez simplement essayer un produit Firebase, vous pouvez télécharger l'un de nos exemples 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. Consultez Comprendre les projets Firebase pour en savoir plus sur les projets Firebase.

Étape 2 : Enregistrez votre application auprès de Firebase

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

  1. Accédez à la console Firebase .

  2. Au centre de la page de présentation du projet, cliquez sur l'icône Unity ( ) pour lancer le workflow de configuration.

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

  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(s) ID spécifique(s) à la plateforme de votre projet Unity.

    • Pour iOS : saisissez l'ID iOS de votre projet Unity dans le champ ID du bundle iOS .

    • Pour Android : saisissez l'ID Android de votre projet Unity dans le champ Nom du package Android .
      Les termes nom de package et ID d’application sont souvent utilisés de manière interchangeable.

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

  6. Cliquez sur Enregistrer l'application .

Étape 3 : Ajouter les 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 ou vos fichiers de configuration dans le dossier Assets .

  3. De retour dans la console Firebase, dans le workflow de configuration, cliquez sur Suivant .

Étape 4 : ajouter des SDK Firebase Unity

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

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

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

  2. Dans votre projet Unity ouvert, accédez à Assets > Import Package > Custom Package .

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

    Analyse 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 l'authentification Firebase et la base de données Firebase Realtime :
      FirebaseAuth.unitypackage et FirebaseDatabase.unitypackage

    Analyse non activée

    Ajoutez les packages pour les produits Firebase que vous souhaitez utiliser dans votre application. Par exemple, pour utiliser l'authentification Firebase et la base de données Firebase Realtime :
    FirebaseAuth.unitypackage et FirebaseDatabase.unitypackage

  4. Dans la fenêtre Importer un package Unity , cliquez sur Importer .

  5. De retour dans la console Firebase, dans le workflow de configuration, cliquez sur Suivant .

Étape 5 : Confirmez les exigences de version des services Google Play

Le SDK Firebase Unity pour Android nécessite les services Google Play , qui doivent être à jour avant que le SDK puisse être utilisé.

Ajoutez l’instruction using et le code d’initialisation suivants au début 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.

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.
  }
});

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

Si vous rencontrez des difficultés lors de la configuration, consultez la FAQ de dépannage et de Unity .

Configurer un workflow 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 au cours du développement. Pour prendre en charge ce flux de travail, nous fournissons un sous-ensemble des SDK Firebase Unity qui peuvent s'exécuter sur Windows, macOS, Linux et depuis l'éditeur Unity.

  1. Configurez un projet Unity sur plate-forme de bureau en suivant les mêmes instructions que pour une plate-forme mobile (commencez par l'étape Enregistrez votre application auprès de Firebase ci-dessus).

  2. Exécutez votre projet Unity dans l'EDI Unity ou choisissez de créer votre projet Unity pour ordinateur de bureau .

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

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

    1. Lorsque vous créez une FirebaseApp utilisée par l'éditeur, n'utilisez pas l'instance par défaut.

    2. Au lieu de cela, fournissez un nom unique à l'appel FirebaseApp.Create() .

      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

Apprenez-en plus sur les bibliothèques Unity Firebase dans la documentation de référence .

Bibliothèques Firebase disponibles pour mobile

Le SDK Firebase Unity prend en charge les produits Firebase suivants sur Apple et Android :

Produit Firebase Forfait Unité
AdMob Distribué séparément dans le plug-in AdMob Unity
Analytique FirebaseAnalytics.unitypackage
Vérification de l'application FirebaseAppCheck.unitypackage
Authentification FirebaseAuth.unitypackage
Cloud Firestore 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

Bibliothèques Firebase disponibles pour ordinateur de bureau

Le SDK Firebase Unity inclut la prise en charge des flux de travail de bureau pour un sous-ensemble de produits, permettant à certaines parties de Firebase d'être utilisées dans l'éditeur Unity et dans des versions de bureau autonomes sur Windows, macOS et Linux.

Produit Firebase (ordinateur de bureau) Forfait Unité
Vérification de l'application FirebaseAppCheck.unitypackage
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 sous forme d'implémentations de 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 du code de manière conditionnelle pour cibler le bureau.

Prochaines étapes