Ir a la consola

Primeros pasos con Firebase Realtime Database para Unity

Firebase Realtime Database almacena y sincroniza datos con nuestra base de datos NoSQL en la nube. Los datos se sincronizan con todos los clientes en tiempo real y se mantiene disponible cuando tu app está sin conexión.

Antes de comenzar

Sigue estos pasos para usar Realtime Database:

  • Registra tu proyecto de Unity y configúralo para usar Firebase.

    • Si tu proyecto de Unity ya usa Firebase, significa que ya está registrado y configurado para Firebase.

    • Si aún no tienes un proyecto de Unity, puedes descargar una app de muestra.

  • Agrega el SDK de Firebase Unity (en específico, FirebaseDatabase.unitypackage) al proyecto de Unity.

Ten en cuenta que agregar Firebase a tu proyecto de Unity implica realizar tareas en Firebase console y en tu proyecto abierto de Unity (por ejemplo, descargar archivos de configuración de Firebase desde la consola y moverlos a tu proyecto de Unity).

Configura el acceso público

Realtime Database proporciona un lenguaje de reglas declarativas que te permite definir cómo se deben estructurar tus datos, cómo se deben indexar y cuándo se pueden leer y escribir. Según la configuración predeterminada, el acceso de lectura y escritura a tu base de datos es restringido, por lo que solo los usuarios autenticados pueden leer o escribir datos. Para comenzar sin configurar Authentication, puedes definir tus reglas de acceso público. Esto hace que tus datos estén abiertos para todo el mundo, incluso las personas que no usan tu app, así que asegúrate de volver a restringir tu base de datos cuando configures la autenticación.

Cómo configurar el SDK para Unity Editor

Cuando pruebes tu escena en Unity Editor, puedes usar Realtime Database. Debes configurar el SDK con la URL de la base de datos apropiada. Llama a SetEditorDatabaseUrl con la URL de tu base de datos.

using Firebase;
using Firebase.Unity.Editor;

public class MyScript: MonoBehaviour {
  void Start() {
    // Set this before calling into the realtime database.
    FirebaseApp.DefaultInstance.SetEditorDatabaseUrl("https://YOUR-FIREBASE-APP.firebaseio.com/");
  }
}

Si decidiste usar el acceso público para tus reglas y estableciste la URL de la base de datos, puedes seguir con las secciones sobre el guardado y la recuperación de datos.

Opcional: Configuración de Editor para el acceso restringido

Si decides usar reglas que no permiten el acceso público, deberás configurar el SDK para usar una cuenta de servicio en la ejecución de Unity Editor. Esto te permitirá suplantar usuarios finales cuando hagas pruebas. Para esto, primero crea un archivo p12 nuevo a través de

https://console.cloud.google.com/iam-admin/serviceaccounts/project?project=YOUR-FIREBASE-APP

Registra el correo electrónico y la contraseña generados de la cuenta de servicio.

Ubica el archivo p12 en "Editor Default Resources" dentro de tu proyecto de Unity. A continuación, agrega el siguiente código para iniciar el uso de la cuenta de servicio.

using Firebase;
using Firebase.Unity.Editor;

public class MyScript: MonoBehaviour {
  void Start() {
    // Set these values before calling into the realtime database.
    FirebaseApp.DefaultInstance.SetEditorDatabaseUrl("https://YOUR-FIREBASE-APP.firebaseio.com/");
    FirebaseApp.DefaultInstance.SetEditorP12FileName("YOUR-FIREBASE-APP-P12.p12");
    FirebaseApp.DefaultInstance.SetEditorServiceAccountEmail("SERVICE-ACCOUNT-ID@YOUR-FIREBASE-APP.iam.gserviceaccount.com");
    FirebaseApp.DefaultInstance.SetEditorP12Password("notasecret");
  }
}

Pasos siguientes

Problemas conocidos

  • Cuando se usa el marco de trabajo experimental .NET 4.6, Realtime Database no se puede ejecutar en macOS con Unity 2017.2 debido a una regresión que se presentó en la versión 2017.2.0 y que desactivó SslStream en esa configuración. La regresión se solucionó en Unity 2017.3.0 y Realtime Database es compatible con esa versión.