cordova-plugin-wifi-manager

cordova-plugin-wifi-manager

Wi-Fi Manager Plugin for Apache Cordova

Supported Platforms

• Android: 5.0 or later
• iOS: 10.0 or later

Installation

cordova plugin add cordova-plugin-wifi-manager

Notice

When you use this plugin for Android 10 (API level 29) or later, you can connect to the Internet only through your own (cordova) app. This is due to the specification of new Android API, WifiNetworkSpecifier.

If you want to purposely use the deprecated Android API, run the following.

cordova run android --device -- --gradleArg=-PcdvTargetSdkVersion=28 

Usage

Connect to Wi-Fi access point

document.addEventListener('deviceready', onDeviceReady, false);

function onDeviceReady () {
  window.wifiManager.connect(
    'SAMPLE_SSID',
    'SAMPLE_PASSPHRASE',
    function () {
      console.log('connect method was successfully called.');
    },
    function (result) {
      console.log('disconnect method failed to be called. ' +
        'code: ' + result.code + ', message: ' + result.message);
    }
  );
}

Disconnect from Wi-Fi access point

document.addEventListener('deviceready', onDeviceReady, false);

function onDeviceReady () {
  window.wifiManager.disconnect(
    'SAMPLE_SSID',
    function () {
      console.log('disconnect method was successfully called.');
    },
    function (result) {
      console.log('disconnect method failed to be called. ' +
        'code: ' + result.code + ', message: ' + result.message);
    }
  );
}

License

cordova-plugin-wifi-manager is available under the MIT license. See the LICENSE file for details.

Changelog

0.4.0 (2021-07-05)

• Update package.json and plugin interfaces. #24
• Does not add json object in success callback. #25
• Unregister networkCallback before connecting if needed. #26
• Supports the deprecated Android API even with CLI. #27