Felhasználói beállítások tárolása
Ez a cikk bemutatja, hogyan tárolhatja a felhasználó felhasználói felületének beállításait vagy felhasználói beállításait a -preferences és -onPreferencesChanged Modern olvasó SDK beállításain keresztül.
Ha a CookiePolicy SDK beállítás engedélyezve van, a Modern olvasó alkalmazás cookie-k használatával tárolja a felhasználói beállításokat, például a szövegméretet, a téma színét és a betűtípust. Ezek a cookie-k helyiek egy adott böngészőben és eszközön. Minden alkalommal, amikor a felhasználó ugyanabban a böngészőben és eszközön indítja el a Modern olvasó, megnyílik az eszköz utolsó munkamenetének beállításaival. Ha azonban a felhasználó egy másik böngészőben vagy eszközön nyitja meg a Modern olvasó alkalmazást, a beállítások kezdetben a Modern olvasó alapértelmezett beállításaival vannak konfigurálva, és a felhasználónak újra meg kell adnia a beállításokat minden egyes használt eszközhöz. -onPreferencesChanged A -preferences Modern olvasó és Modern olvasó SDK-lehetőségek lehetővé teszik az alkalmazások számára, hogy különböző böngészőkben és eszközökben mozogjanak a felhasználók preferenciái között, hogy a felhasználó egységes felhasználói élményt nyújtson bárhol, ahol az alkalmazást használja.
Először is, ha megadja a -onPreferencesChanged visszahívási SDK-lehetőséget a Modern olvasó alkalmazás indításakor, a Modern olvasó minden alkalommal visszaküld egy sztringet -preferences a gazdaalkalmazásnak, amikor a felhasználó módosítja a beállításokat a Modern olvasó munkamenet során. A gazdaalkalmazás feladata a felhasználói beállítások tárolása a saját rendszerében. Ezután, amikor ugyanaz a felhasználó újra elindítja a Modern olvasó, a gazdaalkalmazás lekérheti a felhasználó beállításait a tárolóból, és sztring SDK-beállításként -preferences adhatja meg őket a Modern olvasó alkalmazás indításakor, hogy a felhasználó beállításai visszaállítva legyenek.
Ez a funkció alternatív eszközként használható a felhasználói beállítások tárolására, ha a cookie-k használata nem kívánatos vagy megvalósítható.
Figyelemfelhívás
Ne kísérelje meg programozott módon módosítani a Modern olvasó alkalmazásba és onnan küldött sztring értékeit-preferences, mert ez váratlan viselkedést okozhat, ami csökkentett felhasználói élményt eredményezhet. A gazdagépalkalmazások soha nem rendelnek egyéni értéket a sztringhez, és nem módosíthatják azt -preferences . A sztringbeállítás -preferences használatakor csak a visszahívási beállításból -onPreferencesChanged visszaadott pontos értéket használja.
Felhasználói beállítások tárolásának engedélyezése
Az Modern olvasó SDK launchAsyncoptions paraméter tartalmazza a visszahívást-onPreferencesChanged. Ez a függvény akkor lesz meghívva, amikor a felhasználó módosítja a beállításokat. A value paraméter egy sztringet tartalmaz, amely a felhasználó aktuális beállításait jelöli. Ezt a sztringet ezután a gazdaalkalmazás tárolja a felhasználó számára.
const options = {
onPreferencesChanged: (value: string) => {
// Store user preferences here
}
};
ImmersiveReader.launchAsync(YOUR_TOKEN, YOUR_SUBDOMAIN, YOUR_DATA, options);
Felhasználói beállítások betöltése
Adja meg a felhasználó beállításait az Modern olvasó alkalmazásnak a -preferences beállítás használatával. A felhasználó beállításainak tárolására és betöltésére szolgáló egyszerű példa a következő:
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);
}
};