ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / WiFi functions
  • Required permissions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
WiFiConnectionInfo (Function)
In french: WiFiInfoConnexion
Returns the requested information about the current Wi-Fi connection of the device.
Example
Info(StringBuild("Your current connection speed is equal to %1 Mbps ", WiFiConnectionInfo(wifiSpeed)))
Syntax
<Result> = WiFiConnectionInfo([<Type of information>])
<Result>: Character string
  • Requested information. If several types of information are requested, each type of information is separated by a CR character (Carriage Return).
    The order in which the information is returned (if requested) is as follows: wifiSSID + wifiBSSID + wifiIPAddress + wifiMacAddress + wifiSpeed + wifiIDNetwork
  • Empty string ("") if the device is not connected to a Wi-Fi access point. The ErrorOccurred variable is set to True. ErrorInfo returns more information on the error.
<Type of information>: Optional Integer constant
Requested information:
wifiAll
(Default value)
Full information about the connection (corresponds to wifiSSID + wifiBSSID + wifiIPAddress + wifiMacAddress + wifiSpeed + wifiIDNetwork).
wifiBSSIDBSSID (Basic Service Set Identifier) of the access point of the connection.
wifiIDNetwork
  • Identifier of the network to which the device is connected,
  • Empty string ("") if the device is connected to no identified network.
wifiIPAddressIP address associated with the connection.
wifiMACAddressWi-Fi Mac address of the device.
Caution: From Android SDK version 6, the Mac address returned has the following format "02:00:00:00:00:00".
wifiSpeedSpeed of the Wi-Fi link (expressed in Mbps).
wifiSSIDSSID (Service Set Identifier) of the Wi-Fi network to which the device is connected.
Remarks
AndroidAndroid Widget

Required permissions

Calling this function changes the permissions required by the application.
Required permissions:
  • ACCESS_WIFI_STATE: This permission allows the applications to access information regarding the Wi-Fi networks.
  • ACCESS_FINE_LOCATION: This permission allows the application to access precise device location.
Android 11 specific case: This function requires the ACCESS_BACKGROUND_LOCATION permission to access the device's location.
This permission allows using the function when the application is in the background.
If the application needs to use background location:
  • Manually add the "ACCESS_BACKGROUND_LOCATION" permission in the Android application generation wizard.
  • Explicitly request background location permission with PermissionRequest. For example:
    PermissionRequest(permBackgroundLocation, Callback)
    INTERNAL PROCÉDURE Callback(p is Permission)
    IF p.Granted THEN
    // Functions that require background location access can be used
    END
    END
A window allows users to:
  • allow access to the device location while the application is in the background,
  • allow access to the location only while the application is in use,
  • deny access to the location. The user can also change these permissions at any time in the Android settings.

Remarks:
  • Follow Google's guidelines for applications that require background location access. For more details, see https://support.google.com/googleplay/android-developer/answer/9799150. If these conditions are not met (especially user information requirements), applications may not be accepted for publication on Google Play.
  • The background location permission should only be requested if the location permission has been granted. Otherwise, PermissionRequest will fail.
  • If the option chosen by the user for the background location access request is more restrictive than the option chosen for the location access request, the application will be automatically restarted.
  • On devices running Android 10 or earlier, if location permission has been granted to the application, the background location permission will be granted without displaying a window.
Related Examples:
WM System Cross-platform examples (WINDEV Mobile): WM System
[ + ] This application is an example of some of the features of WINDEV Mobile available for Android/iOS.
The following system functions are used:
- NFC
- Multimedia control
- Brightness
- Volume
- Wi-Fi
- Bluetooth
- Toast
- Compass
- Accelerometer
- Camera control
- LED
- Vibration
- Notifications
- Drawing functions
- Internet
Component: wd290com.dll
Minimum version required
  • Version 16
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/23/2023

Send a report | Local help