BTInfo Class
Properties Methods Events Configuration Settings Errors
The BTInfo class helps find and manage information about Bluetooth devices and services.
Syntax
BTInfo
Remarks
The BTInfo class may be used to get information about local and nearby Bluetooth devices.
Information about the Bluetooth radios on the local system is obtained through the Radio* properties. Set RadioIndex to select a radio to inspect its values.
The ListDevices method will search for nearby devices and provide results through the Device* properties. The DeviceInfo event will also fire with information about each device.
Call ListServices to list local or remote services. This provides an easy way to discover information about the services on a device, such as which port a service is listening on, before attempting to connect with BTPort. The Service* properties hold information about the services. The ServiceInfo event will also fire for each service.
Additionally the class may be used to manage local services. Call AddLocalService to add a new service. This functionality may be used after BTDaemon is listening to allow clients to connect more easily.
Other methods allow additional functionality, such as ResolveName, ResolveAddress, RequestAuth, and more.
Property List
The following is the full list of the properties of the class with short descriptions. Click on the links for further details.
DeviceAddress | The Bluetooth address of the device identified by DeviceIndex. |
DeviceAuthenticated | Specifies whether the device is authenticated, paired, or bonded. |
DeviceClassOfDevice | Device class for the Bluetooth device. |
DeviceConnected | Specifies whether the device is connected. |
DeviceCount | The number of bluetooth devices. |
DeviceIndex | Sets the current device. |
DeviceLastSeen | Last time the device was seen. |
DeviceLastUsed | Last time the device was used. |
DeviceName | Name of the device. |
DeviceRemembered | Whether the device is a remembered device. |
RadioAddress | The Bluetooth address of the radio identified by RadioIndex. |
RadioClassOfDevice | Device class for the local Bluetooth radio. |
RadioConnectable | Gets or sets whether a Bluetooth radio accepts incoming connections. |
RadioCount | The number of bluetooth radios in the system. |
RadioDiscoverable | Gets or sets whether a Bluetooth radio is discoverable. |
RadioIndex | Sets the current radio. |
RadioManufacturer | Manufacturer of the Bluetooth radio. |
RadioName | Name of the Bluetooth radio. |
RadioSubversion | Holds the radio subversion. |
ServiceAddress | The Bluetooth address of the service. |
ServiceClassId | The service class Id (UUID). |
ServiceComment | A comment describing the service. |
ServiceCount | The number of services on the device. |
ServiceIndex | Sets the current service. |
ServiceName | The name of the service. |
ServiceOtherClassId | A list of other class Ids. |
ServicePort | The port on which the service is listening. |
ServiceProtocol | The protocol used by the service. |
Method List
The following is the full list of the methods of the class with short descriptions. Click on the links for further details.
AddLocalService | Adds a local service. |
Config | Sets or retrieves a configuration setting. |
DoEvents | Processes events from the internal message queue. |
GetServiceInfo | Retrieves information about the specified service. |
ListDevices | Lists all nearby devices. |
ListServices | List local or remote services. |
RemoveAuth | Removes the authentication of specified device. |
RemoveLocalService | Removes the selected service. |
RequestAuth | Requests authentication to a device. |
ResolveAddress | Resolves an Bluetooth address. |
ResolveName | Resolves a device name to an address. |
StartAuthMonitor | Start monitoring for authentication requests. |
StopAuthMonitor | Stops monitoring for authentication requests. |
Event List
The following is the full list of the events fired by the class with short descriptions. Click on the links for further details.
AuthRequest | Fired when a device requests authentication. |
DeviceInfo | Fired once for each device found when calling ListDevices. |
Error | Information about errors during data delivery. |
ServiceInfo | Fired once for each service found when calling ListServices. |
Configuration Settings
The following is a list of configuration settings for the class with short descriptions. Click on the links for further details.
InquireFromAllRadios | Whether the inquiry is sent from all radios. |
InquiryTimeout | The approximate time in seconds to wait for an inquiry response. |
IssueInquiry | Whether an inquiry is performed, or cached values are used. |
BuildInfo | Information about the product's build. |
CodePage | The system code page used for Unicode to Multibyte translations. |
LicenseInfo | Information about the current license. |
ProcessIdleEvents | Whether the class uses its internal event loop to process events when the main thread is idle. |
SelectWaitMillis | The length of time in milliseconds the class will wait when DoEvents is called if there are no events to process. |
UseInternalSecurityAPI | Tells the class whether or not to use the system security libraries or an internal implementation. |