Mengonfigurasi aplikasi ponsel untuk Watch Face Push

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

Menetapkan 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: Tetapkan tampilan jam yang diinstal sebagai aktif. Langkah ini memiliki beberapa kemungkinan jalur, bergantung pada status izin:
    • Anda mungkin tidak perlu melakukan tindakan apa pun. Marketplace mungkin sudah memiliki kontrol atas tampilan jam aktif.
    • Mungkin 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 menerima permintaan izin, atau cara menyetel tampilan jam secara manual menggunakan gestur tekan lama atau melalui aplikasi pendamping.

Respons penginstalan

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

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

Aktivasi

Setelah penginstalan, respons mungkin menunjukkan bahwa aplikasi sudah memiliki tampilan jam yang aktif. Namun, jika tidak, aplikasi dapat memilih untuk menampilkan tombol guna 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 akan mengarah ke layar edukasi di ponsel, yang menunjukkan kepada pengguna cara menyentuh lama tampilan jam untuk menyetelnya secara manual ke tampilan yang mereka inginkan.

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 menyampaikan hal ini kembali ke ponsel, tempat layar edukasi dapat ditampilkan yang menjelaskan perlunya izin dan cara memberikannya secara manual.

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

    • Jika pengguna memberikan izin, smartwatch akan memanggil setWatchFaceAsActive().
    • Jika tidak, smartwatch akan meminta ponsel untuk menampilkan layar pendidikan yang menjelaskan perlunya izin dan cara memberikannya secara manual.