Configurar e abrir um Realm sincronizado - .NET SDK

Realms sincronizados versus Realms não sincronizados

Os domínios sincronizados diferem dos Realm locais não sincronizados de algumas maneiras:

• Os realms sincronizados tentam sincronizar as alterações com os aplicativos de backend do App Services, enquanto os realms não sincronizados, não.

• Os realms sincronizados podem ser acessados por usuários autenticados, enquanto os realms não sincronizados não têm nenhum conceito de usuários ou autenticação.

Você pode copiar dados de um domínio não sincronizado para um domínio sincronizado e vice-versa, mas não é possível sincronizar um domínio não sincronizado.

Domínios sincronizados

Para abrir um Realm sincronizado, você deve ter um objeto de usuário autenticado. Para obter uma instância inicial do User , você precisa autenticar no backend do Atlas App Services , que exige que o dispositivo esteja online na primeira vez que um usuário fizer login. Após a autenticação inicial, você poderá recuperar um usuário existente enquanto estiver off-line.

Abrir um Realm sincronizado enquanto estiver online

As etapas para abrir um Realm sincronizado enquanto estiver online são:

1. O código do seu aplicativo orienta o usuário na autenticação.

2. Crie um objeto FlexibleSyncConfiguration que inclua o objeto de usuário .

3. Abra um Realm sincronizado chamando o método GetInstanceAsync() .

4. Se sua FlexibleSyncConfiguration não continha assinaturas iniciais, adicione uma assinatura.

O seguinte código demonstra estas etapas:

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}");
}

No exemplo acima, o código mostra como abrir o domínio de forma assíncrona chamando GetInstanceAsync(). Você também pode abrir um domínio de forma síncrona chamando o método GetInstance() :

var synchronousRealm = Realm.GetInstance(config);

Abrir um Realm sincronizado enquanto estiver offline

Após o usuário autenticar, o objeto User persiste no dispositivo até que o usuário faça logout. Isso permite que seu aplicativo recupere um usuário existente e abra um Realm sincronizado em um estado offline. As alterações que ocorrem enquanto estiver offline serão sincronizadas pelo SDK assim que o dispositivo for reconectado ao seu aplicativo.

O código a seguir mostra como verificar se há um objeto User existente. Se nenhum for encontrado, ele usará o processo descrito sobre para obter um usuário. If the device already has a user, it opens the synced realm with that user:

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
}

Configurar tempos limite com AppConfiguration

Para controle granular da conexão do seu aplicativo, você pode definir o SyncTimeoutOptions no objeto AppConfiguration . Você pode definir as seguintes propriedades de tempo limite de sincronização:

• ConnectTimeout: a quantidade de tempo para permitir que uma conexão se torne totalmente estabelecida.

• ConnectionLingerTime: a quantidade de tempo para manter uma conexão aberta depois que todas as sessões tiverem sido interrompidas.

• PingKeepAlivePeriod: a quantidade de tempo entre cada mensagem de ping de pulsação

• PongKeepAliveTimeout: a quantidade de tempo para aguardar uma resposta a um ping de pulsação antes de concluir que a conexão falhou.

• FastReconnectLimit: o tempo desde a perda de uma conexão anterior para que uma nova conexão seja considerada uma "reconexão 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),
    },
};