Telefon uygulamanızı kadran itme için yapılandırma

Telefon uygulaması, kanonik pazar yerinde kullanıcının uygulamayla etkileşime geçmesinin başlıca yoludur.

Kadran ayarlama

Kullanıcı telefon uygulamasında bir kadran seçtiğinde, kadranı ayarlama işleminin iki bölümü vardır:

  1. Yükleme: MessageClient üzerinden başlatılan Watch Face Push'i kullanarak kadranı yükleyin. Bu adımda, telefondan kol saatine MessageClient kullanılarak addWatchFace veya updateWatchFace etkinleştirilir.
  2. 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 gerekmeyebilir. Pazar yeri, etkin kadranı zaten kontrol ediyor olabilir.
    • Kullanıcı müdahalesi gerekmeyebilir. 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ı uygulama üzerinden kadran ayarının nasıl yapılacağı konusunda rehberliğe ihtiyaç duyabilirsiniz.

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
  • Uygulamanın etkin kadranı olup olmadığını belirlemek için isWatchFaceActive() sonucu.
  • setWatchFaceAsActive()'ün daha önce çağrılıp çağrılmadığı: Wear OS uygulaması bu bilgileri yerel olarak izlemeli ve sürdürmelidir. Bu API çağrısı yalnızca bir kez kullanılabilir.

Etkinleştirme

Yüklemenin ardından, yanıtta uygulamanın zaten etkin kadranı kullandığı belirtilebilir. Ancak bu ayar yapılmazsa uygulama, kadranı etkin olarak ayarlama düğmesi göstermeyi seçebilir.

Senaryo 1: Etkin kadranı ayarlamayla ilgili tüm girişimler sona erdi

Yükleme işleminden gelen yanıtta setWatchFaceAsActive()'ün daha önce çağrıldığı belirtiliyorsa düğme, telefonda kullanıcıya kadranı manuel olarak istedikleri kadrana ayarlamak için kadrana dokunup basılı tutma işlemini nasıl yapacağını gösteren bir eğitim ekranına yönlendirir.

2. Senaryo: Etkin kadranı ayarlamaya çalışın

Telefon, gerekli SET_PUSHED_WATCH_FACE_AS_ACTIVE iznini kontrol etmesi için saate talimat vermelidir:

  • Kullanıcı bu izni daha önce verdiyse setWatchFaceAsActive() işlevini çağırın.
  • Kullanıcı izini daha önce reddettiyse kol saati bunu telefona iletir. Telefonda, izine olan ihtiyacın ve izinin manuel olarak nasıl verileceğinin açıklandığı bir eğitim ekranı gösterilebilir.

  • İzin daha önce istenmediyse kol saati, telefona kullanıcıya kol saatinde izinleri nasıl kabul edeceği konusunda yol gösteren bir eğitim anı göstermesini söyler ve kol saati izin isteğinde bulunur.

    • Kullanıcı izin verirse kol saati setWatchFaceAsActive() işlevini çağırmalıdır.
    • Aksi takdirde kol saati, telefona izin gerekliliğini ve manuel olarak nasıl verileceğini açıklayan bir eğitim ekranı göstermesini söyler.