Menemukan perangkat di jaringan menggunakan Data Layer API

Perangkat dapat membuat koneksi ke internet, baik secara langsung menggunakan koneksi Wi-Fi atau seluler, maupun secara tidak langsung melalui perangkat Bluetooth yang disambungkan.

Node yang dapat dijangkau dan di sekitar

Perangkat dianggap dapat dijangkau jika online dan tersedia untuk berkomunikasi dengan perangkat lain, baik secara langsung melalui Bluetooth maupun secara tidak langsung menggunakan cloud sebagai perantara.

Perangkat dianggap berada di sekitar jika dapat dihubungkan langsung melalui Bluetooth, tanpa menggunakan cloud.

Aktivitas yang memengaruhi waktu koneksi ulang

Dalam keadaan tertentu, perangkat mungkin memerlukan waktu hingga 4 menit untuk membuat ulang koneksi. Skenario ini mencakup:

  • Tidak ada aktivitas di perangkat Wear OS: Jika perangkat Wear OS dilepas dari pergelangan tangan pengguna atau tidak digunakan secara aktif dalam waktu lama, waktu koneksi ulang mungkin akan diperpanjang.
  • Status Istirahat: Status Istirahat hemat daya perangkat genggam dapat membatasi proses latar belakang, yang berpotensi meningkatkan waktu koneksi ulang perangkat.
  • Interaksi pengguna: Jika pengguna mulai berinteraksi dengan perangkat genggam dan perangkat Wear OS pada waktu yang hampir bersamaan, hal ini sering kali mempercepat proses koneksi ulang.

Menemukan semua perangkat menggunakan klien node

Objek NodeClient mengidentifikasi dan menyiarkan ke daftar perangkat Android yang terhubung ke jaringan, terlepas dari kemampuan setiap perangkat. Semua aplikasi di perangkat menerima notifikasi peristiwa ini, seperti perangkat baru yang bergabung ke jaringan atau perangkat yang sudah ada yang offline.

Class NodeClient sangat membantu untuk menemukan perangkat yang tidak menginstal aplikasi Anda.

Untuk mendaftar ke peristiwa koneksi dan pemutusan koneksi perangkat, Anda dapat menggunakan class DataLayerAppHelper Horologist. API ini menyediakan connectedAndInstalledNodes Flow untuk mengamati status koneksi. Selain itu, metode connectedNodes()-nya menampilkan daftar perangkat terhubung, yang menggabungkan informasi dari NodeClient dan CapabilityClient menjadi satu objek.

Menemukan perangkat tertentu menggunakan klien kemampuan

Objek CapabilityClient memberikan informasi tentang perangkat mana di jaringan Wear OS yang mendukung kemampuan aplikasi tertentu. Kemampuan adalah fitur yang ditentukan aplikasi pada waktu build atau dikonfigurasi secara dinamis saat runtime.

Misalnya, aplikasi Android seluler dapat mengiklankan bahwa aplikasi tersebut mendukung remote control pemutaran video. Aplikasi versi Wear OS tersebut dapat menggunakan CapabilityClient untuk memeriksa apakah aplikasi versi seluler diinstal di perangkat di sekitar dan mendukung fitur tersebut. Jika demikian, aplikasi Wear OS dapat menampilkan tombol putar dan jeda sehingga pengguna dapat mengontrol video, yang diputar di perangkat seluler, dari perangkat Wear OS. Siaran kemampuan juga berfungsi berlawanan arah; aplikasi Wear OS dapat mencantumkan kemampuan yang didukung.

Untuk menentukan kemampuan pada waktu build, deklarasikan resource string-array bernama android_wear_capabilities di res/values/wear.xml, seperti yang ditunjukkan dalam Menentukan nama kemampuan untuk mendeteksi aplikasi. Untuk mencegah penyingkatan resource menghapus android_wear_capabilities karena tidak digunakan, tentukan tools:keep="@array/android_wear_capabilities" dalam file keep terpisah di direktori res/raw/ (misalnya, res/raw/keep.xml), bukan di res/values/wear.xml. Untuk sintaksis file keep, lihat Menyesuaikan resource yang perlu dipertahankan.

Memeriksa kemampuan baru aplikasi Anda

Gunakan CapabilityClient untuk menentukan ID node perangkat yang perlu Anda ajak berkomunikasi. Misalnya, jika Anda perlu memeriksa keberadaan fitur baru di aplikasi Anda pada perangkat genggam, buat kemampuan untuk fitur baru tersebut di sisi perangkat genggam. Aplikasi Wear OS Anda kemudian dapat mengkueri perangkat yang mendukung kemampuan tersebut. Jika kemampuan tidak ada di semua perangkat, berarti pengguna tidak memiliki versi aplikasi Anda yang mendukung fitur ini, yang harus Anda tangani dengan baik dalam logika aplikasi. Jika Anda berasumsi bahwa perangkat genggam selalu merupakan node yang tepat untuk berkomunikasi, pesan Anda mungkin tidak akan terkirim, karena aplikasi ponsel tidak mendukung fitur tersebut.

Menentukan apakah perangkat Wear OS adalah satu-satunya di jaringan

Anda dapat menggunakan CapabilityClient untuk memeriksa apakah aplikasi Anda harus beroperasi dalam mode mandiri karena tidak ada perangkat Android lain di sekitar. Dengan meneruskan FILTER_ALL, tidak ada perangkat lain yang akan muncul dalam hasil.