-
Notifications
You must be signed in to change notification settings - Fork 7
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
5 changed files
with
156 additions
and
17 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,135 @@ | ||
| # Wifi Manager for MAUI | ||
|
|
||
| MAUI Wi-Fi Manager is comprehensive solution designed specifically for MAUI. This library empowers developers to effortlessly manage Wi-Fi networks within their cross-platform applications. With its intuitive APIs, you can seamlessly integrate Wi-Fi functionality, allowing users to connect to, add, and retrieve information about Wi-Fi networks with ease. | ||
|
|
||
|
|
||
| ## Features | ||
|
|
||
| **Connect Wi-Fi with SSID and Password:** Enable users to connect to Wi-Fi networks by providing the SSID and password. | ||
|
|
||
| **Add a New Wi-Fi Network:** Seamlessly add new Wi-Fi networks to the device. | ||
|
|
||
| **Get Current Network Info:** Retrieve information about the currently connected Wi-Fi network. | ||
|
|
||
| **Disconnect Wi-Fi:** Allow users to disconnect from a Wi-Fi network. | ||
|
|
||
| **Open Wi-Fi Setting:** Provide a quick way for users to access their device's Wi-Fi settings. | ||
|
|
||
| ## Getting started | ||
|
|
||
| ### Initialization | ||
|
|
||
| Before using the MAUI Wi-Fi Manager plugin in your application, it's essential to initialize it. Here's how to do it on different platforms: | ||
|
|
||
| #### Android | ||
|
|
||
| To use the MAUI Wi-Fi Manager on Android, you must initialize the plugin. Add the following code to your Android application: | ||
|
|
||
| ```csharp | ||
| WifiNetworkService.Init(this); | ||
| ``` | ||
|
|
||
| Android Permissions | ||
|
|
||
| ```xml | ||
| <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.ACCESS_NETWORK_STATE" /> | ||
| <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> | ||
| <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> | ||
| ``` | ||
|
|
||
| Make sure you request location before scanning Wi-Fi | ||
|
|
||
| #### iOS | ||
|
|
||
| Add wifi-info and HotspotConfiguration in Entitlements.plist | ||
|
|
||
| ```xml | ||
| <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> | ||
| <plist version="1.0"> | ||
| <dict> | ||
| <key>com.apple.developer.networking.wifi-info</key> | ||
| <true/> | ||
| <key>com.apple.developer.networking.HotspotConfiguration</key> | ||
| <true/> | ||
| </dict> | ||
| </plist> | ||
| ``` | ||
|
|
||
| Request location permisson on info.plist | ||
|
|
||
| ```xml | ||
| <key>NSLocationWhenInUseUsageDescription</key> | ||
| <string>App want to access location to get ssid</string> | ||
| ``` | ||
|
|
||
| Example | ||
|
|
||
| ```csharp | ||
| PermissionStatus status = await Permissions.RequestAsync<Permissions.LocationWhenInUse>(); | ||
| if (status == PermissionStatus.Granted) | ||
| { | ||
| var response = await CrossWifiManager.Current.ScanWifiNetworks(); | ||
| } | ||
| else | ||
| await DisplayAlert("No location permisson", "Please provide location permission", "OK"); | ||
| ``` | ||
|
|
||
| #### Connect to Wi-Fi | ||
|
|
||
| To connect to a Wi-Fi network programmatically, use the ConnectWifi method. This method takes the SSID and password as parameters. Here's an example: | ||
|
|
||
| ```csharp | ||
| var response = await CrossWifiManager.Current.ConnectWifi(ssid, password); | ||
| ``` | ||
|
|
||
| The NetworkData class is defined as follows: | ||
|
|
||
| ```csharp | ||
| public class NetworkData | ||
| { | ||
| public int StausId { get; set; } | ||
| public string? Ssid { get; set; } | ||
| public int IpAddress { get; set; } | ||
| public string? GatewayAddress { get; set; } | ||
| public object? NativeObject { get; set; } | ||
| public object? Bssid { get; set; } | ||
| public object? SignalStrength { get; set; } | ||
| } | ||
| ``` | ||
|
|
||
| #### Scan available Wi-Fi (Not available on iOS) | ||
|
|
||
| You can available Wi-Fi networks using the ScanWifiNetworks method: | ||
|
|
||
| ```csharp | ||
| var response = await CrossWifiManager.Current.ScanWifiNetworks(); | ||
| ``` | ||
|
|
||
| #### Get Wi-Fi info | ||
|
|
||
| You can retrieve information about the currently connected Wi-Fi network using the GetNetworkInfo method: | ||
|
|
||
| ```csharp | ||
| var response = await CrossWifiManager.Current.GetNetworkInfo(); | ||
| ``` | ||
|
|
||
| #### Disconnect Wi-Fi | ||
|
|
||
| To disconnect from a Wi-Fi network, simply call the DisconnectWifi method with the SSID as a parameter: | ||
|
|
||
| ```csharp | ||
| CrossWifiManager.Current.DisconnectWifi(ssid); | ||
| ``` | ||
|
|
||
| #### Open Wi-Fi Setting | ||
|
|
||
| If you want to provide users with a convenient way to access their device's Wi-Fi settings, use the OpenWifiSetting method: | ||
|
|
||
| ```csharp | ||
| var response = await CrossWifiManager.Current.OpenWifiSetting(); | ||
| ``` | ||
|
|
||
| I value your feedback! If you encounter any issues, have suggestions for improvement, or wish to report bugs, please open an issue on GitHub or GitLab repository |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters