Configurar y abrir un Realm sincronizado - .NET SDK

Synced Realms vs. Non-Synced Realms

Synced realms differ from non-synced local Realm in a couple of ways:

• Synced realms attempt to sync changes with your backend App Services App, whereas non-synced realms do not.

• Synced realms can be accessed by authenticated users, while non-synced realms have no concept of users or authentication.

You can copy data from a non-synced realm to a synced realm, and vice versa, but you cannot sync a non-synced realm.

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.

Open a Synced Realm While Online

Los pasos para abrir un realm sincronizado mientras estás en linea son:

1. Your app code walks the user through authenticating.

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

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

4. Si tu FlexibleSyncConfiguration no contiene suscripciones iniciales, añade 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}");
}

In the above example, the code shows how to open the realm asynchronously by calling GetInstanceAsync(). You can also open a realm synchronously by calling the GetInstance() method:

var synchronousRealm = Realm.GetInstance(config);

Open a Synced Realm While Offline

Once a user authenticates, the User object persists on the device until the user logs off. This allows your app to retrieve an existing user and open a synced realm in an offline state. Changes that occur while offline will be synced by the SDK once the device reconnects to your App.

El siguiente código muestra cómo comprobar si existe un objeto User. Si no hay ninguno, utiliza el proceso que se indica arriba para obtener un usuario. Si el dispositivo ya tiene un user, se abre el realm 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
}

Configuring Timeouts with 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: the amount of time to allow for a connection to become fully established.

• ConnectionLingerTime: the amount of time to keep a connection open after all sessions have been abandoned.

• PingKeepAlivePeriod: the amount of time between each heartbeat ping message

• PongKeepAliveTimeout: el tiempo de espera para recibir una respuesta a un ping de latidos antes de concluir que la conexión se perdió.

• 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),
    },
};