Descripción general del reconocimiento de Wi-Fi

Las capacidades de reconocimiento de Wi-Fi habilitan los dispositivos con Android 8.0 (nivel de API 26) y más arriba para descubrirse y conectarse directamente entre sí sin ningún otro tipo de conectividad entre ellas. El reconocimiento de Wi-Fi también se conoce como conocimiento de vecinos. Herramientas de redes (NAN).

Las redes de reconocimiento de Wi-Fi funcionan mediante la formación de clústeres con dispositivos cercanos. mediante la creación de un clúster nuevo si el dispositivo es el primero en un área. Este comportamiento de agrupamiento se aplica a todo el dispositivo y se administra mediante el servicio del sistema de reconocimiento de Wi-Fi; las apps no tienen control sobre este comportamiento. Las apps usan las APIs de reconocimiento de Wi-Fi para comunicarse con ese servicio del sistema, que administra el hardware para tal fin en el dispositivo.

Las API de reconocimiento de Wi-Fi permiten que las apps realicen las siguientes operaciones:

  • Descubrir otros dispositivos: La API tiene un mecanismo para encontrar otros dispositivos cercanos. El proceso comienza cuando un dispositivo publica uno o más servicios detectables. Luego, cuando un dispositivo se suscribe a uno o más servicios y entra en el rango de Wi-Fi del publicador, el suscriptor recibe una notificación de que se descubrió un publicador coincidente. Después de que el suscriptor descubre un publicador, puede enviar un mensaje corto o establecer una conexión de red con el dispositivo descubierto. Los dispositivos pueden ser simultáneamente publicadores y suscriptores.

  • Crear una conexión de red: Después de que dos dispositivos se hayan descubierto, podrán crear una conexión de red de reconocimiento de Wi-Fi bidireccional sin un punto de acceso.

Las conexiones de red de reconocimiento de Wi-Fi admiten tasas de capacidad de procesamiento más altas por más tiempo distancias que con Bluetooth conexiones de red. Estos tipos de conexiones son útiles para apps que comparten grandes cantidades de datos entre usuarios, como las apps que permiten compartir fotos.

Mejoras de Android 13 (nivel de API 33)

En dispositivos con Android 13 (nivel de API 33) y versiones posteriores que admiten apps instantáneas modo de comunicación, las aplicaciones pueden usar el PublishConfig.Builder.setInstantCommunicationModeEnabled() y SubscribeConfig.Builder.setInstantCommunicationModeEnabled() métodos para habilitar o inhabilitar el modo de comunicación instantánea para un editor o suscriptor, de descubrimiento. El modo de comunicación instantánea acelera el intercambio de mensajes descubrimiento de servicios y cualquier ruta de datos configurada como parte de un publicador o suscriptor de descubrimiento. Cómo determinar si un dispositivo admite comunicación instantánea usa el método isInstantCommunicationModeSupported().

Mejoras de Android 12 (nivel de API 31)

Android 12 (nivel de API 31) agrega algunas mejoras a Reconocimiento de Wi-Fi:

  • En dispositivos que ejecutan Android 12 (nivel de API 31) y versiones posteriores, puedes usar la devolución de llamada onServiceLost() para recibir una alerta cuando tu app pierda un servicio detectado, ya que el servicio dejó de funcionar o salió del rango de alcance.
  • Se simplificó la configuración de las rutas de acceso de Wi-Fi Aware. Las versiones anteriores usaban mensajería L2 para proporcionar la dirección MAC del iniciador, lo que introdujo la latencia. En los dispositivos que ejecutan Android 12 y versiones posteriores, la respuesta (servidor) se puede configurar para aceptar cualquier par, es decir, no necesita conocer la dirección MAC del iniciador de antemano. Esto acelera la ruta de datos y habilita múltiples vínculos punto a punto con una sola red para cada solicitud.
  • Las apps que se ejecutan en Android 12 o versiones posteriores pueden usar el método WifiAwareManager.getAvailableAwareResources() para obtener la cantidad de rutas de datos disponibles actualmente, publicar sesiones y suscribirse a sesiones. Esto puede ayudar a la app a determinar si hay recursos disponibles suficientes para ejecutar la funcionalidad deseada.

Configuración inicial

Si quieres configurar tu app para usar el descubrimiento y las redes de reconocimiento de Wi-Fi, realiza los siguientes pasos:

  1. Solicita los siguientes permisos en el manifiesto de tu app:

    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
    <uses-permission android:name="android.permission.INTERNET" />
    <!-- If your app targets Android 13 (API level 33)
         or higher, you must declare the NEARBY_WIFI_DEVICES permission. -->
    <uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES"
                     <!-- If your app derives location information from
                          Wi-Fi APIs, don't include the "usesPermissionFlags"
                          attribute. -->
                     android:usesPermissionFlags="neverForLocation" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
                     <!-- If any feature in your app relies on precise location
                          information, don't include the "maxSdkVersion"
                          attribute. -->
                     android:maxSdkVersion="32" />
  2. Comprueba si el dispositivo admite Wi-Fi Aware con la API de PackageManager, como se muestra a continuación:

    Kotlin

    context.packageManager.hasSystemFeature(PackageManager.FEATURE_WIFI_AWARE)

    Java

    context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_WIFI_AWARE);
  3. Comprueba si el reconocimiento de Wi-Fi está disponible actualmente. Es posible que el reconocimiento de Wi-Fi exista en el dispositivo, pero es posible que no esté disponible actualmente porque el usuario inhabilitó Wi-Fi o ubicación. Según sus capacidades de hardware y firmware, es posible que algunos dispositivos no admitan el reconocimiento de Wi-Fi si Wi-Fi Direct, SoftAP o la conexión mediante dispositivo móvil están en uso. Para verificar si el reconocimiento de Wi-Fi está disponible actualmente, llama a isAvailable().

    La disponibilidad del reconocimiento de Wi-Fi puede cambiar en cualquier momento. Tu app debe registra un BroadcastReceiver para recibir ACTION_WIFI_AWARE_STATE_CHANGED: que se envía cuando cambia la disponibilidad. Cuando tu app recibe el de transmisión, debería descartar todas las sesiones existentes (supón que se interrumpió el reconocimiento de Wi-Fi), luego revisa el el estado actual de disponibilidad y ajustar su comportamiento en consecuencia. Por ejemplo:

    Kotlin

    val wifiAwareManager = context.getSystemService(Context.WIFI_AWARE_SERVICE) as WifiAwareManager?
    val filter = IntentFilter(WifiAwareManager.ACTION_WIFI_AWARE_STATE_CHANGED)
    val myReceiver = object : BroadcastReceiver() {
    
        override fun onReceive(context: Context, intent: Intent) {
            // discard current sessions
            if (wifiAwareManager?.isAvailable) {
                ...
            } else {
                ...
            }
        }
    }
    context.registerReceiver(myReceiver, filter)

    Java

    WifiAwareManager wifiAwareManager = 
            (WifiAwareManager)context.getSystemService(Context.WIFI_AWARE_SERVICE)
    IntentFilter filter =
            new IntentFilter(WifiAwareManager.ACTION_WIFI_AWARE_STATE_CHANGED);
    BroadcastReceiver myReceiver = new BroadcastReceiver() {
        @Override
        public void onReceive(Context context, Intent intent) {
            // discard current sessions
            if (wifiAwareManager.isAvailable()) {
                ...
            } else {
                ...
            }
        }
    };
    context.registerReceiver(myReceiver, filter);

Para obtener más información, consulta Transmisiones.

Obtén una sesión

Para comenzar a usar el reconocimiento de Wi-Fi, tu app debe obtener un WifiAwareSession llamando attach() Este método hace lo siguiente:

  • Activa el hardware de reconocimiento de Wi-Fi.
  • Se une a un clúster de reconocimiento de Wi-Fi o forma uno.
  • Crea una sesión de reconocimiento de Wi-Fi con un espacio de nombres único que actúa como un contenedor para todas las sesiones de descubrimiento creadas en él.

Si la app se conecta correctamente, el sistema ejecuta la devolución de llamada onAttached(). Esta devolución de llamada proporciona un objeto WifiAwareSession. que tu app debe usar para todas las demás operaciones de sesión. Una app puede usar la sesión para publicar un servicio o suscribirse a un servicio.

Tu app debería llamar attach() solo una vez. Si tu app llama a attach() varias veces, recibe una sesión diferente para cada llamada, cada una con su propio espacio de nombres. Esto podría ser útil en situaciones complejas, pero por lo general, evitar.

Publica un servicio

Para que un servicio sea detectable, llama al publish(), que toma los siguientes parámetros:

  • PublishConfig especifica el nombre del servicio y otras propiedades de configuración, como el filtro de coincidencias.
  • DiscoverySessionCallback especifica las acciones que se deben ejecutar cuando se producen eventos, como cuando el suscriptor recibe un mensaje.

Por ejemplo:

Kotlin

val config: PublishConfig = PublishConfig.Builder()
        .setServiceName(AWARE_FILE_SHARE_SERVICE_NAME)
        .build()
awareSession.publish(config, object : DiscoverySessionCallback() {

    override fun onPublishStarted(session: PublishDiscoverySession) {
        ...
    }

    override fun onMessageReceived(peerHandle: PeerHandle, message: ByteArray) {
        ...
    }
})

Java

PublishConfig config = new PublishConfig.Builder()
    .setServiceName(Aware_File_Share_Service_Name)
    .build();

awareSession.publish(config, new DiscoverySessionCallback() {
    @Override
    public void onPublishStarted(PublishDiscoverySession session) {
        ...
    }
    @Override
    public void onMessageReceived(PeerHandle peerHandle, byte[] message) {
        ...
    }
}, null);

Si la publicación se realiza correctamente, se llama al método de devolución de llamada onPublishStarted().

Después de la publicación, cuando los dispositivos que ejecutan apps de suscriptor coincidentes pasen a la al alcance de Wi-Fi del dispositivo de publicación, los suscriptores descubren el servicio. Cuando un suscriptor descubre un publicador, el publicador no recibe una notificación; sin embargo, si el suscriptor envía un mensaje al publicador, el publicador recibe una notificación. Cuando eso sucede, el onMessageReceived() de devolución de llamada. Puedes usar la PeerHandle de este método para enviar un mensaje al suscriptor crea una conexión con él.

Para dejar de publicar el servicio, llama a DiscoverySession.close(). Las sesiones de descubrimiento están asociadas a su elemento superior WifiAwareSession Si la sesión principal está cerrada, sus sesiones de descubrimiento asociadas también están cerradas. Si bien los objetos descartados también están cerrados, el sistema no garantiza cuándo se cierran las sesiones fuera del alcance, por lo que recomendamos que llames explícitamente a los métodos close().

Suscríbete a un servicio

Para suscribirte a un servicio, llama al método subscribe(), que toma los siguientes parámetros:

  • SubscribeConfig especifica el nombre del servicio al cual suscribirse y otras propiedades de configuración, como el filtro de coincidencias.
  • DiscoverySessionCallback especifica la acciones para ejecutar cuando ocurren eventos, como cuando se descubre a un publicador.

Por ejemplo:

Kotlin

val config: SubscribeConfig = SubscribeConfig.Builder()
        .setServiceName(AWARE_FILE_SHARE_SERVICE_NAME)
        .build()
awareSession.subscribe(config, object : DiscoverySessionCallback() {

    override fun onSubscribeStarted(session: SubscribeDiscoverySession) {
        ...
    }

    override fun onServiceDiscovered(
            peerHandle: PeerHandle,
            serviceSpecificInfo: ByteArray,
            matchFilter: List<ByteArray>
    ) {
        ...
    }
}, null)

Java

SubscribeConfig config = new SubscribeConfig.Builder()
    .setServiceName("Aware_File_Share_Service_Name")
    .build();

awareSession.subscribe(config, new DiscoverySessionCallback() {
    @Override
    public void onSubscribeStarted(SubscribeDiscoverySession session) {
        ...
    }

    @Override
    public void onServiceDiscovered(PeerHandle peerHandle,
            byte[] serviceSpecificInfo, List<byte[]> matchFilter) {
        ...
    }
}, null);

Si la operación de suscripción se realiza correctamente, el sistema llama a onSubscribeStarted() en tu app. Debido a que puedes usar el el argumento SubscribeDiscoverySession en para comunicarte con un editor después de que tu aplicación haya descubierto uno, debe guardar esta referencia. Puedes actualizar la sesión de suscripción en cualquier momento llamando a updateSubscribe() en la sesión de descubrimiento.

En este momento, tu suscripción esperará a que los publicadores coincidan para entrar en el rango de Wi-Fi. Cuando esto sucede, el sistema ejecuta onServiceDiscovered() de devolución de llamada. Puedes usar el argumento PeerHandle de esta devolución de llamada para enviar un mensaje o crear una conexión con ese publicador.

Para cancelar la suscripción a un servicio, llama DiscoverySession.close() Las sesiones de descubrimiento están asociadas a su elemento superior WifiAwareSession Si la sesión principal está cerrada, sus sesiones de descubrimiento asociadas también están cerradas. Si bien los objetos descartados también están cerrados, el sistema no garantiza cuándo se cierran las sesiones fuera del alcance, por lo que recomendamos que llames explícitamente a los métodos close().

Cómo enviar un mensaje

Para enviar un mensaje a otro dispositivo, necesitas los siguientes objetos:

Para enviar un mensaje, llama sendMessage() El pueden ocurrir las siguientes devoluciones de llamada:

Si bien el PeerHandle es obligatorio para comunicarse con tus pares, no debes hacerlo confiar en él como un identificador permanente de pares. Los identificadores de nivel superior pueden que usa la aplicación, incorporadas en el servicio de descubrimiento o en mensajes posteriores. Puedes incorporar un identificador en el servicio de descubrimiento con el método setMatchFilter() o setServiceSpecificInfo() de PublishConfig o SubscribeConfig. El El método setMatchFilter() afecta el descubrimiento, mientras que el El método setServiceSpecificInfo() no afecta el descubrimiento.

Incorporar un identificador en un mensaje implica modificar el arreglo de bytes del mensaje para incluir un identificador (por ejemplo, como el primer par de bytes).

Crea una conexión

El reconocimiento de Wi-Fi admite la red cliente-servidor entre dos dispositivos con esa función.

Para configurar la conexión cliente-servidor:

  1. Usa el descubrimiento de reconocimiento de Wi-Fi para publicar un servicio (en el servidor) y suscribirte a un servicio (en el cliente).

  2. Una vez que el suscriptor descubre al publicador, Enviar un mensaje del suscriptor al publicador

  3. Inicia un ServerSocket en el dispositivo del publicador y configura u obtén su puerto:

    Kotlin

    val ss = ServerSocket(0)
    val port = ss.localPort

    Java

    ServerSocket ss = new ServerSocket(0);
    int port = ss.getLocalPort();
  4. Usa ConnectivityManager para solicita una red de reconocimiento de Wi-Fi en el editor mediante un WifiAwareNetworkSpecifier, especificando la sesión de descubrimiento y PeerHandle del suscriptor que obtuviste del mensaje transmitido por el suscriptor:

    Kotlin

    val networkSpecifier = WifiAwareNetworkSpecifier.Builder(discoverySession, peerHandle)
        .setPskPassphrase("somePassword")
        .setPort(port)
        .build()
    val myNetworkRequest = NetworkRequest.Builder()
        .addTransportType(NetworkCapabilities.TRANSPORT_WIFI_AWARE)
        .setNetworkSpecifier(networkSpecifier)
        .build()
    val callback = object : ConnectivityManager.NetworkCallback() {
        override fun onAvailable(network: Network) {
            ...
        }
    
        override fun onCapabilitiesChanged(network: Network, networkCapabilities: NetworkCapabilities) {
            ...
        }
    
        override fun onLost(network: Network) {
            ...
        }
    }
    
    connMgr.requestNetwork(myNetworkRequest, callback);

    Java

    NetworkSpecifier networkSpecifier = new WifiAwareNetworkSpecifier.Builder(discoverySession, peerHandle)
        .setPskPassphrase("somePassword")
        .setPort(port)
        .build();
    NetworkRequest myNetworkRequest = new NetworkRequest.Builder()
        .addTransportType(NetworkCapabilities.TRANSPORT_WIFI_AWARE)
        .setNetworkSpecifier(networkSpecifier)
        .build();
    ConnectivityManager.NetworkCallback callback = new ConnectivityManager.NetworkCallback() {
        @Override
        public void onAvailable(Network network) {
            ...
        }
    
        @Override
        public void onCapabilitiesChanged(Network network, NetworkCapabilities networkCapabilities) {
            ...
        }
    
        @Override
        public void onLost(Network network) {
            ...
        }
    };
    
    ConnectivityManager connMgr.requestNetwork(myNetworkRequest, callback);
  5. Cuando el publicador solicite una red, debería Envía un mensaje al suscriptor.

  6. Una vez que el suscriptor reciba el mensaje del publicador, solicita una conexión Wi-Fi. Reconoce la red del suscriptor y usa el mismo método que el publicador. Lo que debes hacer no especificar un puerto cuando se crea la NetworkSpecifier Se llama a los métodos de devolución de llamada adecuados cuando la conexión de red está disponible, cambia o se pierde.

  7. Una vez que se llama al método onAvailable() en el suscriptor, un objeto Network está disponible, y con él puedes abrir un Socket para comunicarte con el ServerSocket en el publicador, pero necesitas conocer la dirección IPv6 y el puerto de ServerSocket. Los obtienes del objeto NetworkCapabilities provisto en la devolución de llamada onCapabilitiesChanged():

    Kotlin

    val peerAwareInfo = networkCapabilities.transportInfo as WifiAwareNetworkInfo
    val peerIpv6 = peerAwareInfo.peerIpv6Addr
    val peerPort = peerAwareInfo.port
    ...
    val socket = network.getSocketFactory().createSocket(peerIpv6, peerPort)

    Java

    WifiAwareNetworkInfo peerAwareInfo = (WifiAwareNetworkInfo) networkCapabilities.getTransportInfo();
    Inet6Address peerIpv6 = peerAwareInfo.getPeerIpv6Addr();
    int peerPort = peerAwareInfo.getPort();
    ...
    Socket socket = network.getSocketFactory().createSocket(peerIpv6, peerPort);
  8. Cuando termines con la conexión de red, llama a unregisterNetworkCallback().

Rango de app similares y descubrimiento del conocimiento de la ubicación

Un dispositivo con capacidades de ubicación de Wi-Fi RTT puede medir directamente la distancia a apps similares y usar esta información para restringir el descubrimiento del servicio de reconocimiento de Wi-Fi.

La API de Wi-Fi RTT permite el rango directo a una app similar con reconocimiento de Wi-Fi usando su dirección MAC o su PeerHandle.

El descubrimiento de reconocimiento de Wi-Fi puede estar restringido a solo descubrir servicios dentro de un un geovallado en particular. Por ejemplo, puedes configurar un geovallado que permita el descubrimiento de un dispositivo que publica un servicio de "Aware_File_Share_Service_Name" que no está menos de 3 metros (especificado como 3,000 mm) y no más de 10 metros (especificado como 10,000 mm).

Para habilitar el geovallado, tanto el publicador como el suscriptor deben tomar medidas:

  • El publicador debe habilitar el rango en el servicio publicado con setRangingEnabled(true).

    Si el publicador no habilita el rango, se aplicarán las restricciones de geovallado. especificadas por el suscriptor se ignoran y se realiza el descubrimiento normal, ignorando la distancia.

  • El suscriptor debe especificar un geovallado usando alguna combinación de setMinDistanceMm y setMaxDistanceMm

    Para cualquier valor, si no se especifica una distancia, esto implica que no hay un límite. Si solo se especifica la distancia máxima, esto implica una distancia mínima de 0. Solo se especifica el la distancia mínima implica que no hay un máximo.

Cuando se descubre un servicio de intercambio de tráfico en un geovallado, onServiceDiscoveredWithinRange se activa la devolución de llamada, que proporciona la distancia medida con la app similar. Luego, se puede llamar a la API de Wi-Fi RTT directa según sea necesario para medir la distancia más adelante.