获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

Agrega Firebase a tu proyecto de Unity

Mejora tus juegos de Unity con nuestros SDK de Firebase Unity.

Para mostrar lo fácil que es conectar Firebase a su proyecto de Unity, creamos un juego de muestra, MechaHamster, que puede descargar desde GitHub , App Store y Google Play Store .

MechaHamster (GitHub)

MechaHamster (Tienda de aplicaciones)

MechaHamster (Play Store)


Obtén más información sobre cómo potenciar tus juegos con Firebase en nuestra página de juegos de Firebase.

¿Ya agregó Firebase a su proyecto de Unity? Asegúrate de estar usando la versión más reciente del SDK de Firebase Unity .

requisitos previos

  • Instale Unity 2019.1 o posterior. Las versiones anteriores también pueden ser compatibles, pero no se admitirán activamente. La compatibilidad con Unity 2019.1 se considera obsoleta y ya no se admitirá activamente después de la próxima versión principal.

  • (Solo iOS) Instale lo siguiente:

    • Xcode 13.3.1 o superior
    • CocoaPods 1.10.0 o superior
  • Asegúrate de que tu proyecto de Unity cumpla con estos requisitos:

    • Para iOS : apunta a iOS 11 o superior
    • Para Android : apunta al nivel de API 19 (KitKat) o superior
  • Configure un dispositivo físico o use un emulador para ejecutar su aplicación.

    • Para iOS : configure un dispositivo iOS físico o use el simulador de iOS.

    • Para Android : los emuladores deben usar una imagen de emulador con Google Play.

Si aún no tiene un proyecto de Unity y solo desea probar un producto de Firebase, puede descargar uno de nuestros ejemplos de inicio rápido .

Paso 1 : crea un proyecto de Firebase

Antes de poder agregar Firebase a su proyecto de Unity, debe crear un proyecto de Firebase para conectarse a su proyecto de Unity. Visite Comprender los proyectos de Firebase para obtener más información sobre los proyectos de Firebase.

Paso 2 : Registre su aplicación con Firebase

Puede registrar una o más aplicaciones o juegos para conectarse con su proyecto de Firebase.

  1. Ve a la consola de Firebase .

  2. En el centro de la página de descripción general del proyecto, haga clic en el ícono de Unity ( ) para iniciar el flujo de trabajo de configuración.

    Si ya agregó una aplicación a su proyecto de Firebase, haga clic en Agregar aplicación para mostrar las opciones de la plataforma.

  3. Seleccione el objetivo de compilación de su proyecto de Unity que le gustaría registrar, o incluso puede seleccionar registrar ambos objetivos ahora al mismo tiempo.

  4. Ingresa los ID específicos de la plataforma de tu proyecto de Unity.

    • Para iOS : ingresa el ID de iOS de tu proyecto de Unity en el campo de ID del paquete de iOS.

    • Para Android : ingrese el ID de Android de su proyecto de Unity en el campo de nombre del paquete de Android.
      Los términos nombre del paquete e ID de la aplicación a menudo se usan indistintamente.

  5. (Opcional) Ingresa los apodos específicos de la plataforma de tu proyecto de Unity.
    Estos apodos son identificadores de conveniencia internos y solo son visibles para usted en la consola de Firebase.

  6. Haga clic en Registrar aplicación .

Paso 3 : Agregar archivos de configuración de Firebase

  1. Obtenga los archivos de configuración de Firebase específicos de su plataforma en el flujo de trabajo de configuración de la consola de Firebase.

    • Para iOS : haga clic en Descargar GoogleService-Info.plist .

    • Para Android : haga clic en Descargar google-services.json .

  2. Abra la ventana Proyecto de su proyecto de Unity, luego mueva sus archivos de configuración a la carpeta Assets .

  3. De vuelta en Firebase console, en el flujo de trabajo de configuración, haga clic en Siguiente .

Paso 4 : Agregar SDK de Firebase Unity

  1. En Firebase console, haga clic en Descargar Firebase Unity SDK y luego descomprima el SDK en algún lugar conveniente.

    • Puede volver a descargar el SDK de Firebase Unity en cualquier momento.

    • El SDK de Firebase Unity no es específico de la plataforma.

  2. En su proyecto de Unity abierto, vaya a Activos > Importar paquete > Paquete personalizado .

  3. Desde el SDK descomprimido, seleccione los productos compatibles de Firebase que desea usar en su aplicación.

    Análisis habilitado

    • Agregue el paquete de Firebase para Google Analytics: FirebaseAnalytics.unitypackage
    • Agregue los paquetes para cualquier otro producto de Firebase que desee usar en su aplicación. Por ejemplo, para usar Firebase Authentication y Firebase Realtime Database:
      FirebaseAuth.unitypackage y FirebaseDatabase.unitypackage

    Análisis no habilitado

    Agregue los paquetes para los productos de Firebase que desea usar en su aplicación. Por ejemplo, para usar Firebase Authentication y Firebase Realtime Database:
    FirebaseAuth.unitypackage y FirebaseDatabase.unitypackage

  4. En la ventana Importar paquete de Unity , haga clic en Importar .

  5. De vuelta en Firebase console, en el flujo de trabajo de configuración, haga clic en Siguiente .

Paso 5 : Confirme los requisitos de versión de los servicios de Google Play

El SDK de Firebase Unity para Android requiere los servicios de Google Play , que deben estar actualizados antes de que se pueda usar el SDK.

Agregue el siguiente código al comienzo de su aplicación. Puede verificar y, opcionalmente, actualizar los servicios de Google Play a la versión que requiere el SDK de Firebase Unity antes de llamar a cualquier otro método en el 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ás listo! Tu proyecto de Unity está registrado y configurado para usar Firebase.

Sin embargo, si tienes problemas para configurarlo, visita la sección de Preguntas frecuentes y resolución de problemas de Unity .

Configurar un flujo de trabajo de escritorio ( beta )

Cuando está creando un juego, a menudo es mucho más fácil probar su juego en el editor de Unity y en plataformas de escritorio primero, luego implementarlo y probarlo en dispositivos móviles más adelante en el desarrollo. Para respaldar este flujo de trabajo, proporcionamos un subconjunto de los SDK de Firebase Unity que pueden ejecutarse en Windows, macOS, Linux y desde el editor de Unity.

  1. Configure un proyecto de Unity para una plataforma de escritorio siguiendo las mismas instrucciones que para una plataforma móvil (comience con el paso anterior Registre su aplicación con Firebase ).

  2. Ejecute su proyecto de Unity en el IDE de Unity o seleccione para compilar su proyecto de Unity para escritorio .

  3. (Opcional) Ejecute su proyecto de Unity en modo de edición.

    El SDK de Firebase Unity también se puede ejecutar en el modo de edición de Unity, lo que permite su uso en los complementos del editor.

    1. Cuando crea una FirebaseApp que usa el editor, no use la instancia predeterminada.

    2. En su lugar, proporcione un nombre único a la llamada FirebaseApp.Create() .

      Esto es importante para evitar un conflicto en las opciones entre la instancia utilizada por el IDE de Unity y la instancia utilizada por su proyecto de Unity.

Productos de Firebase admitidos

Obtén más información sobre las bibliotecas de Unity Firebase en la documentación de referencia .

El SDK de Firebase Unity es compatible con los siguientes productos de Firebase en iOS y Android :

producto base de fuego Paquete de unidad
AdMob Distribuido por separado en el complemento AdMob Unity
Analítica FirebaseAnalytics.unitypackage
Autenticación FirebaseAuth.unitypackage
Tienda de fuego en la nube FirebaseFirestore.unitypackage
Funciones en la nube FirebaseFunctions.unitypackage
Mensajería en la nube FirebaseMessaging.unitypackage
(recomendado) FirebaseAnalytics.unitypackage
Almacenamiento en la nube FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(recomendado) FirebaseAnalytics.unitypackage
Enlaces dinámicos FirebaseDynamicLinks.unitypackage
(recomendado) FirebaseAnalytics.unitypackage
Base de datos en tiempo real FirebaseDatabase.unitypackage
Configuración remota FirebaseRemoteConfig.unitypackage
(recomendado) FirebaseAnalytics.unitypackage

Productos de Firebase admitidos (escritorio)

El SDK de Firebase Unity incluye soporte de flujo de trabajo de escritorio para un subconjunto de productos, lo que permite usar ciertas partes de Firebase en el editor de Unity y en compilaciones de escritorio independientes en Windows, macOS y Linux.

Producto Firebase (escritorio) Paquete de unidad
Autenticación FirebaseAuth.unitypackage
Funciones en la nube FirebaseFunctions.unitypackage
Tienda de fuego en la nube FirebaseFirestore.unitypackage
Almacenamiento en la nube FirebaseStorage.unitypackage
Base de datos en tiempo real FirebaseDatabase.unitypackage
Configuración remota FirebaseRemoteConfig.unitypackage

Firebase proporciona las bibliotecas de escritorio restantes como implementaciones auxiliares (no funcionales) para mayor comodidad al compilar para Windows, macOS y Linux. Por lo tanto, no necesita compilar código de forma condicional para apuntar al escritorio.

Próximos pasos