Lagra användarinställningar

  • Artikel
  • 2 minuter för att läsa

Den här artikeln visar hur du lagrar användarens UI-inställningar, formellt kallade användarinställningar, via alternativen -preferences och -onPreferencesChanged Avancerad läsare SDK.

När alternativet CookiePolicy SDK är inställt på Aktiverad lagrar Avancerad läsare-programmet användarinställningarna (textstorlek, temafärg, teckensnitt och så vidare) i cookies, som är lokala för en specifik webbläsare och enhet. Varje gång användaren startar Avancerad läsare på samma webbläsare och enhet öppnas den med användarens inställningar från den senaste sessionen på enheten. Men om användaren öppnar Avancerad läsare i en annan webbläsare eller enhet konfigureras inställningarna först med Avancerad läsare:s standardinställningar och användaren måste ange sina inställningar igen och så vidare för varje enhet som de använder. Sdk-Avancerad läsare och ger ett sätt för program att roama en användares inställningar över olika webbläsare och enheter, så att användaren får en konsekvent upplevelse oavsett var de -preferences -onPreferencesChanged använder programmet.

Genom att ange SDK-alternativet för återanrop när Avancerad läsare-programmet startas skickar Avancerad läsare en sträng tillbaka till värdprogrammet varje gång användaren ändrar sina inställningar -onPreferencesChanged -preferences under Avancerad läsare sessionen. Värdprogrammet ansvarar sedan för att lagra användarinställningarna i sitt eget system. När samma användare sedan startar Avancerad läsare igen kan värdprogrammet hämta användarens inställningar från lagringen och ange dem som sträng-SDK-alternativet när Avancerad läsare-programmet startas, så att användarens inställningar -preferences återställs.

Den här funktionen kan användas som ett alternativt sätt att lagra användarinställningar om det inte är önskvärt eller möjligt att använda cookies.

Varning

VIKTIGT Försök inte att programmatiskt ändra värdena för strängen som skickas till och från Avancerad läsare-programmet eftersom detta kan orsaka oväntat beteende, vilket resulterar i en försämrad användarupplevelse för -preferences dina kunder. Värdprogram bör aldrig tilldela ett anpassat värde till eller ändra -preferences strängen. När du använder -preferences strängalternativet använder du bara det exakta värdet som returnerades från -onPreferencesChanged återanropsalternativet.

Så här aktiverar du lagring av användarinställningar

parametern Avancerad läsare SDK launchAsync options innehåller -onPreferencesChanged återanropet. Den här funktionen anropas varje gång användaren ändrar sina inställningar. Parametern value innehåller en sträng som representerar användarens aktuella inställningar. Den här strängen lagras sedan av värdprogrammet för den användaren.

const options = {
    onPreferencesChanged: (value: string) => {
        // Store user preferences here
    }
};

ImmersiveReader.launchAsync(YOUR_TOKEN, YOUR_SUBDOMAIN, YOUR_DATA, options);

Läsa in användarinställningar i Avancerad läsare

Skicka in användarens inställningar till Avancerad läsare med hjälp av -preferences alternativet . Ett enkelt exempel för att lagra och läsa in användarens inställningar är följande:

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

Nästa steg