Standart pazar yerinde, kullanıcının uygulamayla etkileşim kurduğu baskın yöntem telefon uygulamasıdır.
Kadran ayarlama
Kullanıcı telefon uygulamasında bir kadran seçtiğinde, kadranı ayarlamak için sonraki akış iki bölümden oluşur:
- Yükleme:
MessageClient
üzerinden başlatılan Watch Face Push'u kullanarak kadranı yükleyin. Bu adım, telefondan kol saatineMessageClient
kullanılarak tetiklenenaddWatchFace
veyaupdateWatchFace
ile kolayca gerçekleştirilir. - Etkinleştirme: Yüklenen kadranı etkin olarak ayarlayın. Bu adımda, izin durumuna bağlı olarak birkaç olası yol vardır:
- Herhangi bir işlem yapmanız gerekmiyor olabilir. Pazar yeri, etkin kadranı kontrol ediyor olabilir.
- Kullanıcı müdahalesi gerekmiyor olabilir. Uygulama, etkin kadranı ayarlamak için gerekli izinlere sahiptir ve bunu doğrudan
setWatchFaceAsActive()
kullanarak yapabilir. - İzin isteklerinin nasıl kabul edileceği veya uzun basma hareketi ya da tamamlayıcı bir uygulama aracılığıyla saat yüzünün nasıl manuel olarak ayarlanacağı konusunda rehberliğe ihtiyaç duyulabilir.
Yükleme yanıtı
Etkinleştirme aşamasını kolaylaştırmak için Yükleme aşamasında saatten telefona aşağıdaki bilgiler döndürülmelidir:
- Yükleme denemesinin sonucu
isWatchFaceActive()
işleminin sonucu: Uygulamada etkin kadranın olup olmadığını belirlemek için kullanılır.setWatchFaceAsActive()
'nın daha önce çağrılıp çağrılmadığı. Wear OS uygulaması bu bilgileri yerel olarak izlemeli ve kalıcı hale getirmelidir. Bu API çağrısı yalnızca bir kez kullanılabilir.
Etkinleştirme
Yükleme işleminden sonra yanıt, uygulamada zaten etkin bir kadran olduğunu belirtebilir. Ancak bu durum söz konusu değilse uygulama, saat yüzünü etkin olarak ayarlamak için bir düğme göstermeyi tercih edebilir.
Senaryo 1: Etkin kadranı ayarlama girişimlerinin tümü başarısız oldu
Yüklemeden gelen yanıt, setWatchFaceAsActive()
'nın daha önce çağrıldığını gösteriyorsa düğme, telefonda bir eğitim ekranına yönlendirmelidir. Bu ekranda, kullanıcılara istedikleri saat yüzünü manuel olarak ayarlamak için saat yüzüne dokunup basılı tutmaları gerektiği gösterilir.
2. senaryo: Etkin kadranı ayarlamaya çalışın
Telefon, saate gerekli SET_PUSHED_WATCH_FACE_AS_ACTIVE
iznini kontrol etmesi talimatını vermelidir:
- Kullanıcı izni daha önce verdiyse setWatchFaceAsActive() işlevini çağırarak devam edin.
- Kullanıcı izni daha önce reddettiyse kol saati bunu telefona geri bildirmeli. Telefonda, izin ihtiyacını ve iznin nasıl manuel olarak verileceğini açıklayan bir eğitim ekranı gösterilebilir.
İzin daha önce istenmediyse kol saati, telefona kullanıcıyı kol saatinde izinleri kabul etme konusunda yönlendiren eğitici bir an göstermesini söylemeli ve izin istemeye devam etmelidir.
- Kullanıcı izin verirse kol saati
setWatchFaceAsActive()
işlevini çağırmalıdır. - Aksi takdirde kol saati, telefona izin ihtiyacını ve iznin nasıl manuel olarak verileceğini açıklayan bir eğitim ekranı göstermesi talimatını vermelidir.
- Kullanıcı izin verirse kol saati