Data Katmanlar API'sine genel bakış

Bulut tabanlı düğüm, Google'a ait bir sunucu tarafından kontrol edilir
Şekil 1. Düğüm ağı örneği olarak avuç içi ve Wear OS cihazlar.

Google Play Hizmetleri'nin bir parçası olan Giyilebilir Veri Katmanı API'si, giyilebilir cihazlar (akıllı saatler gibi) ve bağlı avuç içi cihazlar (genellikle akıllı telefonlar). Bu, bir projeyi senkronize edip ve cihazlar arasında veri aktarımı yapabilirsiniz.

Not: Bu API yalnızca Wear OS kol saatlerinde ve eşlenen Android cihazlar. iOS telefonlarla eşlenen Wear OS saatlerde uygulamalar İnternet bağlantısı varsa diğer bulut tabanlı API'leri sorgulama. Daha fazla daha fazla bilgi edinmek için Ağ erişimi ve senkronizasyonu açık Wear OS'te kullanılabilir.

Dikkat: Veri katmanı API'leri şunlar için tasarlandığından: arasındaki iletişimi sürdürüyoruz. Bu konuda ayarlamak için de kullanabilirsiniz. Örneğin, ekip üyelerinizin düşük seviyeli yuvaları açarak bir iletişim kanalı oluşturabilirsiniz.

Yaygın kullanım alanları

Veri Katmanı API'si özellikle fitness ve medya kullanım alanları için yararlıdır.

Fitness uygulamaları

Fitness uygulamalarına genellikle ihtiyaç duyduğu egzersiz verilerini Wear OS uygulamasından gönderebilir saat tarafından yakalanan egzersiz verilerini bir mobil uygulamaya veya Sağlık Connect'i (Bağlanın) tıklayın. Veri aktarmak için Veri Katmanı API'sini kullanıyorsanız bir Wear OS uygulamasından mobil uygulamaya egzersiz verileri göndermek için mesaj istemcisi kullanması gerekir.

Ev antrenmanı sırasında mobil cihaza canlı veri akışı

Yaygın bir ev antrenmanı senaryosu, nabız verilerinin bir Wear OS'ten yayınlanmasıdır Bir mobil cihaza ekliyor ve kullanıcıya güncel nabız bilgilerini gösteriyor ekranında görünmesi gerekir. Bu verilerin akışını gerçekleştirmek için bir kanal istemcisi kullanın.

Medya uygulamaları

Duraklatma/devam ettirme/başlatma/sonlandırma işlemiyle bir medya oynatıcıyı kontrol etmek için Bir mesaj istemcisi kullanın.

İletişim seçenekleri

Veriler, aşağıdaki yöntemlerden biri kullanılarak aktarılır:

  1. Doğrudan Wear OS cihaz ve başka bir cihaz.
  2. LTE veya kablosuz gibi kullanılabilir bir ağ üzerinden ağ düğümünü Google sunucularına devredebilir.

Tüm Veri Katmanı istemcileri, Bluetooth veya bağlı olarak otomatik veya bulutlu olmalıdır. Bu verilerin aracılığıyla iletilebilir.

Bluetooth

Cihazlar Bluetooth kullanılarak bağlandığında, Veri Katmanı bu bağlantıyı kullanır. Cihazlar arasında standart kullanan, şifrelenmiş tek bir kanal vardır. Google Play Hizmetleri tarafından yönetilen Bluetooth şifrelemesi.

Bulut

Bluetooth kullanılamadığında veriler Google Cloud üzerinden otomatik olarak yönlendirilir. Google Cloud aracılığıyla aktarılan tüm veriler uçtan uca şifrelenir.

İletişimin güvenliği

Google Play Hizmetleri, daha güvenli hizmet sunmak için aşağıdaki kısıtlamaları uygular bir Wear OS cihazda yüklü uygulama ile aynı uygulama arasındaki iletişim yakındaki bir avuç içi cihazda yüklü:

  • Paket adı tüm cihazlarda eşleşmelidir.
  • Paketin imzası tüm cihazlarda eşleşmelidir.

Bağlantı türü ne olursa olsun verilere başka hiçbir uygulama erişemez.

Kurulum

Giyilebilir Veri Katmanı API'si aşağıdaki bağımlılıklara sahiptir:

Wear modülünüzün build.gradle dosyasına aşağıdaki bağımlılığı ekleyin:

dependencies {
    ...
    implementation("com.google.android.gms:play-services-wearable:18.2.0")
}

İlk eşleme sürecini kolaylaştırma

Horologist, platform API'leri üzerinde çeşitli yardımcı kitaplıklar sağlar. Google Analytics 4'teki veri katmanı kitaplığı, bir mobil cihaz ve bir Wear OS cihazı olabilir. Ayrıca, Google Analytics 4'te şunları yapabilirsiniz:

  • Uygulamayı diğer cihaza yükleyin.
  • Diğer cihazda uygulamayı başlatın.
  • Diğer cihazda belirli bir etkinliği başlatın.
  • Tamamlayıcı uygulamayı başlatın.

Veri katmanına erişme

Veri Katmanı API'sini çağırmak için Wearable sınıfını kullanarak şunların örneklerini alın: DataClient ve MessageClient gibi çeşitli müşteri sınıfları.

Daha fazla bilgi için DataKatman örneğine bakın.

Minimal istemci kullanın

İstemci oluşturmak için aşağıdaki örnek kodu inceleyin:

Kotlin

val dataClient: DataClient = Wearable.getDataClient(context)

Java

DataClient dataClient = Wearable.getDataClient(context);

Bağlam, geçerli herhangi bir Android bağlamı olabilir. API'yi bir Activity kapsamı için Wearable öğesinin getDataClient() yöntemini kullanın sınıfını kullanır. Bu sayede, belirli etkileşimler bir iletişim kutusu olarak değil, bir iletişim kutusu olarak bildirimler (ör. kullanıcıdan Google sürümlerini güncellemesi istendiğinde) Play Hizmetleri.

Varsayılan olarak, dinleyicilere geri çağırma, uygulamanın ana kullanıcı arayüzü iş parçacığı üzerinde yapılır. Mevcut bir WearableOptions nesnesi kullanarak özel bir Looper belirtin:

Kotlin

runBlocking {
    Wearable.getDataClient(context, options)
}

Java

WearableOptions options = new WearableOptions.Builder().setLooper(myLooper).build();
DataClient dataClient = Wearable.getDataClient(context, options);

Daha fazla bilgi için WearableOptions.Builder referansını inceleyin.

İstemci örneklerini gerektiğinde yeniden oluşturma

DataClient ve MessageClient gibi giyilebilir API istemcileri ucuzdur. Bu nedenle, müşterileri elde tutmak yerine onları gerçek uygulamanıza uygun stili kullanarak bunları kolayca yapabilirsiniz.

Kayıtlı dinleyiciler gibi istemci durumu, tüm alan adlarında ve bir uygulama kullanıma hazırken Google Play Hizmetleri güncellendiğinde çalışıyor.