Vorgehensweise: Speichern der Benutzereinstellungen
In diesem Artikel wird veranschaulicht, wie die Einstellungen der Benutzeroberfläche des Benutzers (Benutzereinstellungen) über die Optionen -preferences und -onPreferencesChanged des Immersive Reader SDK gespeichert werden können.
Wenn die SDK-Option CookiePolicy auf Aktiviert festgelegt ist, speichert die Immersive Reader-Anwendung die Benutzereinstellungen (Textgröße, Farbdesign, Schriftart usw.) in Cookies. Diese Cookies sind für einen bestimmten Browser und ein bestimmtes Gerät lokal gespeichert. Jedes Mal, wenn der Benutzer Immersive Reader in demselben Browser und auf demselben Gerät startet, wird der Dienst mit den Einstellungen des Benutzers aus seiner letzten Sitzung auf diesem Gerät geöffnet. Wenn der Benutzer die Immersive Reader-App jedoch in einem anderen Browser oder auf einem anderen Gerät öffnet, werden die Einstellungen zunächst mit den Standardeinstellungen von Immersive Reader konfiguriert, sodass der Benutzer für jedes verwendete Gerät seine Voreinstellungen neu festlegen muss. Die SDK-Optionen -preferences und -onPreferencesChanged des plastischen Readers bieten eine Möglichkeit für Anwendungen, die Voreinstellungen eines Benutzers über verschiedene Browser und Geräte hinweg per Roaming bereitzustellen, sodass der Benutzer eine konsistente Erfahrung hat, egal wo er die Anwendung verwendet.
Zunächst wird durch die Bereitstellung der SDK-Rückrufoption -onPreferencesChanged beim Start der Immersive Reader-Anwendung eine -preferences-Zeichenfolge an die Hostanwendung zurückgesendet, wenn der Benutzer seine Einstellungen während der Immersive Reader-Sitzung ändert. Die Hostanwendung ist dann für die Speicherung der Benutzereinstellungen in ihrem eigenen System verantwortlich. Wenn derselbe Benutzer dann den plastischen Reader erneut startet, kann die Hostanwendung die Einstellungen dieses Benutzers aus dem Speicher abrufen und sie als SDK-Zeichenfolgenoption -preferences beim Start der Plastischer Reader-Anwendung bereitstellen, sodass die Voreinstellungen des Benutzers wiederhergestellt werden.
Diese Funktionalität stellt eine alternative Möglichkeit zum Speichern der Benutzereinstellungen dar, wenn die Verwendung von Cookies nicht erwünscht oder nicht möglich ist.
Achtung
Versuchen Sie nicht, die Werte der -preferences-Zeichenfolge, die an die und von der Immersive Reader-Anwendung gesendet werden, programmgesteuert zu ändern, da dies zu unerwartetem Verhalten führen kann, das die Benutzerfreundlichkeit beeinträchtigt. Hostanwendungen sollten der Zeichenfolge -preferences niemals einen benutzerdefinierten Wert zuweisen oder sie manipulieren. Wenn Sie die Zeichenfolgenoption -preferences verwenden, verwenden Sie nur genau den Wert, der von der Rückrufoption -onPreferencesChanged zurückgegeben wurde.
Aktivieren der Speicherung von Benutzereinstellungen
Der Parameter launchAsyncoptions des Immersive Reader SDK enthält den Rückruf -onPreferencesChanged. Diese Funktion wird immer dann aufgerufen, wenn der Benutzer seine Voreinstellungen ändert. Der Parameter value enthält eine Zeichenfolge, die die aktuellen Einstellungen des Benutzers darstellt. Diese Zeichenfolge wird dann für diesen Benutzer von der Hostanwendung gespeichert.
const options = {
onPreferencesChanged: (value: string) => {
// Store user preferences here
}
};
ImmersiveReader.launchAsync(YOUR_TOKEN, YOUR_SUBDOMAIN, YOUR_DATA, options);
Laden der Benutzereinstellungen
Übergeben Sie die Benutzereinstellungen mithilfe der -preferences-Option an Immersive Reader. Nachfolgend finden Sie ein einfaches Beispiel zum Speichern und Laden der Benutzereinstellungen:
const storedUserPreferences = localStorage.getItem("USER_PREFERENCES");
let userPreferences = storedUserPreferences === null ? null : storedUserPreferences;
const options = {
preferences: userPreferences,
onPreferencesChanged: (value: string) => {
userPreferences = value;
localStorage.setItem("USER_PREFERENCES", userPreferences);
}
};