Veri Katmanı API'lerini kullanarak ağ üzerindeki cihazları keşfedin

Cihazlar, doğrudan kablosuz bağlantı veya hücresel bağlantı kullanarak ya da dolaylı olarak eşlenmiş bir Bluetooth cihazı üzerinden internete bağlanabilir.

Ulaşılabilir ve yakındaki düğümler

Bir cihaz, internete bağlı olduğunda ve doğrudan Bluetooth üzerinden ya da dolaylı olarak bulutu aracı olarak kullanarak başka bir cihazla iletişim kurabildiğinde erişilebilir olarak kabul edilir.

Bulut kullanılmadan doğrudan Bluetooth üzerinden bağlanılabilen cihazlar yakında olarak kabul edilir.

Yeniden bağlanma süresini etkileyen etkinlikler

Bazı durumlarda cihazların bağlantıyı yeniden kurması 4 dakikayı bulabilir. Bu senaryolar arasında şunlar yer alır:

  • Wear OS cihazın etkin olmaması: Wear OS cihaz, kullanıcının bileğinden çıkarılırsa veya uzun süre aktif olarak kullanılmazsa yeniden bağlanma süresi uzayabilir.
  • Doze durumu: El cihazının güç tasarrufu sağlayan Doze durumu, arka plan işlemlerini sınırlayarak cihazın yeniden bağlanma süresini uzatabilir.
  • Kullanıcı etkileşimi: Kullanıcı hem el cihazı hem de Wear OS cihazıyla yaklaşık olarak aynı anda etkileşime girmeye başlarsa bu durum genellikle yeniden bağlanma sürecini hızlandırır.

Düğüm istemcisi kullanan tüm cihazları keşfetme

NodeClient nesnesi, her cihazın kapasitesinden bağımsız olarak bir ağa bağlı Android destekli cihazların listesini tanımlar ve bu listeye yayın yapar. Cihazdaki tüm uygulamalar, ağa yeni bir cihazın katılması veya mevcut bir cihazın çevrimdışı olması gibi etkinlik bildirimlerini alır.

NodeClient sınıfı, özellikle uygulamanızın yüklü olmadığı cihazları keşfetmek için kullanışlıdır.

Cihaz bağlantısı ve bağlantı kesme etkinliklerine kaydolmak için Horologist DataLayerAppHelper sınıfını kullanabilirsiniz. Bağlantı durumunu gözlemlemek için connectedAndInstalledNodes Flow sağlar. Ayrıca connectedNodes() yöntemi, bağlı cihazların listesini döndürür ve hem NodeClient hem de CapabilityClient'den gelen bilgileri tek bir nesnede birleştirir.

Yetenek istemcisini kullanarak belirli cihazları keşfetme

CapabilityClient nesnesi, Wear OS ağındaki hangi cihazların belirli uygulama özelliklerini desteklediği hakkında bilgi sağlar. Yetenek, bir uygulamanın derleme zamanında tanımladığı veya çalışma zamanında dinamik olarak yapılandırdığı bir özelliktir.

Örneğin, bir mobil Android uygulaması, video oynatmanın uzaktan kontrolünü desteklediğini bildirebilir. Uygulamanın Wear OS sürümü, uygulamanın mobil sürümünün yakındaki bir cihazda yüklü olup olmadığını ve bu özelliği destekleyip desteklemediğini kontrol etmek için CapabilityClient kullanabilir. Wear OS uygulaması, oynat ve duraklat düğmelerini göstererek kullanıcıların mobil cihazlarında oynatılan bir videoyu Wear OS cihazlarından kontrol etmelerine olanak tanıyabilir. Özellik yayını ters yönde de çalışır. Wear OS uygulamaları, destekledikleri özellikleri listeleyebilir.

Derleme zamanında özellikleri tanımlamak için res/values/wear.xml içinde android_wear_capabilities adlı bir string-array kaynağı tanımlayın. Bu işlemi, Uygulamalarınızı algılamak için özellik adlarını belirtme bölümünde gösterildiği gibi yapın. Kaynak küçültme işleminin android_wear_capabilities öğesini kullanılmayan olarak kaldırılmasını önlemek için tools:keep="@array/android_wear_capabilities" öğesini res/values/wear.xml yerine res/raw/ dizinindeki (örneğin, res/raw/keep.xml) ayrı bir saklama dosyasında belirtin. Keep dosyası söz dizimi için Hangi kaynakların saklanacağını özelleştirme başlıklı makaleyi inceleyin.

Uygulamanızın yeni özelliklerini kontrol etme

İletişim kurmanız gereken bir cihazın düğüm kimliğini belirlemek için CapabilityClient kullanın. Örneğin, el cihazlarındaki uygulamanızda yeni bir özelliğin olup olmadığını kontrol etmeniz gerekiyorsa el cihazı tarafında bu yeni özellik için bir özellik oluşturun. Wear OS uygulamanız daha sonra bu özelliği destekleyen cihazları sorgulayabilir. Özellik tüm cihazlarda eksikse kullanıcının uygulamanızın bu özelliği destekleyen bir sürümüne sahip olmadığı anlamına gelir. Bu durumu uygulamanızın mantığında düzgün bir şekilde ele almanız gerekir. İletişim kurmak için her zaman doğru düğümün el cihazı olduğunu varsayarsanız telefon uygulaması bu özelliği desteklemediği için mesajlarınız teslim edilmeyebilir.

Wear OS cihazın ağdaki tek cihaz olup olmadığını belirleme

Yakında başka Android destekli cihaz olmadığından uygulamanızın bağımsız modda çalışması gerekip gerekmediğini kontrol etmek için CapabilityClient kullanabilirsiniz. FILTER_ALL parametresini ilettiğinizde sonuçlarda başka cihaz görünmez.