Kullanıcı tercihlerini depolama

  • Makale
  • Okumak için 2 dakika

Bu makalede, -preferences ve -onPreferencesChanged Tam Ekran Okuyucu SDK seçenekleri aracılığıyla, kullanıcı arabirimi ayarlarının (resmi olarak kullanıcı tercihleri olarak bilinir) nasıl depolan Tam Ekran Okuyucu açıklanmıştır.

CookiePolicy SDK'sı seçeneği Etkin olarak ayarlanırsa, Tam Ekran Okuyucu uygulaması kullanıcı tercihlerini (metin boyutu, tema rengi, yazı tipi, gibi) tanımlama bilgilerinde depolar ve bunlar belirli bir tarayıcı ve cihaz için yereldir. Kullanıcı aynı tarayıcıda ve Tam Ekran Okuyucu cihazı her başlatsa, o cihaz üzerinde son oturumundan kullanıcının tercihleriyle açılır. Ancak, kullanıcı Tam Ekran Okuyucu'yi farklı bir tarayıcıda veya cihazda açarsa, ayarlar başlangıçta Tam Ekran Okuyucu'nin varsayılan ayarlarıyla yapılandırılır ve kullanıcının tercihlerini yeniden ayarlaması gerekir ve bu şekilde her cihaz için bu şekilde devam etmek zorunda olur. ve Tam Ekran Okuyucu SDK'sı seçenekleri, uygulamaların bir kullanıcının tercihlerini çeşitli tarayıcılar ve cihazlar arasında dolasmalarına ve böylece kullanıcının uygulamayı her ne olursa olsun tutarlı bir deneyime sahip olması için bir yol -preferences -onPreferencesChanged sağlar.

İlk olarak, Tam Ekran Okuyucu uygulamasını başlatma sırasında geri çağırma SDK'sı seçeneğini belirterek Tam Ekran Okuyucu, Tam Ekran Okuyucu oturumu sırasında kullanıcı tercihlerini her değiştirirken ana bilgisayar uygulamasına -onPreferencesChanged -preferences bir dize Tam Ekran Okuyucu gönderir. Daha sonra konak uygulama, kullanıcı tercihlerini kendi sisteminde depolamakla sorumludur. Ardından, aynı kullanıcı Tam Ekran Okuyucu'ı yeniden başlattında, ana bilgisayar uygulaması depolamadan kullanıcının tercihlerini alabilir ve Tam Ekran Okuyucu uygulamasını başlatan dize SDK'sı seçeneği olarak bunları sağlar, böylece kullanıcının tercihleri geri -preferences yüklenir.

Bu işlevsellik, tanımlama bilgilerini kullanmanın istenmeyen veya uygulanabilir bir durum olması durumunda kullanıcı tercihlerini depolamak için alternatif bir yol olarak kullanılabilir.

Dikkat

ÖNEMLİ Tam Ekran Okuyucu uygulamasına gönderilen dizenin değerlerini program aracılığıyla değiştirmeye çalışmayın çünkü bu beklenmeyen davranışlara neden olabilir ve bu da müşterileriniz için kullanıcı deneyiminin bozulmasına -preferences neden olabilir. Konak uygulamaları asla dizeye özel bir değer atamalı veya dizeyi -preferences işlemeli. Dize seçeneğini -preferences kullanırken yalnızca geri çağırma seçeneğinden döndürülen tam değeri -onPreferencesChanged kullanın.

Kullanıcı tercihlerini depolamayı etkinleştirme

Tam Ekran Okuyucu SDK launchAsync options parametresi geri -onPreferencesChanged çağırmayı içerir. Bu işlev, kullanıcı tercihlerini her değiştirirken çağrılır. parametresi, value kullanıcının geçerli tercihlerini temsil eden bir dize içerir. Bu dize daha sonra konak uygulama tarafından bu kullanıcı için depolanır.

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

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

Kullanıcı tercihlerini Tam Ekran Okuyucu

Seçeneğini kullanarak kullanıcının tercihlerini Tam Ekran Okuyucu -preferences iletir. Kullanıcının tercihlerini depolamak ve yüklemek için önemsiz bir örnek aşağıdaki gibidir:

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

Sonraki adımlar