Mengonfigurasi aplikasi ponsel untuk Watch Face Push

Untuk marketplace kanonis, aplikasi ponsel adalah cara utama pengguna berinteraksi dengan aplikasi.

Menyetel tampilan jam

Saat pengguna memilih tampilan jam di aplikasi ponsel, ada dua bagian dalam alur berikutnya untuk menyetel tampilan jam:

  1. Penginstalan: Instal tampilan jam menggunakan Watch Face Push, yang dimulai melalui MessageClient. Langkah ini mudah, menggunakan addWatchFace atau updateWatchFace, dipicu menggunakan MessageClient dari ponsel ke smartwatch.
  2. Aktivasi: Menetapkan tampilan jam yang diinstal sebagai aktif. Langkah ini memiliki beberapa kemungkinan jalur, bergantung pada status izin:
    • Tidak ada tindakan yang perlu dilakukan. Marketplace mungkin sudah memiliki kontrol atas tampilan jam aktif.
    • Tidak diperlukan intervensi pengguna. Aplikasi memiliki izin yang diperlukan untuk menyetel tampilan jam aktif, dan dapat melakukannya secara langsung menggunakan setWatchFaceAsActive().
    • Mungkin ada panduan yang diperlukan, baik tentang cara menyetujui permintaan izin, atau cara menyetel tampilan jam secara manual menggunakan gestur tekan lama atau melalui aplikasi pendamping.

Respons penginstalan

Untuk memfasilitasi fase Aktivasi, fase Penginstalan harus menampilkan informasi berikut dari smartwatch ke ponsel:

  • Hasil upaya penginstalan
  • Hasil isWatchFaceActive() - untuk menentukan apakah aplikasi sudah memiliki tampilan jam aktif.
  • Apakah setWatchFaceAsActive() sudah pernah dipanggil sebelumnya - aplikasi Wear OS harus melacak dan menyimpan informasi ini secara lokal. Panggilan API ini hanya dapat digunakan satu kali.

Aktivasi

Setelah penginstalan, respons dapat menunjukkan bahwa aplikasi sudah memiliki tampilan jam aktif. Namun, jika tidak, aplikasi dapat memilih untuk menampilkan tombol untuk menyetel tampilan jam sebagai aktif.

Skenario 1: Semua upaya untuk menyetel tampilan jam aktif telah habis

Jika respons dari penginstalan menunjukkan bahwa setWatchFaceAsActive() telah dipanggil sebelumnya, tombol harus mengarah ke layar edukasi di ponsel, yang menunjukkan kepada pengguna cara menyentuh & menahan tampilan jam untuk menyetelnya secara manual ke tampilan jam yang diinginkan.

Skenario 2 - Mencoba menyetel tampilan jam aktif

Ponsel harus menginstruksikan smartwatch untuk memeriksa izin SET_PUSHED_WATCH_FACE_AS_ACTIVE yang diperlukan:

  • Jika pengguna telah memberikannya, lanjutkan dengan memanggil setWatchFaceAsActive().
  • Jika pengguna sebelumnya menolak izin, smartwatch harus mengirimkan informasi ini kembali ke ponsel, tempat layar edukasi dapat ditampilkan untuk menjelaskan kebutuhan akan izin dan cara memberikannya secara manual.

  • Jika izin belum pernah diminta sebelumnya, smartwatch harus menginstruksikan ponsel untuk menampilkan momen edukasi yang memandu pengguna tentang cara menyetujui izin di smartwatch, dan smartwatch harus melanjutkan untuk meminta izin.

    • Jika pengguna memberikan izin, smartwatch harus memanggil setWatchFaceAsActive().
    • Jika tidak, smartwatch akan menginstruksikan ponsel untuk menampilkan layar edukasi yang menjelaskan kebutuhan izin dan cara memberikannya secara manual.