PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Various
  • Required permissions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Returns the list of accessible Bluetooth Low Energy devices.
Example
BTLEListDevice(ProcDetectDevice)
...

INTERNAL PROCEDURE ProcDetectDevice(ADevice)
// Process ADevice
END
Syntax
BTLEListDevice(<WLanguage Procedure> [, <Time-out>])
<WLanguage Procedure>: Character string (with or without quotes)
Name of WLanguage procedure ("callback" procedure) that will be called to list the devices. This procedure is used to get information about the devices found.
This procedure has the following format:
PROCEDURE <Procedure Name>(<Device>)

where <Device> is a btleDevice variable corresponding to the detected device.
If the procedure returns False, the monitoring of accessible devices will be immediately stopped.
This procedure has the following format:
PROCEDURE <Procedure Name> (<Device>, <Signal Intensity>)

where:
  • <Device> is a btleDevice variable corresponding to the connected device.
  • Versions 22 and later
    <Signal Intensity> is an integer corresponding to the intensity of signal expressed in decibel per meter.
    New in version 22
    <Signal Intensity> is an integer corresponding to the intensity of signal expressed in decibel per meter.
    <Signal Intensity> is an integer corresponding to the intensity of signal expressed in decibel per meter.
If the procedure returns False, the monitoring of accessible devices will be immediately stopped.
<Time-out>: Optional integer or optional Duration
Time-out for the search (in seconds). This parameter can correspond to:
  • an integer corresponding to the number of seconds,
  • a Duration variable,
  • Versions 23 and later
    the direct indication of duration (1 s for example).
    New in version 23
    the direct indication of duration (1 s for example).
    the direct indication of duration (1 s for example).
If this parameter is not specified, the default time-out is set to 10 seconds.
Remarks

Various

  • If BTLEListDevice is called while a monitoring is in progress, the previous monitoring will be stopped and a new monitoring will be started.
  • Android 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 will occur 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.
  • iPhone/iPad The WLanguage Bluetooth Low Energy functions are available from iOS 9.
Android

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.
Components
Android wd230android.jar
Minimum required version
  • Version 21
Comments
Click [Add] to post a comment