Geräte in einem Netzwerk mithilfe von Data Layer APIs erkennen

Geräte können entweder direkt über eine WLAN- oder Mobilfunkverbindung oder indirekt über ein gekoppeltes Bluetooth-Gerät eine Verbindung zum Internet herstellen.

Erreichbare und nahegelegene Knoten

Ein Gerät gilt als erreichbar, wenn es online ist und mit einem anderen Gerät kommunizieren kann, entweder direkt über Bluetooth oder indirekt über die Cloud.

Ein Gerät gilt als in der Nähe, wenn es direkt über Bluetooth verbunden werden kann, ohne die Cloud zu verwenden.

Aktivitäten, die sich auf die Wiederverbindungszeit auswirken

Unter bestimmten Umständen kann es bis zu 4 Minuten dauern, bis die Verbindung wiederhergestellt ist. Zu diesen Situationen gehören die folgenden:

  • Inaktivität des Wear OS-Geräts: Wenn ein Wear OS-Gerät vom Handgelenk des Nutzers entfernt oder anderweitig über einen längeren Zeitraum nicht aktiv verwendet wird, kann sich die Zeit bis zur Wiederherstellung der Verbindung verlängern.
  • Stromsparmodus: Der Stromsparmodus eines Mobilgeräts kann Hintergrundprozesse einschränken, was die Zeit bis zur Wiederherstellung der Verbindung des Geräts verlängern kann.
  • Nutzerinteraktion: Wenn der Nutzer ungefähr gleichzeitig mit einem Mobilgerät und einem Wear OS-Gerät interagiert, wird der Prozess zur Wiederherstellung der Verbindung oft beschleunigt.

Alle Geräte mit einem Knotenclient erkennen

Ein NodeClient-Objekt identifiziert die Liste der mit einem Netzwerk verbundenen Android-Geräte und sendet an diese, unabhängig von den Funktionen der einzelnen Geräte. Alle Apps auf einem Gerät erhalten diese Ereignisbenachrichtigungen, z. B. wenn ein neues Gerät dem Netzwerk beitritt oder ein vorhandenes Gerät offline geht.

Die Klasse NodeClient ist besonders hilfreich, um Geräte zu finden, auf denen deine App nicht installiert ist.

Wenn du dich für Ereignisse zur Verbindung und Trennung von Geräten registrieren möchtest, kannst du die Horologist-Klasse DataLayerAppHelper verwenden. Es bietet einen connectedAndInstalledNodes Flow, um den Verbindungsstatus zu beobachten. Außerdem gibt die Methode connectedNodes() eine Liste der verbundenen Geräte zurück, wobei die Informationen aus NodeClient und CapabilityClient in einem einzigen Objekt kombiniert werden.

Bestimmte Geräte mit einem CapabilityClient finden

Ein CapabilityClient-Objekt liefert Informationen darüber, welche Geräte im Wear OS-Netzwerk bestimmte App-Funktionen unterstützen. Eine Funktion ist ein Feature, das eine App entweder beim Erstellen definiert oder zur Laufzeit dynamisch konfiguriert.

Eine mobile Android-App könnte beispielsweise angeben, dass sie die Fernsteuerung der Videowiedergabe unterstützt. Die Wear OS-Version dieser App kann mit der CapabilityClient prüfen, ob die mobile Version der App auf einem Gerät in der Nähe installiert ist und diese Funktion unterstützt. In diesem Fall kann die Wear OS-App Wiedergabe- und Pauseschaltflächen anzeigen, damit Nutzer ein Video, das auf ihrem Mobilgerät abgespielt wird, über ihr Wear OS-Gerät steuern können. Die Übertragung von Funktionen funktioniert auch in die andere Richtung. Wear OS-Apps können die von ihnen unterstützten Funktionen auflisten.

Wenn Sie Funktionen zur Build-Zeit definieren möchten, deklarieren Sie eine string-array-Ressource mit dem Namen android_wear_capabilities in res/values/wear.xml, wie unter Funktionsnamen für die Erkennung Ihrer Apps angeben beschrieben. Wenn Sie verhindern möchten, dass android_wear_capabilities durch die Entfernung von Ressourcen als nicht verwendet entfernt wird, geben Sie tools:keep="@array/android_wear_capabilities" in einer separaten Keep-Datei im Verzeichnis res/raw/ (z. B. res/raw/keep.xml) anstatt in res/values/wear.xml an. Informationen zur Syntax der Beibehaltungsdatei finden Sie unter Anpassen, welche Ressourcen beibehalten werden sollen.

Neue Funktionen Ihrer App prüfen

Verwende die CapabilityClient, um die Knoten-ID eines Geräts zu ermitteln, mit dem du kommunizieren musst. Wenn du beispielsweise prüfen möchtest, ob eine neue Funktion in deiner App auf Mobilgeräten vorhanden ist, erstelle eine Capability für diese neue Funktion auf der Mobilgeräteseite. Ihre Wear OS-App kann dann die Geräte abfragen, die diese Funktion unterstützen. Wenn die Funktion auf allen Geräten fehlt, bedeutet dies, dass der Nutzer keine Version deiner App hat, die diese Funktion unterstützt. Dies solltest du in der Logik deiner App entsprechend berücksichtigen. Wenn du davon ausgehst, dass das Mobilgerät immer der richtige Knoten für die Kommunikation ist, werden deine Nachrichten möglicherweise nicht zugestellt, weil die Telefon-App die Funktion nicht unterstützt.

Prüfen, ob ein Wear OS-Gerät das einzige Gerät in einem Netzwerk ist

Mit CapabilityClient kannst du prüfen, ob deine App im eigenständigen Modus ausgeführt werden muss, weil sich keine anderen Android-Geräte in der Nähe befinden. Wenn Sie FILTER_ALL übergeben, sollten keine anderen Geräte in den Ergebnissen angezeigt werden.