Notifikasi di Wear OS

Notifikasi di smartwatch menggunakan API yang sama dan memiliki struktur yang sama dengan notifikasi di ponsel.

Notifikasi dapat muncul di smartwatch dengan dua cara:

  1. Aplikasi seluler membuat notifikasi dan sistem akan otomatis menghubungkan notifikasi tersebut ke smartwatch.
  2. Aplikasi wearable membuat notifikasi.

Untuk kedua skenario tersebut, gunakan class NotificationCompat.Builder untuk membuat notifikasi. Saat Anda membuat notifikasi dengan class builder, sistem akan menangani tampilan notifikasi dengan benar. Misalnya, saat Anda mengeluarkan notifikasi dari aplikasi seluler, setiap notifikasi akan muncul sebagai kartu di Aliran Notifikasi.

Tinjau contoh berikut untuk melihat tampilan notifikasi. kartu notifikasi

Gambar 1. Notifikasi yang sama ditampilkan di ponsel dan smartwatch.

Gunakan salah satu subclass NotificationCompat.Style untuk mendapatkan hasil terbaik.

Catatan: Penggunaan RemoteViews akan menghapus dari notifikasi tata letak kustom, dan perangkat wearable hanya akan menampilkan teks dan ikon.

Notifikasi yang direkomendasikan untuk perangkat wearable

Gunakan notifikasi yang dapat diluaskan sebagai titik awal untuk semua notifikasi, karena ini adalah cara yang tepat untuk berinteraksi dengan pengguna perangkat wearable. Status yang diciutkan akan ditampilkan di baki notifikasi untuk pengalaman singkat yang mudah dilihat. Jika pengguna mengetuknya, notifikasi akan diluaskan sehingga pengalaman tindakan dan konten tambahan yang imersif dan dapat di-scroll akan terlihat.

Anda dapat Membuat notifikasi yang dapat diluaskan dengan cara yang sama seperti di perangkat seluler menggunakan subclass NotificationCompat.Style apa pun. Misalnya, notifikasi standar yang menggunakan NotificationCompat.MessagingStyle akan terlihat seperti ini: notifikasi yang dapat diluaskan

Gambar 2. Contoh notifikasi MessagingStyle di Wear OS.

Anda dapat melihat notifikasi yang memiliki beberapa tindakan yang ditumpuk di bagian bawah status yang diluaskan.

Untuk contoh NotificationCompat.BigPictureStyle, NotificationCompat.BigTextStyle, NotificationCompat.InboxStyle, dan NotificationCompat.MessagingStyle, lihat Contoh notifikasi di GitHub.

Tips: Jika notifikasi menyertakan tindakan "balas", seperti untuk aplikasi pesan, Anda dapat meningkatkan perilaku notifikasi. Misalnya, Anda dapat mengaktifkan balasan input suara langsung dari respons teks perangkat wearable atau respons yang telah ditentukan sebelumnya dengan setChoices(). Untuk mengetahui informasi selengkapnya, baca Menambahkan tombol balas.

Menghindari Notifikasi duplikat

Secara default, notifikasi akan dihubungkan dari aplikasi ponsel pendamping ke smartwatch yang tersambung. Ini adalah opsi yang tepat jika Anda tidak menginstal aplikasi wearable.

Namun, jika Anda membangun aplikasi smartwatch mandiri dan aplikasi ponsel pendamping, aplikasi akan membuat notifikasi duplikat.

Wear OS menyediakan cara untuk menghentikan notifikasi duplikat menggunakan Bridging API. Hal ini sangat penting untuk aplikasi di perangkat yang menjalankan Wear OS 5 atau yang lebih tinggi, karena beberapa notifikasi yang dapat ditutup di perangkat seluler tidak dapat ditutup di perangkat Wear OS. Untuk mengetahui informasi selengkapnya, baca Menjembatani opsi untuk notifikasi.

Menambahkan fitur khusus wearable ke notifikasi

Jika Anda perlu menambahkan fitur khusus wearable ke notifikasi, seperti menyembunyikan ikon aplikasi dari notifikasi wearable atau mengizinkan pengguna mendikte respons teks dengan input suara, Anda dapat menggunakan class NotificationCompat.WearableExtender untuk menentukan opsi. Untuk menggunakan API ini, lakukan hal berikut:

  1. Buat instance WearableExtender yang menyetel opsi khusus wearable untuk notifikasi.
  2. Buat instance NotificationCompat.Builder yang menyetel properti yang diinginkan untuk notifikasi sebagaimana dijelaskan sebelumnya dalam panduan ini.
  3. Panggil extend() pada notifikasi, lalu teruskan WearableExtender. Cara ini akan menerapkan opsi wearable pada notifikasi.
  4. Panggil build() untuk mem-build notifikasi.

Catatan: Jika Anda menggunakan NotificationManager framework, beberapa fitur dari NotificationCompat.WearableExtender tidak akan berfungsi. Jadi, pastikan Anda menggunakan NotificationCompat

Anda dapat menyinkronkan penutupan atau pembatalan notifikasi di seluruh perangkat pengguna. Untuk menyinkronkan penutupan, gunakan metode setDismissalId(). Untuk setiap notifikasi, teruskan ID unik global sebagai string saat Anda memanggil setDismissalId(). Saat notifikasi ditutup, semua notifikasi lain dengan ID penutupan yang sama akan ditutup di smartwatch dan di ponsel pendamping. Untuk mendapatkan ID penutupan, gunakan getDismissalId().

Menetapkan tindakan khusus wearable

Jika Anda menginginkan tindakan lain tersedia di smartwatch dan ponsel, gunakan WearableExtender.addAction(). Setelah menambahkan tindakan dengan metode ini, perangkat wearable tidak akan menampilkan tindakan lain yang ditambahkan dengan NotificationCompat.Builder.addAction(). Tindakan yang ditambahkan dengan WearableExtender.addAction() hanya muncul di perangkat wearable, bukan di ponsel.

Meluncurkan aplikasi telepon dari perangkat wearable

Jika Anda menggunakan notifikasi yang dihubungkan, setiap notifikasi akan otomatis menyertakan tombol untuk meluncurkan aplikasi di ponsel. Namun, jika Anda menggunakan notifikasi lokal, yang dibuat di smartwatch, gunakan langkah-langkah berikut untuk membuat tombol yang meluncurkan aplikasi di ponsel:

  1. Buat Activity baru yang memperluas ConfirmationActivity.
  2. Gunakan RemoteActivityHelper di Activity baru untuk meluncurkan aplikasi telepon.
  3. Saat membuat Intent untuk meluncurkan Activity dari notifikasi, tetapkan ekstra EXTRA_ANIMATION_TYPE ke OPEN_ON_PHONE_ANIMATION.
Pendekatan ini memandu pengguna untuk berinteraksi di ponsel mereka dan mengikuti persyaratan platform untuk meluncurkan proses latar belakang.

Catatan: Anda tidak dapat menggunakan BroadcastReceiver sebagai target tindakan notifikasi.