PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • 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> [, <Timeout>])
<WLanguage procedure>: Procedure name
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>, <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.
<Timeout>: 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 another monitoring is in progress, the previous monitoring will stop and a new monitoring will start.
Android

Required permissions

The call to this function modifies the permissions required by the application.
Required permissions :
  • BLUETOOTH: this permission allows the applications to connect to the Bluetooth services.
  • Versions 25 and later
    ACCESS_COARSE_LOCATION: this permission allows an application to access an undefined location (Cell-ID, WiFi).
    New in version 25
    ACCESS_COARSE_LOCATION: this permission allows an application to access an undefined location (Cell-ID, WiFi).
    ACCESS_COARSE_LOCATION: this permission allows an application to access an undefined location (Cell-ID, WiFi).
Android 10 specific case: Android 10 has implemented a new permission for the functions that allow locating the device: ACCESS_BACKGROUND_PERMISSION.
This permission allows using the function when the application is in the background.
When this permission is added to the application, a window allows the user 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 this permissions at any time in the Android settings.
Component : wd250android.jar
Minimum version required
  • Version 21
Comments
Click [Add] to post a comment