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:
- Penginstalan: Instal tampilan jam menggunakan Watch Face Push, yang dimulai
melalui
MessageClient
. Langkah ini mudah, menggunakanaddWatchFace
atauupdateWatchFace
, dipicu menggunakanMessageClient
dari ponsel ke smartwatch. - 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.
- Jika pengguna memberikan izin, smartwatch harus memanggil