BTLEConnectionStatus (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Use conditions
Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

BTLEConnectionStatus (Function)

In french: BTLEEtatConnexion

Returns the current status of the connection to a Bluetooth Low Energy device or asks to be notified when the connection status changes.

Note: The Bluetooth functions are not available in the Android emulator.

Example

myDevice is btleDevice
BTLEConnect(myDevice)
...
SWITCH BTLEConnectionStatus(myDevice)
CASE btleStatusConnected
// Process
OTHER CASE
...
END

Syntax

Finding out the current connection status Hide the details

<Result> = BTLEConnectionStatus(<Device>)

<Result>: Integer constant

Connection status:
btleStatusConnected The device is connected to the specified Bluetooth device.
btleStatusDisconnected The device is not connected to the specified Bluetooth device.

<Device>: btleDevice variable

Name of btleDevice variable corresponding to the device to use.

Enabling the notification whenever Bluetooth activation changes Hide the details

BTLEConnectionStatus(<Procedure>)

<Procedure>: Name of WLanguage procedure

Name of WLangage procedure ("callback" procedure) that will be called when the status of Bluetooth connection changes on the device. This procedure has the following format :

PROCEDURE <Procedure name> (<Device>, <Status>)

where:
<Device> is a btleDevice variable corresponding to the Bluetooth device whose status is retrieved.
<Status> is an integer corresponding ot the status of Bluetooth connection on the device:
btleStatusConnected The device is connected to the specified Bluetooth device.
btleStatusDisconnected The device is not connected to the specified Bluetooth device.
There is no need to pass parameters to this procedure. Indeed, these parameters are automatically filled during each call.

Remarks

Use conditions

The WLanguage Bluetooth Low Energy functions are available for the devices running an Android version greater than or equal to version 4.3 (api level 18).
- A fatal error occurs if the function is used with an earlier system version.
- To find out the version of Android system on which the application is run, use SysAndroidVersion.
The WLanguage Bluetooth Low Energy functions are available from iOS 9.

Required permissions

The call to this function modifies the permissions required by the application.

Required permission: BLUETOOTH.

This permission allows the applications to connect to the Bluetooth services.

Component : wd250android.jar