BTLEConnectionStatus (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Communication / BTLE functions

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: Bluetooth functions are not available in the Android emulator.

Example

monPériph is btleDevice
BTLEConnect(monPériph)
...
SWITCH BTLEConnectionStatus(monPériph)
	CASE btleStatusConnected
	// Traitement
	OTHER CASE
	...
END

Syntax

Finding out the current connection status Hide the details

<Result> = BTLEConnectionStatus(<Device>)

<Result>: Integer constant

Status of the connection:
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 the btleDevice variable corresponding to the device to use.

Enabling the notification whenever Bluetooth activation changes Hide the details

BTLEConnectionStatus(<WLanguage procedure>)

<WLanguage procedure>: Procedure name

Name of WLanguage procedure (called "callback") called when Bluetooth connection status 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 to 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

Required permissions

This function changes the permissions required by the application.

Permission required: BLUETOOTH.

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

Necessary versions

Android applications:
- Bluetooth Low Energy WLanguage functions are only available on devices with Android 4.3 or later (api level 18).
- A fatal error occurs if the function is used with an earlier system version.
- To determine the version of Android the application is running on, use SysAndroidVersion.
iOS applications:
The WLanguage Bluetooth Low Energy functions are available for the devices running iOS 9.
WINDEV applications:
- Bluetooth Low Energy WLanguage functions are only available on:
  - PCs that support at least Bluetooth Low Energy 5.
  - PCs using a Bluetooth device that supports at least Bluetooth Low Energy 5.
- If necessary, you can check the Bluetooth version of a PC in the Windows device manager: https://support.microsoft.com/en-us/windows/what-bluetooth-version-is-on-my-pc-f5d4cff7-c00d-337b-a642-d2d23b082793
- Pairing must be done via Windows. Therefore, BTLEListDevice will only list devices that are visible and associated in the Windows Bluetooth settings.

Business / UI classification: Business Logic

Component: wd300com.dll