Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Synchronisieren von Benutzerdaten mit Cognito Sync

Mit Amazon Cognito Sync können Sie mobile Benutzerdaten (wie App-Benutzereinstellungen oder Spielstände) einfach in der AWS Cloud speichern, ohne dafür Backend-Code zu schreiben oder eine Infrastruktur zu verwalten. Sie können Daten lokal auf den Geräten der Benutzer speichern. So funktionieren Ihre Anwendungen auch dann, wenn die Geräte offline sind. Außerdem können Sie die Daten über die Geräte eines Benutzers synchronisieren und ein konsistentes App-Erlebnis schaffen – unabhängig vom verwendeten Gerät.

Das Tutorial unten erläutert, wie Sync in die App integriert werden kann.

Projekteinrichtung

Prerequisites

Befolgen Sie alle Anweisungen unter Einrichten von AWS Mobile SDK for .NET and Xamarin, bevor Sie mit diesem Tutorial beginnen.

Gewähren des Zugriffs auf Cognito Sync-Ressourcen

Die Standardrichtlinie, die den im Rahmen der Einrichtung erstellten Rollen für nicht authentifizierte und authentifizierte Benutzer zugeordnet ist, gewährt der Anwendung Zugriff auf Cognito Sync. Weitere Konfigurationsarbeiten sind nicht erforderlich.

Hinzufügen eines NuGet Pakets für Cognito Sync zu Ihrem Projekt

Befolgen Sie Schritt 4 der Anweisungen unter Einrichten von AWS Mobile SDK for .NET and Xamarin, um das SyncManager NuGet Cognito-Paket Ihrem Projekt hinzuzufügen.

Initialisieren des CognitoSyncManager

Übergeben Sie den initialisierten Amazon Cognito-Anmeldeinformationsanbieter an den CognitoSyncManager-Konstruktor:

CognitoSyncManager syncManager = new CognitoSyncManager (
    credentials,
    new AmazonCognitoSyncConfig {
        RegionEndpoint = RegionEndpoint.USEast1 // Region
    }
);

Synchronisieren von Benutzerdaten

Synchronisieren Sie die Daten nicht authentifizierter Benutzer wie folgt:

Erstellen eines Dataset

Erstellen Sie eine Instance von Dataset. Die openOrCreateDataset -Methode wird verwendet, um ein neues Dataset zu erstellen oder eine vorhandene Instance eines lokal auf dem Gerät gespeicherten Datasets zu öffnen:

Dataset dataset = syncManager.OpenOrCreateDataset("myDataset");

Hinzufügen von Benutzerdaten zum Dataset

Benutzerdaten werden in Form von Schlüssel-Wert-Paaren hinzugefügt:

dataset.OnSyncSuccess += SyncSuccessCallback;
dataset.Put("myKey", "myValue");

Cognito-Datasets fungieren als Wörterbücher, auf deren Werte mit einem Schlüssel zugegriffen werden kann:

string myValue = dataset.Get("myKey");

Synchronisieren von Datasets

Rufen Sie zum Synchronisieren eines Dataset die Synchronisierungsmethode auf:

dataset.SynchronizeAsync();

void SyncSuccessCallback(object sender, SyncSuccessEventArgs e) {
  // Your handler code here
}

Alle in Datasets geschriebenen Daten werden lokal gespeichert, bis das Dataset synchronisiert wird. Beim Code in diesem Abschnitt ist unterstellt, dass Sie eine nicht authentifizierte Cognito-Identität verwenden, damit die mit der Cloud synchronisierten Benutzerdaten auf jedem Gerät gespeichert werden. Dem Gerät ist eine Geräte-ID zugeordnet. Wenn die Benutzerdaten in die Cloud synchronisiert werden, werden sie mit dieser Geräte-ID verknüpft.

Weitere Informationen zu Cognito Sync erhalten Sie unter Amazon Cognito Sync.