Jak ukládat uživatelské předvolby

  • Článek
  • 2 min ke čtení

Tento článek ukazuje, jak uložit nastavení uživatelského rozhraní uživatele, formálně označované jako uživatelské předvolby, prostřednictvím možností -preferences a -onPreferencesChanged Asistivní čtečka SDK.

Pokud je možnost CookiePolicy SDK nastavená na Povoleno, uloží aplikace Asistivní čtečka uživatelské předvolby (velikost textu, barva motivu, písmo atd.) do souborů cookie, které jsou místní pro konkrétní prohlížeč a zařízení. Pokaždé, když uživatel spustí Asistivní čtečka ve stejném prohlížeči a zařízení, otevře se s předvolbami uživatele z poslední relace na tomto zařízení. Pokud ale uživatel otevře Asistivní čtečka v jiném prohlížeči nebo zařízení, nastavení se zpočátku konfiguruje s výchozím nastavením Asistivní čtečka a uživatel bude muset znovu nastavit předvolby a tak dále pro každé zařízení, které používá. Možnosti a Asistivní čtečka SDK poskytují aplikacím způsob, jak přecházet uživatelské předvolby mezi různými prohlížeči a zařízeními, aby měl uživatel konzistentní prostředí bez ohledu na to, kde aplikaci -preferences -onPreferencesChanged používá.

Nejprve poskytnutím možnosti sady SDK zpětného volání při spuštění aplikace Asistivní čtečka odešle Asistivní čtečka řetězec zpět do hostitelské aplikace pokaždé, když uživatel změní své předvolby během -onPreferencesChanged -preferences Asistivní čtečka relace. Hostitelská aplikace pak zodpovídá za ukládání uživatelských předvoleb do vlastního systému. Když pak stejný uživatel znovu spustí Asistivní čtečka, hostitelská aplikace může načíst předvolby tohoto uživatele z úložiště a zadat je jako možnost sady SDK řetězce při spuštění aplikace Asistivní čtečka, aby se předvolby uživatele -preferences obnovily.

Tato funkce se může používat jako alternativní způsob ukládání uživatelských předvoleb v případě, že používání souborů cookie není žádoucí nebo proveditelné.

Upozornění

DŮLEŽITÉ Nepokoušejte se měnit hodnoty řetězce odeslaného do a z aplikace Asistivní čtečka prostřednictvím kódu programu, protože by to mohlo způsobit neočekávané chování, které by pro vaše zákazníky způsobilo -preferences snížení uživatelského prostředí. Hostitelské aplikace by nikdy neměly přiřadit vlastní hodnotu k řetězci ani s ním -preferences manipulovat. Při použití možnosti řetězce použijte pouze přesnou hodnotu vrácenou z možnosti -preferences -onPreferencesChanged zpětného volání.

Jak povolit ukládání uživatelských předvoleb

Parametr Asistivní čtečka SDK launchAsync options obsahuje -onPreferencesChanged zpětné volání. Tato funkce se volá pokaždé, když uživatel změní své předvolby. Parametr obsahuje řetězec, který představuje aktuální předvolby value uživatele. Tento řetězec pak pro tohoto uživatele uloží hostitelská aplikace.

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

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

Jak načíst uživatelské předvolby do Asistivní čtečka

Předejte předvolby uživatele do Asistivní čtečka pomocí možnosti -preferences . Triviální příklad ukládání a načítání předvoleb uživatele je následující:

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

Další kroky