Come archiviare le preferenze utente
Questo articolo illustra come archiviare le impostazioni dell'interfaccia utente dell'utente, note formalmente come preferenze utente, tramite le opzioni -preferenze e -onPreferencesChanged Strumento di lettura immersiva SDK.
Quando l'opzione CookiePolicy SDK è impostata su Abilitato, l'applicazione Strumento di lettura immersiva archivia le preferenze utente (dimensioni del testo, colore del tema, carattere e così via) nei cookie, che sono locali in un browser e un dispositivo specifici. Ogni volta che l'utente avvia il Strumento di lettura immersiva nello stesso browser e dispositivo, verrà aperto con le preferenze dell'utente dall'ultima sessione nel dispositivo. Tuttavia, se l'utente apre il Strumento di lettura immersiva in un browser o un dispositivo diverso, le impostazioni verranno inizialmente configurate con le impostazioni predefinite della Strumento di lettura immersiva e l'utente dovrà impostare di nuovo le proprie preferenze e così via per ogni dispositivo usato. Le -preferences opzioni e -onPreferencesChanged Strumento di lettura immersiva SDK consentono alle applicazioni di eseguire il roaming delle preferenze di un utente in vari browser e dispositivi, in modo che l'utente abbia un'esperienza coerente ovunque usino l'applicazione.
In primo luogo, fornendo l'opzione -onPreferencesChanged callback SDK durante l'avvio dell'applicazione Strumento di lettura immersiva, il Strumento di lettura immersiva invierà una -preferences stringa all'applicazione host ogni volta che l'utente modifica le proprie preferenze durante la sessione Strumento di lettura immersiva. L'applicazione host è quindi responsabile dell'archiviazione delle preferenze utente nel proprio sistema. Quando lo stesso utente avvia di nuovo il Strumento di lettura immersiva, l'applicazione host può recuperare le preferenze dell'utente dall'archiviazione e specificarle come -preferences opzione string SDK durante l'avvio dell'applicazione Strumento di lettura immersiva, in modo che le preferenze dell'utente vengano ripristinate.
Questa funzionalità può essere usata come mezzo alternativo per archiviare le preferenze utente nel caso in cui l'uso dei cookie non sia auspicabile o fattibile.
Attenzione
IMPORTANTE Non tentare di modificare a livello di codice i valori della -preferences stringa inviata a e dall'applicazione Strumento di lettura immersiva perché questo potrebbe causare un comportamento imprevisto che comporta un'esperienza utente danneggiata per i clienti. Le applicazioni host non devono mai assegnare un valore personalizzato a o modificare la -preferences stringa. Quando si usa l'opzione -preferences stringa, usare solo il valore esatto restituito dall'opzione -onPreferencesChanged di callback.
Come abilitare l'archiviazione delle preferenze utente
il parametro launchAsyncoptions di Strumento di lettura immersiva SDK contiene il -onPreferencesChanged callback. Questa funzione verrà chiamata ogni volta che l'utente modifica le proprie preferenze. Il value parametro contiene una stringa, che rappresenta le preferenze correnti dell'utente. Questa stringa viene quindi archiviata, per tale utente, dall'applicazione host.
const options = {
onPreferencesChanged: (value: string) => {
// Store user preferences here
}
};
ImmersiveReader.launchAsync(YOUR_TOKEN, YOUR_SUBDOMAIN, YOUR_DATA, options);
Come caricare le preferenze utente nel Strumento di lettura immersiva
Passare le preferenze dell'utente al Strumento di lettura immersiva usando l'opzione -preferences . Un esempio semplice per archiviare e caricare le preferenze dell'utente è il seguente:
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);
}
};