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.