Wear OS veri katmanı API'leri, farklı veri türleri ve farklı bağlantı koşulları için yararlı olan çeşitli istemci türlerinden oluşur.
Bu sayfada her bir istemci türü tanıtılmakta ve farklı istemcilerin özelliklerini karşılaştıran bir tablo yer almaktadır. Bu bilgileri kullanarak uygulamanız için en uygun istemci türlerini seçebilirsiniz.
Veri istemcisi
DataClient
nesnesi, DataItem
veya Asset
'a okuma ya da yazma işlemi yapmanıza olanak tanır:
Her
DataItem
, kullanıcının sahip olduğu yakındaki tüm cihazlarda yayınlanan ve senkronize edilen bir bilgi birimidir.DataItem
kalıcı olarak depolanır ve veri öğesi silinene kadar cihazınız içeriğini okuyabilir.Asset
, resim veya medya dosyaları gibi daha büyük veri yükleri için tasarlanmıştır.
İleti istemcisi
MessageClient
nesnesi mesaj gönderebilir ve uzak prosedür çağrıları (RPC) için uygundur. Örneğin, Wear OS cihaz kullanarak uygulamanızın elde taşınabilir cihaza yüklenen sürümünü kontrol edebilirsiniz.
Mesajlar, sendMessage()
kullanılarak tek yönlü istekler veya sendRequest()
kullanılarak istek-yanıt iletişim modeli için idealdir. Veri istemcilerinin aksine, ileti istemcilerinin ileti gönderebilmesi için düğümlerin ağa bağlı olması gerekir.
sendMessage()
yöntemi, uzak düğüme teslimat için en iyi çabayı gösterir ve yerleşik bir yeniden deneme mekanizması içermez. Hedef cihaz, ağ aktarımı başlamadan önce bağlantıyı keserse yöntem TARGET_NODE_NOT_CONNECTED
değerini döndürür.
Kanal istemcisi
ChannelClient
nesnesi, cihazlar arasında akış odaklı iletişim sağlar. Kanal, iki düğüm arasında iki yönlü iletişim sağlayan bir kanaldır. Aşağıdaki gibi kullanım alanlarında faydalıdır:
- İnternet bağlantısı olmadığında iki veya daha fazla bağlı cihaz arasında veri dosyalarını aktarın.
ChannelClient
, bağlı cihazlarla senkronize etmeden önce öğelerin yerel cihazda bir kopyasını oluşturanDataClient
'a kıyasla disk alanından tasarruf sağlar. MessageClient
ile gönderilemeyecek kadar büyük bir dosyayı güvenilir bir şekilde gönderme- Mikrofondaki ses verileri gibi aktarılan verileri aktarır.
Bir kanal açtıktan sonra, veri istemcilerinin gerektirdiği ayrı DataItem
birimler yerine sürekli bir bayt akışında veri gönderebilir ve alabilirsiniz.
Veri akışını yönetmek ve verileri tutarlı tutmak sizin sorumluluğunuzdadır. Kanal istemcileri, veri istemcileriyle aynı düzeyde otomatik veri senkronizasyonu sunmaz.
Müşteri karşılaştırması
Aşağıdaki tabloda, farklı istemcilerin özellikleri karşılaştırılmaktadır:
İstemci türü | Veri kalıcılığı | 100 KB'tan büyük verileri destekliyor mu? | Kullanılacak ağ | Çevrimdışı çalışır mı? |
---|---|---|---|---|
Veri istemcisi | Veriler süresiz olarak saklanır. | Evet (Asset nesnelerini kullanın) |
Bluetooth tercih edilir. Veriler buluta yedeklenir. Bluetooth varsa bu yedekleme eşzamansız olarak yapılır. | Evet, hem okuma hem de yazma için |
Mesaj istemcisi | Kalıcılık ve yeniden deneme yok | Hayır | Tercih edilen bağlantı türü Bluetooth'tur ancak yalnızca kablosuz bağlantı varsa bu bağlantı türü de kullanılabilir. | Hayır |
Kanal istemcisi | Kalıcılık yok (bağlantı odaklı) | Evet | Tercih edilen bağlantı türü Bluetooth'tur ancak yalnızca kablosuz bağlantı varsa bu bağlantı türü de kullanılabilir. | Hayır |