Gebruikersvoorkeuren opslaan
In dit artikel wordt gedemonstreerd hoe u de ui-instellingen van de gebruiker, formeel ook wel gebruikersvoorkeuren genoemd, kunt opslaan via de opties -preferences en -onPreferencesChanged Insluitende lezer SDK.
Wanneer de optie CookiePolicy SDK is ingesteld op Ingeschakeld, slaat de Insluitende lezer-toepassing de gebruikersvoorkeuren (tekstgrootte, themakleur, lettertype, e.d.) op in cookies, die lokaal zijn voor een specifieke browser en een specifiek apparaat. Telkens als de gebruiker de Insluitende lezer in dezelfde browser en hetzelfde apparaat start, wordt deze geopend met de voorkeuren van de gebruiker van de laatste sessie op dat apparaat. Als de gebruiker de Insluitende lezer echter opent in een andere browser of op een ander apparaat, worden de instellingen in eerste instantie geconfigureerd met de standaardinstellingen van de Insluitende lezer. De gebruiker moet de voorkeuren opnieuw instellen, bijvoorbeeld voor elk apparaat dat hij of zij gebruikt. De opties -preferences en Insluitende lezer SDK bieden een manier voor toepassingen om de voorkeuren van een gebruiker te roamen in verschillende browsers en apparaten, zodat de gebruiker een consistente ervaring heeft waar ze de toepassing -onPreferencesChanged ook gebruiken.
Door eerst de callback-SDK-optie op te geven bij het starten van de Insluitende lezer-toepassing, stuurt de Insluitende lezer een tekenreeks terug naar de hosttoepassing telkens wanneer de gebruiker tijdens de Insluitende lezer-sessie zijn -onPreferencesChanged -preferences voorkeuren wijzigt. De hosttoepassing is vervolgens verantwoordelijk voor het opslaan van de gebruikersvoorkeuren in hun eigen systeem. Wanneer dezelfde gebruiker vervolgens de Insluitende lezer opnieuw start, kan de hosttoepassing de voorkeuren van die gebruiker ophalen uit de opslag en deze opgeven als de SDK-optie voor de tekenreeks bij het starten van de Insluitende lezer-toepassing, zodat de voorkeuren van de gebruiker worden -preferences hersteld.
Deze functionaliteit kan worden gebruikt als een alternatieve manier om gebruikersvoorkeuren op te slaan in het geval dat het gebruik van cookies niet wenselijk of haalbaar is.
Waarschuwing
BELANGRIJK Probeer niet programmatisch de waarden te wijzigen van de tekenreeks die wordt verzonden naar en van de Insluitende lezer-toepassing, omdat dit onverwacht gedrag kan veroorzaken, wat kan leiden tot een gedegradeerde gebruikerservaring voor -preferences uw klanten. Hosttoepassingen mogen nooit een aangepaste waarde toewijzen aan de tekenreeks of deze -preferences bewerken. Wanneer u de -preferences tekenreeksoptie gebruikt, gebruikt u alleen de exacte waarde die is geretourneerd door de -onPreferencesChanged callback-optie.
Gebruikersvoorkeuren opslaan inschakelen
de Insluitende lezer SDK launchAsync bevat options de -onPreferencesChanged callback. Deze functie wordt aangeroepen wanneer de gebruiker zijn of haar voorkeuren wijzigt. De value parameter bevat een tekenreeks die de huidige voorkeuren van de gebruiker vertegenwoordigt. Deze tekenreeks wordt vervolgens voor die gebruiker opgeslagen door de hosttoepassing.
const options = {
onPreferencesChanged: (value: string) => {
// Store user preferences here
}
};
ImmersiveReader.launchAsync(YOUR_TOKEN, YOUR_SUBDOMAIN, YOUR_DATA, options);
Gebruikersvoorkeuren laden in de Insluitende lezer
Geef de voorkeuren van de gebruiker door aan de Insluitende lezer met behulp van de -preferences optie . Een eenvoudig voorbeeld voor het opslaan en laden van de voorkeuren van de gebruiker is als volgt:
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);
}
};