ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / Bluetooth
  • Limitation
  • 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
BTInfoDevice (Function)
In french: BTInfoPériphérique
Returns specific information about a Bluetooth device.
AndroidAndroid Widget Caution: Bluetooth functions are not available in the Android emulator.
Example
sListDevices is string
sADevice is string
sId is string
sName is string
sMACAddress is string
// Clears the list
TableDeleteAll(TABLE_Devices)
// Returns the list of nearby Bluetooth devices
sListDevices = BTListDevice(btSimpleList)
// Browse the connected devices
FOR EACH STRING sADevice OF sListDevices SEPARATED BY CR
// Stores the device information
sId = ExtractString(sADevice, 1)
sName = ExtractString(sADevice, 3)
sMACAddress = ExtractString(sADevice, 2)
// The name is explicitly requested if it is not specified
IF sName ~= "" THEN sName = BTInfoDevice(sId, btName)
// Fills the Table control with the devices
TableAddLine(TABLE_Devices, False, sId, sName, sMACAddress)
END
Syntax
<Result> = BTInfoDevice(<Device identifier> , <Requested information>)
<Result>: Character string
Requested information about the specified device.
<Device identifier>: Integer
Identifier of the Bluetooth device to use. This identifier is returned by BTListDevice or BTSelectDevice.
<Requested information>: Integer constant
Information about the device. The table below lists the available information as well as the values that can be returned:
btClassOfDeviceClass of the device, may correspond to one of the following constants:
  • btCoD_NetworkAccess
  • btCoD_AudioVideo
  • btCoD_Miscellaneous
  • btCoD_Imaging
  • btCoD_Unknown
  • btCoD_Toy
  • btCoD_Computer
  • btCoD_Device
  • btCoD_Phone
  • btCoD_Wearable
btLastTimeSeenDate and time when the device was viewed for the last time by the current computer. This date is in DDMMYYYYHHMMSS format.
AndroidAndroid Widget This constant is not available.
btLastTimeUsedDate and time when the device was used for the last time by the current computer. This date is in DDMMYYYYHHMMSS format.
AndroidAndroid Widget This constant is not available.
btMACAddressMAC address of the device
btNameDevice name
btStatusAuthenticated
  • 1 if the device is currently authenticated beside the current computer,
  • 0 otherwise.
btStatusConnected
  • 1 if the device is currently "connected" to the current computer,
  • 0 otherwise.
AndroidAndroid Widget This constant is not available.
btStatusRemembered
  • 1 if the device is currently "remembered" by the Bluetooth device of the current computer,
  • 0 otherwise.
AndroidAndroid Widget This constant is not available.
Remarks
Windows

Limitation

This version only supports Microsoft, Bluesoleil and Broadcom (Widcomm) bluetooth stacks. To know the stack used, call BTStack.
The Broadcom (Widcomm) stacks are not available in 64 bits.
For more details, see Which stacks to use?
AndroidAndroid Widget

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: wd290com.dll
Minimum version required
  • Version 12
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help