Che cos’è Wi‑Fi Aware

Wi‑Fi Aware, noto anche come Neighbor Awareness Networking (NAN), permette ai dispositivi compatibili di individuare servizi e comunicare direttamente tramite Wi‑Fi, senza un punto di accesso né altre forme di connettività tra loro. Non fornisce da solo l’accesso a Internet: crea un canale di comunicazione locale tra dispositivi vicini.

Su Android, la funzionalità è disponibile da Android 8.0 (API 26), ma installare quella versione non è sufficiente. Il dispositivo deve supportare Wi‑Fi Aware: il produttore deve fornire il supporto nel framework, nella HAL e nel firmware. La disponibilità concreta dipende quindi dal dispositivo, non soltanto dalla versione di Android.

La connessione diretta può essere utile per condividere informazioni tra dispositivi non collegati a una rete tradizionale. Wi‑Fi Alliance descrive scenari di condivisione di dati e servizi tra dispositivi vicini, e Android indica che le connessioni Wi‑Fi Aware possono supportare velocità di trasferimento superiori a Bluetooth su distanze maggiori. Le prestazioni effettive dipendono dai dispositivi e dalle condizioni d’uso; il confronto non garantisce una velocità o una portata specifica.

Come funzionano individuazione e connessione

Il processo inizia quando un dispositivo pubblica un servizio e un altro vi si sottoscrive. Per esempio, un’app può annunciare un servizio per la condivisione di file mentre un’altra lo cerca. Quando il dispositivo sottoscrittore entra nel raggio Wi‑Fi di quello che pubblica, il sistema avvisa l’app di aver trovato un servizio corrispondente.

Trovare il servizio non significa che sia già stata stabilita una connessione dati. Dopo l’individuazione, il sottoscrittore può inviare un breve messaggio oppure avviare la configurazione di una connessione di rete bidirezionale. Per una connessione client-server, la guida Android descrive ulteriori passaggi di segnalazione e richieste di rete su entrambi i dispositivi.

Uno stesso dispositivo può pubblicare e sottoscriversi contemporaneamente. Wi‑Fi Aware organizza inoltre i dispositivi vicini in cluster. Il servizio di sistema gestisce questo raggruppamento; le app usano le API per richiedere operazioni di individuazione, invio di messaggi e connessione, ma non controllano la formazione dei gruppi.

Requisiti e disponibilità su Android

Un’app può verificare se Android dichiara Wi‑Fi Aware sul dispositivo utilizzando PackageManager.hasSystemFeature(PackageManager.FEATURE_WIFI_AWARE). Può poi controllare se la funzionalità è disponibile in quel momento con WifiAwareManager.isAvailable(). Supporto e disponibilità attuale sono verifiche distinte: un dispositivo può supportare la funzionalità anche se temporaneamente non è possibile usarla.

La disponibilità può essere influenzata dalla disattivazione del Wi‑Fi o della posizione da parte dell’utente. In base alle capacità di hardware e firmware, alcuni dispositivi non supportano Wi‑Fi Aware mentre sono in uso Wi‑Fi Direct, SoftAP o il tethering. Un’app non deve quindi presumere che la funzionalità resti attiva per tutta la sessione.

Android consiglia di ascoltare ACTION_WIFI_AWARE_STATE_CHANGED, che segnala le variazioni di disponibilità. Quando riceve la notifica, l’app dovrebbe eliminare le sessioni esistenti e controllare di nuovo lo stato prima di decidere come procedere. Gestire le interruzioni fa parte dell’implementazione: se Wi‑Fi Aware diventa indisponibile, il software deve adattare il proprio comportamento e, quando opportuno, avviare nuove sessioni dopo il ripristino del servizio.

Autorizzazioni e ciclo di vita delle sessioni

La guida Android indica autorizzazioni Wi‑Fi e di rete come ACCESS_WIFI_STATE, CHANGE_WIFI_STATE, CHANGE_NETWORK_STATE e INTERNET. Le app destinate ad Android 13 (API 33) o versioni successive devono dichiarare anche NEARBY_WIFI_DEVICES. Se l’app ottiene informazioni sulla posizione tramite le API Wi‑Fi, non deve includere l’attributo neverForLocation.

La documentazione include ACCESS_FINE_LOCATION con maxSdkVersion="32" per le app che necessitano di informazioni precise sulla posizione. Se una funzionalità dipende da tali informazioni, Android indica di non includere questo limite di versione. Le autorizzazioni devono corrispondere a ciò che fa l’app e alle condizioni documentate da Android; non esiste una ricetta identica per ogni funzionalità.

Per iniziare a usare Wi‑Fi Aware, l’app chiama attach() e riceve una sessione che contiene le sessioni di pubblicazione o sottoscrizione. Android consiglia di chiamare attach() una sola volta nella maggior parte dei casi: le chiamate aggiuntive creano sessioni separate, ciascuna con il proprio spazio dei nomi. Le sessioni di individuazione appartengono alla sessione principale, quindi è opportuno chiuderle esplicitamente quando non servono più.

Funzionalità documentate in Android 12 e 13

Android 12 (API 31) ha aggiunto onServiceLost(), che permette di avvisare l’app quando un servizio individuato non è più disponibile perché è stato interrotto o è uscito dal raggio. Ha inoltre semplificato la configurazione dei percorsi dati: il dispositivo che risponde può essere configurato per accettare qualsiasi interlocutore senza conoscere in anticipo l’indirizzo MAC di chi avvia la connessione. getAvailableAwareResources() consente di consultare le risorse disponibili, come i percorsi dati e le sessioni di pubblicazione o sottoscrizione.

Sui dispositivi con Android 13 (API 33) o versioni successive che supportano la modalità di comunicazione istantanea, le app possono attivarla nella configurazione di pubblicazione o sottoscrizione. Android indica che questa modalità accelera lo scambio di messaggi, l’individuazione dei servizi e la configurazione dei percorsi dati. L’app può verificare il supporto del dispositivo tramite isInstantCommunicationModeSupported(); questa capacità non è garantita su tutti i dispositivi.

Ranging: misurare la distanza tra dispositivi

Wi‑Fi Aware può utilizzare il ranging per misurare la distanza da un altro dispositivo e limitare l’individuazione a un’area definita. Su Android, questa funzionalità usa IEEE 802.11mc, noto anche come Round Trip Time (RTT). Per utilizzarla, il dispositivo deve supportare sia Wi‑Fi Aware sia Wi‑Fi RTT.

Android descrive, per esempio, un intervallo di individuazione compreso tra 3 e 10 metri. Per applicare il limite, chi pubblica deve abilitare il ranging e chi si sottoscrive deve impostare la distanza minima o massima corrispondente. Se chi pubblica non abilita la misurazione, i vincoli di distanza del sottoscrittore vengono ignorati e si esegue l’individuazione normale.

Quando un servizio viene individuato entro l’intervallo configurato, l’app può ricevere onServiceDiscoveredWithinRange, che fornisce la distanza misurata. La misurazione dipende dal supporto e dalla configurazione di entrambi i dispositivi; non va interpretata come garanzia di localizzazione precisa né come funzionalità presente su tutti i dispositivi.

Privacy e limiti pratici

Android richiede che gli indirizzi MAC delle interfacce Wi‑Fi Aware di individuazione e dati siano casuali e diversi dall’indirizzo MAC reale del dispositivo. Devono essere resi nuovamente casuali quando Wi‑Fi Aware viene attivato o riattivato; con la configurazione predefinita del framework, l’intervallo periodico è di 30 minuti. Wi‑Fi Alliance descrive anche protezioni della privacy, tra cui identità di abbinamento che solo i dispositivi abbinati possono risolvere e modifiche periodiche delle identità trasmesse.

Wi‑Fi Aware non sostituisce una connessione a Internet. Serve a consentire l’individuazione e la comunicazione locale; un’app che richiede servizi online deve gestire separatamente quella connessione. Inoltre, poiché la disponibilità può cambiare, l’app deve gestire le interruzioni anziché trattare una sessione come permanente.

Da Android 14 in poi, le app con privilegi possono sospendere e riprendere le sessioni di individuazione attive se il dispositivo e il firmware offrono il supporto necessario. Android segnala che questa capacità può accelerare la ripresa e ridurre il consumo energetico. Prima di basare una funzionalità su Wi‑Fi Aware, controlla compatibilità e disponibilità su ogni dispositivo partecipante e progetta il software affinché reagisca ai cambiamenti di stato.