react-native-android-wifi

A react-native module for viewing and connecting to Wifi networks on Android devices.

Installation

Add it to your android project

npm install react-native-android-wifi --save

Install the native dependencies

Use react-native link to install native dependencies automatically:

react-native link react-native-android-wifi

or do it manually as described here.

Example usage

importwififrom'react-native-android-wifi';

Permissions: Starting with Android API 25, apps must be granted the ACCESS_COARSE_LOCATION (or ACCESS_FINE_LOCATION) permission in order to obtain results.

try{constgranted=awaitPermissionsAndroid.request(PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION,{'title': 'Wifi networks','message': 'We need your permission in order to find wifi networks'})if(granted===PermissionsAndroid.RESULTS.GRANTED){console.log("Thank you for your permission! :)");}else{console.log("You will not able to retrieve wifi available networks list");}}catch(err){console.warn(err)}

Wifi connectivity status:

wifi.isEnabled((isEnabled)=>{if(isEnabled){console.log("wifi service enabled");}else{console.log("wifi service is disabled");}});

Enable/Disable wifi service:

//Set TRUE to enable and FALSE to disable; wifi.setEnabled(true);

Sign device into a specific network:

This method doesn't have a callback when connection succeeded, check this issue. Added support for 'WPA2 PSK' wifi security mode and handling SSID for Lollipop and Kitkat.

//found returns true if ssid is in the rangewifi.findAndConnect(ssid,password,(found)=>{if(found){console.log("wifi is in range");}else{console.log("wifi is not in range");}});

Disconnect from current wifi network

wifi.disconnect();

Get current SSID

wifi.getSSID((ssid)=>{console.log(ssid);});

Get current BSSID

wifi.getBSSID((bssid)=>{console.log(bssid);});

Get all wifi networks in range

/*wifiStringList is a stringified JSONArray with the following fields for each scanned wifi{ "SSID": "The network name", "BSSID": "The address of the access point", "capabilities": "Describes the authentication, key management, and encryption schemes supported by the access point" "frequency":"The primary 20 MHz frequency (in MHz) of the channel over which the client is communicating with the access point", "level":"The detected signal level in dBm, also known as the RSSI. (Remember its a negative value)", "timestamp":"Timestamp in microseconds (since boot) when this result was last seen"}*/wifi.loadWifiList((wifiStringList)=>{varwifiArray=JSON.parse(wifiStringList);console.log(wifiArray);},(error)=>{console.log(error);});

connectionStatus returns true or false depending on whether device is connected to wifi

wifi.connectionStatus((isConnected)=>{if(isConnected){console.log("is connected");}else{console.log("is not connected");}});

Get connected wifi signal strength

//level is the detected signal level in dBm, also known as the RSSI. (Remember its a negative value)wifi.getCurrentSignalStrength((level)=>{console.log(level);});

Get connected wifi frequency

wifi.getFrequency((frequency)=>{console.log(frequency);})

Get current IP

//get the current network connection IPwifi.getIP((ip)=>{console.log(ip);});

Get DHCP Server Adress

//get the DHCP server IPwifi.getDhcpServerAddress((ip)=>{console.log(ip);});

Remove/Forget the Wifi network from mobile by SSID, returns boolean This method will remove the wifi network as per the passed SSID from the device list.

wifi.isRemoveWifiNetwork(ssid,(isRemoved)=>{console.log("Forgetting the wifi device - "+ssid);});

Starts native Android wifi network scanning and returns list Hard refresh the Android wifi scan, implemented using BroadcastReceiver to ensure that it automatically detects new wifi connections available.

wifi.reScanAndLoadWifiList((wifiStringList)=>{varwifiArray=JSON.parse(wifiStringList);console.log('Detected wifi networks - ',wifiArray);},(error)=>{console.log(error);});

Method to force wifi usage. Android by default sends all requests via mobile data if the connected wifi has no internet connection.

//Set true/false to enable/disable forceWifiUsage.//Is important to enable only when communicating with the device via wifi//and remember to disable it when disconnecting from device.wifi.forceWifiUsage(true);

Method to get connection status of a forced network (because it takes some time to be set up).

//Callback returns true if the process of forcing network usage is finishedwifi.connectionStatusOfBoundNetwork((isBound)=>{if(isBound){console.log('Network is bound');}else{console.log('Network isn\'t bound');}});

Add a hidden wifi network and connect to it

//Callback returns true if network added and tried to connect to it successfully//It may take up to 15s to connect to hidden networkswifi.connectToHiddenNetwork(ssid,password,(networkAdded)=>{});