API lapisan data Wear OS terdiri dari beberapa jenis klien yang berbeda, yang berguna untuk berbagai jenis data dan selama kondisi konektivitas yang berbeda.
Halaman ini memperkenalkan setiap jenis klien, dan menyertakan tabel yang membandingkan kemampuan berbagai klien. Dengan menggunakan informasi ini, Anda dapat memilih kumpulan jenis klien yang paling sesuai untuk aplikasi Anda.
Kapan harus menggunakan Data Layer API
Gunakan Data Layer API jika interaksi hanya terjadi antara smartwatch lokal dan ponsel lokal. Untuk contoh mendetail, lihat Kasus penggunaan umum Lapisan Data.
Klien data
Objek DataClient memungkinkan Anda membaca atau menulis ke DataItem atau
Asset:
Setiap
DataItemadalah unit informasi yang disiarkan dan disinkronkan di semua perangkat di sekitar yang dimiliki pengguna.DataItemdisimpan secara persisten, dan perangkat Anda dapat membaca kontennya hingga item data dihapus.Assetditujukan untuk payload data yang lebih besar, seperti gambar atau file media.
Klien pesan
Objek MessageClient dapat mengirim pesan dan cocok untuk remote procedure call (RPC), seperti menggunakan perangkat Wear OS untuk mengontrol versi aplikasi Anda yang diinstal di perangkat genggam.
Pesan sangat baik untuk permintaan satu arah menggunakan sendMessage(), atau untuk
model komunikasi permintaan dan respons menggunakan sendRequest(). Tidak seperti klien data, klien pesan memerlukan node yang terhubung ke jaringan untuk mengirim pesan.
Metode sendMessage() adalah upaya terbaik untuk mengirim ke node jarak jauh, dan
tidak berisi mekanisme percobaan ulang bawaan. Jika perangkat target
terputus sebelum transfer jaringan dimulai, metode akan menampilkan
TARGET_NODE_NOT_CONNECTED.
Klien saluran
Objek ChannelClient menyediakan komunikasi berorientasi streaming antarperangkat. Saluran adalah pipa komunikasi dua arah antara dua node,
yang berguna untuk kasus penggunaan seperti berikut:
- Mentransfer file data antara dua atau lebih perangkat terhubung saat internet tidak tersedia.
ChannelClientmenghemat kapasitas disk melaluiDataClientyang akan membuat salinan aset di perangkat lokal sebelum disinkronkan dengan perangkat terhubung. - Andal dalam mengirim file yang terlalu besar untuk dikirim menggunakan
MessageClient. - Mentransfer data streaming, seperti data suara dari mikrofon.
Setelah membuka saluran, Anda dapat mengirim dan menerima data dalam aliran byte
yang berkelanjutan, bukan unit DataItem terpisah yang diperlukan klien data.
Anda bertanggung jawab untuk mengelola aliran data dan menjaga konsistensi data. Klien saluran tidak menawarkan tingkat sinkronisasi data otomatis yang sama dengan klien data.
Perbandingan klien
Tabel berikut membandingkan kemampuan berbagai klien:
| Jenis klien | Persistensi data | Mendukung data yang lebih besar dari 100 KB? | Jaringan yang akan digunakan | Bekerja secara offline? |
|---|---|---|---|---|
| Klien data | Data dipertahankan tanpa batas waktu | Ya (gunakan objek Asset) |
Bluetooth lebih disukai. Data dicadangkan ke cloud; jika Bluetooth tersedia, pencadangan ini dilakukan secara asinkron | Ya, untuk baca dan tulis |
| Klien pesan | Tanpa persistensi dan tanpa percobaan ulang | Tidak | Bluetooth lebih disukai, tetapi dapat menggunakan Wi-Fi jika hanya jenis koneksi tersebut yang tersedia | Tidak |
| Klien saluran | Tidak ada persistensi (berorientasi koneksi) | Ya | Bluetooth lebih disukai, tetapi dapat menggunakan Wi-Fi jika hanya jenis koneksi tersebut yang tersedia | Tidak |
Untuk informasi lebih lanjut tentang cara menggunakan API lapisan Data, lihat panduan Menyinkronkan data. Untuk pertimbangan daya saat menggunakan Data Layer API, lihat panduan Menghemat daya.