Boostez vos jeux Unity avec nos SDK Firebase Unity.
Pour montrer à quel point il est facile d'intégrer Firebase à votre projet Unity, nous avons créé un exemple de jeu, MechaHamster. Si vous souhaitez ajouter Firebase à un jeu, utilisez la version de démarrage disponible sur GitHub. Si vous souhaitez obtenir une version complète, consultez les versions disponibles sur l'App Store ou sur le Google Play Store.
MechaHamster (magasin d'applications)
Pour en savoir plus sur l'optimisation de vos jeux avec Firebase, consultez notre page sur les jeux Firebase.
Vous avez déjà ajouté Firebase à votre projet Unity ? Assurez-vous d'utiliser la dernière version du SDK Firebase Unity.
Prérequis
Installez Unity 2022 LTS ou une version ultérieure. Les versions antérieures peuvent également être compatibles, mais ne seront pas activement prises en charge.
(Plates-formes Apple uniquement) Installez les éléments suivants :
- Xcode 26.2 ou version ultérieure
Assurez-vous que votre projet Unity répond aux exigences suivantes :
- Pour iOS : cible iOS 15 ou version ultérieure
- Pour tvOS : cible tvOS 15 ou version ultérieure
- Pour Android : cible le niveau d'API 24 (Nougat) ou version ultérieure
Configurez un appareil physique ou utilisez un émulateur pour exécuter votre application.
Pour les plates-formes 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éez un projet Firebase
Avant d'ajouter Firebase à votre projet Unity, vous devez créer un projet Firebase à associer à 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 les associer à votre projet Firebase.
Accédez à la console Firebase.
Au centre de la page "Vue d'ensemble du projet", cliquez sur l'icône Unity () pour lancer la configuration.
Si vous avez déjà ajouté une application à votre projet Firebase, cliquez sur Ajouter une application pour afficher les options de plate-forme.
Sélectionnez la cible de build de votre projet Unity que vous souhaitez enregistrer. Vous pouvez même choisir d'enregistrer les deux cibles en même temps.
Saisissez les ID spécifiques à la plate-forme 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 Android package name (Nom du package Android).
Les termes nom du package et ID d'application sont souvent utilisés de manière interchangeable.
Facultatif : Saisissez les pseudos spécifiques à la plate-forme de votre projet Unity.
Ces pseudonymes sont des identifiants internes pratiques et ne sont visibles que par vous dans la console Firebase.Cliquez sur Enregistrer l'application.
Étape 3 : Ajouter des fichiers de configuration Firebase
Obtenez les fichiers de configuration Firebase spécifiques à votre 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.
Ouvrez la fenêtre Project (Projet) de votre projet Unity, puis déplacez vos fichiers de configuration dans le dossier
Assets.De retour dans la console Firebase, dans le workflow de configuration, cliquez sur Suivant.
Étape 4 : Ajouter les SDK Unity Firebase
Dans la console Firebase, cliquez sur Télécharger le SDK Firebase Unity, puis extrayez le SDK dans un emplacement pratique.
Vous pouvez télécharger à nouveau le SDK Firebase Unity à tout moment.
Le SDK Firebase Unity n'est pas spécifique à une plate-forme.
Dans votre projet Unity ouvert, cliquez sur Assets > Import Package > Custom Package (Éléments > Importer un package > Package personnalisé).
Dans le SDK extrait, sélectionnez les produits Firebase compatibles que vous souhaitez utiliser dans votre application.
Analytics activé
- 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.unitypackageetFirebaseDatabase.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.unitypackageetFirebaseDatabase.unitypackage- Ajoutez le package Firebase pour Google Analytics :
Dans la fenêtre Import Unity Package (Importer un package Unity) qui s'ouvre, cliquez sur Import (Importer).
De retour dans la console Firebase, dans le workflow de configuration, cliquez sur Suivant.
Étape 5 : Vérifiez la version requise des services Google Play
Certains produits du SDK Firebase Unity pour Android nécessitent Google Play services. Découvrez quels produits présentent cette dépendance. Google Play services doit être à jour pour que vous puissiez utiliser ces produits.
Ajoutez l'instruction using et le code d'initialisation suivants au début de votre application. Vous pouvez vérifier la version de Google Play services et, si nécessaire, la mettre à jour vers la version requise avant d'appeler d'autres méthodes dans le 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 fin prêt ! Votre projet Unity est enregistré et configuré pour utiliser Firebase.
Si vous rencontrez des difficultés lors de la configuration, consultez la page Dépannage et questions fréquentes sur Unity.
Configurer un workflow de bureau (bêta)
Lorsque vous créez un jeu, il est souvent beaucoup plus facile de le tester d'abord 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 workflow, nous fournissons un sous-ensemble des SDK Firebase Unity qui peuvent s'exécuter sous Windows, macOS, Linux et dans l'éditeur Unity.
Configurez un projet Unity pour une plate-forme de bureau en suivant les mêmes instructions que pour une plate-forme mobile (commencez par l'étape Enregistrer votre application auprès de Firebase ci-dessus).
Exécutez votre projet Unity dans l'IDE Unity ou sélectionnez l'option permettant de compiler votre projet Unity pour ordinateur.
(Facultatif) Exécutez votre projet Unity en mode Édition.
Le SDK Firebase Unity peut également être exécuté en mode Édition d'Unity, ce qui permet de l'utiliser dans les plug-ins de l'éditeur.
Lorsque vous créez une instance
FirebaseApputilisée par l'éditeur, n'utilisez pas l'instance par défaut.Indiquez plutôt un nom unique pour l'appel
FirebaseApp.Create().Cela 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 compatibles
Pour en savoir plus sur les bibliothèques Firebase pour Unity, consultez la documentation de référence.
Bibliothèques Firebase disponibles pour mobile
Le SDK Firebase Unity est compatible avec les produits Firebase suivants sur Apple et Android :
| Produit Firebase | Package Unity |
|---|---|
| AdMob | Distribué séparément dans le plug-in Unity AdMob |
| Firebase AI Logic | FirebaseAI.unitypackage |
| Analytics | FirebaseAnalytics.unitypackage |
| App Check | FirebaseAppCheck.unitypackage |
| Authentication | FirebaseAuth.unitypackage |
| Cloud Firestore | FirebaseFirestore.unitypackage |
| Cloud Functions | FirebaseFunctions.unitypackage |
| Cloud Messaging | FirebaseMessaging.unitypackage
(recommandé) FirebaseAnalytics.unitypackage
|
| Cloud Storage | FirebaseStorage.unitypackage |
| Crashlytics | FirebaseCrashlytics.unitypackage
(recommandé) FirebaseAnalytics.unitypackage
|
| Realtime Database | FirebaseDatabase.unitypackage |
| Remote Config | FirebaseRemoteConfig.unitypackage
(recommandé) FirebaseAnalytics.unitypackage
|
| BIBLIOTHÈQUES OBSOLÈTES OU NON COMPATIBLES | |
| Dynamic Links | FirebaseDynamicLinks.unitypackage
(recommandé) FirebaseAnalytics.unitypackage
|
Bibliothèques Firebase disponibles pour ordinateur
Le SDK Firebase Unity inclut la compatibilité avec le workflow pour ordinateur pour un sous-ensemble de produits, ce qui permet d'utiliser certaines parties de Firebase dans l'éditeur Unity et dans des builds autonomes pour ordinateur sous Windows, macOS et Linux.
| Produit Firebase (ordinateur) | Package Unity |
|---|---|
| Firebase AI Logic | FirebaseAI.unitypackage |
| App Check | FirebaseAppCheck.unitypackage |
| Authentication | FirebaseAuth.unitypackage |
| Cloud Functions | FirebaseFunctions.unitypackage |
| Cloud Firestore | FirebaseFirestore.unitypackage |
| Cloud Storage | FirebaseStorage.unitypackage |
| Realtime Database | FirebaseDatabase.unitypackage |
| Remote Config | FirebaseRemoteConfig.unitypackage |
Firebase fournit les autres bibliothèques de bureau en tant qu'implémentations de bouchon (non fonctionnelles) pour faciliter la compilation pour Windows, macOS et Linux. Par conséquent, vous n'avez pas besoin de compiler le code de manière conditionnelle pour cibler l'ordinateur.
Étapes suivantes
Découvrez des exemples d'applications Firebase.
Préparez-vous à lancer votre application :
- Configurez des alertes de budget pour votre projet dans la console Google Cloud.
- Surveillez le tableau de bord Utilisation et facturation dans la console Firebase pour obtenir une vue d'ensemble de l'utilisation de votre projet sur plusieurs services Firebase.
- Consultez la checklist de lancement de Firebase.
Vous rencontrez des problèmes avec Firebase et votre projet Unity ? Consultez les questions fréquentes et la page de dépannage Unity.