Configurar y abrir un dominio sincronizado - .NET SDK

Reinos sincronizados vs. Reinos no sincronizados

Los reinos sincronizados se diferencian de los reinos locales no sincronizados en un par de formas:

• Los reinos sincronizados intentan sincronizar los cambios con su aplicación de servicios de aplicaciones de backend, mientras que los reinos no sincronizados no lo hacen.

• Los usuarios autenticados pueden acceder a los reinos sincronizados, mientras que los reinos no sincronizados no tienen concepto de usuarios ni autenticación.

Puedes copiar datos de un reino no sincronizado a un reino sincronizado, y viceversa, pero no puedes sincronizar un reino no sincronizado.

Realms sincronizados

Para abrir un dominio sincronizado, debe tener un objeto de usuario autenticado. Para obtener una inicial User Por ejemplo, debe autenticarse en el backend de Atlas App Services, lo que requiere que el dispositivo esté en línea la primera vez que un usuario inicia sesión. Una vez que se ha producido la autenticación inicial, puede recuperar un usuario existente mientras está desconectado.

Abrir un reino sincronizado mientras estás en línea

Los pasos para abrir un reino sincronizado mientras estás en línea son:

1. El código de su aplicación guía al usuario a través del proceso de autenticación.

2. Crea un objeto FlexibleSyncConfiguration que incluya el objeto Usuario.

3. Abra un reino sincronizado llamando al método GetInstanceAsync().

4. Si su FlexibleSyncConfiguration no contenía suscripciones iniciales, agregue una suscripción.

El siguiente código demuestra estos pasos:

var app = App.Create("myRealmAppId");
var user = await app.LogInAsync(Credentials.Anonymous());
Realm realm;
var config = new FlexibleSyncConfiguration(user)
{
    PopulateInitialSubscriptions = (realm) =>
    {
        var allTasks = realm.All<MyTask>();
        realm.Subscriptions.Add(allTasks, new SubscriptionOptions { Name = "allTasks" });
    }
};
try
{
    realm = await Realm.GetInstanceAsync(config);
}
catch (Exception ex)
{
    Console.WriteLine($@"Error creating or opening the
        realm file. {ex.Message}");
}

En el ejemplo anterior, el código muestra cómo abrir el dominio de forma asincrónica llamando GetInstanceAsync() a. También puede abrir un dominio de forma sincrónica llamando al método GetInstance():

var synchronousRealm = Realm.GetInstance(config);

Abrir un reino sincronizado sin conexión

Una vez que un usuario se autentica, el User objeto permanece en el dispositivo hasta que cierra sesión. Esto permite que tu app recupere un usuario existente y abra un dominio sincronizado sin conexión. El SDK sincronizará los cambios que se produzcan sin conexión una vez que el dispositivo se vuelva a conectar a tu app.

El siguiente código muestra cómo comprobar si existe un objeto User. Si no se encuentra ninguno, se utiliza el proceso descrito anteriormente para obtener un usuario. Si el dispositivo ya tiene un user, se abre el dominio sincronizado con ese usuario:

var app = App.Create("myRealmAppId");
Realms.Sync.User user;
FlexibleSyncConfiguration config;
Realm realm;
if (app.CurrentUser == null)
{
    // App must be online for user to authenticate
    user = await app.LogInAsync(Credentials.Anonymous());
    config = new FlexibleSyncConfiguration(user);
    realm = Realm.GetInstance(config);
    // Go on to add or update subscriptions and use the realm
}
else 
{
    // This works whether online or offline
    // It requires a user to have been previously authenticated
    user = app.CurrentUser;
    config = new FlexibleSyncConfiguration(user);
    realm = Realm.GetInstance(config);
    // Go on to add or update subscriptions and use the realm
}

Configuración de tiempos de espera con AppConfiguration

Para un control detallado de la conexión de su aplicación, puede configurar SyncTimeoutOptions en el objeto AppConfiguration. Puede configurar las siguientes propiedades de tiempo de espera de sincronización:

• ConnectTimeout:la cantidad de tiempo necesaria para que una conexión se establezca por completo.

• ConnectionLingerTime:la cantidad de tiempo que se debe mantener abierta una conexión después de que se hayan abandonado todas las sesiones.

• PingKeepAlivePeriod:la cantidad de tiempo entre cada mensaje de ping de latido

• PongKeepAliveTimeout:la cantidad de tiempo que se debe esperar una respuesta a un ping de latido antes de concluir que la conexión se ha interrumpido.

• FastReconnectLimit: el tiempo transcurrido desde la pérdida de una conexión anterior para que una nueva conexión se considere una "reconexión rápida".

AppConfiguration configuration = new AppConfiguration("myRealmAppId")
{
    SyncTimeoutOptions = new SyncTimeoutOptions()
    {
        ConnectTimeout = TimeSpan.FromMinutes(2),
        ConnectionLingerTime = TimeSpan.FromSeconds(30),
        PingKeepAlivePeriod = TimeSpan.FromMinutes(1),
        PongKeepAliveTimeout = TimeSpan.FromMinutes(1),
        FastReconnectLimit = TimeSpan.FromMinutes(1),
    },
};