Cara menyimpan preferensi pengguna
Artikel ini menunjukkan cara menyimpan pengaturan UI pengguna, atau preferensi pengguna, melalui opsi -preferences dan -onPreferencesChanged Pembaca Imersif SDK.
Ketika opsi CookiePolicy SDK diatur ke Diaktifkan, aplikasi Pembaca Imersif menyimpan preferensi pengguna, seperti ukuran teks, warna tema, dan font, dengan menggunakan cookie. Cookie ini bersifat lokal untuk browser dan perangkat tertentu. Setiap kali pengguna meluncurkan Pembaca Imersif di browser dan perangkat yang sama, pengguna akan terbuka dengan preferensi pengguna dari sesi terakhir mereka di perangkat tersebut. Namun, jika pengguna membuka aplikasi Pembaca Imersif di browser atau perangkat yang berbeda, pengaturan awalnya dikonfigurasi dengan pengaturan default Pembaca Imersif, dan pengguna perlu mengatur preferensi mereka lagi untuk setiap perangkat yang mereka gunakan. Opsi -preferences dan -onPreferencesChanged Immersive Reader SDK menyediakan cara bagi aplikasi untuk menjelajahi preferensi pengguna di berbagai browser dan perangkat, sehingga pengguna memiliki pengalaman yang konsisten di mana pun mereka menggunakan aplikasi.
Pertama, dengan menyediakan -onPreferencesChanged opsi SDK panggilan balik saat meluncurkan aplikasi Pembaca Imersif, Pembaca Imersif mengirim -preferences string kembali ke aplikasi host setiap kali pengguna mengubah preferensi mereka selama sesi Pembaca Imersif. Aplikasi host kemudian bertanggung jawab untuk menyimpan preferensi pengguna di sistem mereka sendiri. Lalu, ketika pengguna yang sama meluncurkan kembali Immersive Reader, aplikasi host dapat mengambil preferensi pengguna tersebut dari penyimpanan, dan menyediakannya sebagai opsi SDK untai -preferences saat meluncurkan aplikasi Immersive Reader, sehingga preferensi pengguna dipulihkan.
Fungsionalitas ini dapat digunakan sebagai sarana alternatif untuk menyimpan preferensi pengguna saat menggunakan cookie tidak diinginkan atau layak.
Perhatian
Jangan mencoba mengubah nilai -preferences string yang dikirim ke dan dari aplikasi Pembaca Imersif secara terprogram karena ini dapat menyebabkan perilaku tak terduga yang mengakibatkan pengalaman pengguna yang terdegradasi. Aplikasi host tidak boleh menetapkan nilai kustom atau memanipulasi untai -preferences. Saat menggunakan opsi untai -preferences, gunakan hanya nilai persis yang dikembalikan dari opsi panggilan balik -onPreferencesChanged.
Mengaktifkan penyimpanan preferensi pengguna
Parameter launchAsyncoptions Pembaca Imersif SDK berisi -onPreferencesChanged panggilan balik. Fungsi ini akan dipanggil setiap kali pengguna mengubah preferensi mereka. Parameter value berisi untai, yang mewakili preferensi pengguna saat ini. Untai ini lalu disimpan untuk pengguna tersebut oleh aplikasi host.
const options = {
onPreferencesChanged: (value: string) => {
// Store user preferences here
}
};
ImmersiveReader.launchAsync(YOUR_TOKEN, YOUR_SUBDOMAIN, YOUR_DATA, options);
Memuat preferensi pengguna
Teruskan preferensi pengguna ke aplikasi Pembaca Imersif dengan menggunakan -preferences opsi . Contoh mudah untuk menyimpan dan memuat preferensi pengguna adalah sebagai berikut:
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);
}
};