İstemci türü seçin

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 katmanı API'si ne zaman kullanılır?

Etkileşim yalnızca yerel kol saati ile yerel telefon arasında olduğunda veri katmanı API'sini kullanın. Ayrıntılı örnekler için Veri katmanının yaygın kullanım alanları başlıklı makaleyi inceleyin.

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.

Mesaj istemcisi

Bir MessageClient nesnesi mesaj gönderebilir ve uzak yordam çağrıları (RPC) için uygundur. Örneğin, Wear OS cihaz kullanarak uygulamanızın elde taşınabilir bir cihaza yüklenen sürümünü kontrol edebilirsiniz.

İletiler, 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ü bir iletişim hattıdır ve aşağıdaki gibi kullanım alanlarında faydalıdır:

  • İnternet bağlantısı yokken iki veya daha fazla bağlı cihaz arasında veri dosyalarını aktarın. ChannelClient, bağlı cihazlarla senkronize etmeden önce yerel cihazdaki öğelerin bir kopyasını oluşturan DataClient'a kıyasla disk alanından tasarruf sağlar.
  • MessageClient kullanılarak gönderilemeyecek kadar büyük bir dosyayı güvenilir bir şekilde gönderme
  • Mikrofondan alınan 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 kalıcı hale getirilir. 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 tek bağlantı türü kablosuz ise bu bağlantı da kullanılabilir. Hayır
Kanal istemcisi Kalıcılık yok (bağlantı odaklı) Evet Tercih edilen bağlantı türü Bluetooth'tur ancak tek bağlantı türü kablosuz ise bu bağlantı da kullanılabilir. Hayır

Veri katmanı API'leriyle çalışma hakkında daha fazla bilgi için Verileri senkronize etme kılavuzuna bakın. Veri katmanı API'lerini kullanırken güçle ilgili dikkat edilmesi gereken noktalar için Güç tasarrufu rehberine bakın.