I dispositivi possono stabilire una connessione a internet direttamente utilizzando una connessione Wi-Fi o di rete cellulare oppure indirettamente tramite un dispositivo Bluetooth accoppiato.
Nodi raggiungibili e vicini
Un dispositivo è considerato raggiungibile quando è online e disponibile per comunicare con un altro dispositivo, direttamente tramite Bluetooth o indirettamente utilizzando il cloud come intermediario.
Un dispositivo è considerato nelle vicinanze se può essere connesso direttamente tramite Bluetooth, senza utilizzare il cloud.
Attività che influiscono sul tempo di riconnessione
In determinate circostanze, i dispositivi potrebbero richiedere fino a 4 minuti per ristabilire una connessione. Questi scenari includono:
- Inattività del dispositivo Wear OS: se un dispositivo Wear OS viene rimosso dal polso dell'utente o non viene utilizzato attivamente per un periodo prolungato, il tempo di riconnessione potrebbe essere esteso.
- Stato di sospensione: lo stato di sospensione per il risparmio energetico di un dispositivo portatile può limitare i processi in background, aumentando potenzialmente il tempo di riconnessione del dispositivo.
- Interazione dell'utente: se l'utente inizia a interagire con un dispositivo palmare e un dispositivo Wear OS all'incirca nello stesso momento, spesso il processo di riconnessione viene accelerato.
Rileva tutti i dispositivi utilizzando un client nodo
Un oggetto NodeClient identifica e trasmette all'elenco di dispositivi Android connessi a una rete, indipendentemente dalle funzionalità di ciascun dispositivo. Tutte le app su un dispositivo ricevono queste notifiche di eventi, ad esempio un nuovo dispositivo che si connette alla rete o un dispositivo esistente che va offline.
La classe NodeClient è particolarmente utile per rilevare i dispositivi su cui non è installata la tua app.
Per registrarti agli eventi di connessione e disconnessione del dispositivo, puoi utilizzare la classe Horologist DataLayerAppHelper. Fornisce un connectedAndInstalledNodes Flow per osservare lo stato della connessione. Inoltre, il suo metodo connectedNodes() restituisce un elenco di dispositivi connessi, combinando le informazioni di NodeClient e CapabilityClient in un unico oggetto.
Rileva dispositivi specifici utilizzando un client di funzionalità
Un oggetto CapabilityClient fornisce informazioni su quali dispositivi della rete Wear OS supportano funzionalità specifiche dell'app. Una funzionalità è una caratteristica che un'app definisce in fase di creazione o configura dinamicamente in fase di runtime.
Ad esempio, un'app per Android mobile potrebbe pubblicizzare che supporta il controllo remoto della riproduzione video. La versione Wear OS dell'app può utilizzare
CapabilityClient per verificare se la versione mobile dell'app è installata
su un dispositivo nelle vicinanze e supporta la funzionalità. In questo caso, l'app per Wear OS può mostrare i pulsanti di riproduzione e pausa in modo che gli utenti possano controllare un video, in riproduzione sul loro dispositivo mobile, dal loro dispositivo Wear OS. La trasmissione delle funzionalità
funziona anche nella direzione opposta; le app per Wear OS possono elencare le funzionalità
che supportano.
Per definire le funzionalità in fase di build, dichiara una risorsa string-array denominata android_wear_capabilities in res/values/wear.xml, come mostrato in Specifica i nomi delle funzionalità per il rilevamento delle app. Per evitare che la riduzione delle risorse rimuova android_wear_capabilities perché non utilizzata, specifica tools:keep="@array/android_wear_capabilities" in un file keep separato nella directory res/raw/ (ad esempio, res/raw/keep.xml) anziché in res/values/wear.xml. Per la sintassi del file keep, consulta Personalizza le risorse da conservare.
Controlla le nuove funzionalità della tua app
Utilizza CapabilityClient per determinare l'ID nodo di un dispositivo con cui devi comunicare. Ad esempio, se devi verificare la presenza di una nuova funzionalità nella tua app su dispositivi palmari, crea una funzionalità per la nuova funzionalità sul lato palmare. L'app per Wear OS può quindi eseguire query per i dispositivi che supportano questa
funzionalità. Se la funzionalità non è presente su tutti i dispositivi, significa che l'utente non ha una versione della tua app che la supporta, il che deve essere gestito correttamente nella logica dell'app. Se presumi che il dispositivo palmare sia sempre il nodo corretto con cui comunicare, i tuoi messaggi potrebbero non essere recapitati perché l'app Telefono non supporta la funzionalità.
Determinare se un dispositivo Wear OS è l'unico su una rete
Puoi utilizzare CapabilityClient per verificare se la tua app deve funzionare in modalità autonoma perché non ci sono altri dispositivi Android nelle vicinanze. Se passi FILTER_ALL, non dovrebbero essere visualizzati altri dispositivi nei risultati.