The QBluetoothLocalDevice class provides access to local Bluetooth devices. More...
#include <QBluetoothLocalDevice>
Inherits: QObject.
This class was introduced in Qt Mobility 1.2.
| enum | Error { NoError, PairingError, UnknownError } |
| enum | HostMode { HostPoweredOff, HostConnectable, HostDiscoverable, HostDiscoverableLimitedInquiry } |
| enum | Pairing { Unpaired, Paired, AuthorizedPaired } |
| QBluetoothLocalDevice ( QObject * parent = 0 ) | |
| QBluetoothLocalDevice ( const QBluetoothAddress & address, QObject * parent = 0 ) | |
| virtual | ~QBluetoothLocalDevice () |
| QBluetoothAddress | address () const |
| HostMode | hostMode () const |
| bool | isValid () const |
| QString | name () const |
| Pairing | pairingStatus ( const QBluetoothAddress & address ) const |
| void | powerOn () |
| void | requestPairing ( const QBluetoothAddress & address, Pairing pairing ) |
| void | setHostMode ( QBluetoothLocalDevice::HostMode mode ) |
| void | pairingConfirmation ( bool accept ) |
| void | error ( QBluetoothLocalDevice::Error error ) |
| void | hostModeStateChanged ( QBluetoothLocalDevice::HostMode state ) |
| void | pairingDisplayConfirmation ( const QBluetoothAddress & address, QString pin ) |
| void | pairingDisplayPinCode ( const QBluetoothAddress & address, QString pin ) |
| void | pairingFinished ( const QBluetoothAddress & address, QBluetoothLocalDevice::Pairing pairing ) |
| QList<QBluetoothHostInfo> | allDevices () |
The QBluetoothLocalDevice class provides access to local Bluetooth devices.
QBluetoothLocalDevice provides functions for getting and setting the state of local Bluetooth devices.
This enum describes errors that maybe returned
| Constant | Value | Description |
|---|---|---|
| QBluetoothLocalDevice::NoError | 0 | No known error |
| QBluetoothLocalDevice::PairingError | 1 | Error in pairing |
| QBluetoothLocalDevice::UnknownError | 100 | Unknown error |
This enum describes the most of the local Bluetooth device.
| Constant | Value | Description |
|---|---|---|
| QBluetoothLocalDevice::HostPoweredOff | 0 | Powers the device down |
| QBluetoothLocalDevice::HostConnectable | 1 | Remote Bluetooth devices can connect to the local Bluetooth device if they have previously been paired with it or otherwise know its address. This powers up the device if it was powered off. |
| QBluetoothLocalDevice::HostDiscoverable | 2 | Remote Bluetooth devices can discover the presence of the local Bluetooth device. The device will also be connectable, and powered on. |
| QBluetoothLocalDevice::HostDiscoverableLimitedInquiry | 3 | Remote Bluetooth devices can discover the presence of the local Bluetooth device when performing a limited inquiry. This should be used for locating services that are only made discoverable for a limited period of time. This can speed up discovery between games for example, since service discovery can be skipped on devices not in limited enquiry more. This is not supported on all platforms. The device will also be connectable, and powered on. |
This enum describes the pairing state between two Bluetooth devices.
| Constant | Value | Description |
|---|---|---|
| QBluetoothLocalDevice::Unpaired | 0 | The Bluetooth devices are not paired. |
| QBluetoothLocalDevice::Paired | 1 | The Bluetooth devices are paired. The system will prompt the user for authorization when the remote device initiates a connection to the local device. |
| QBluetoothLocalDevice::AuthorizedPaired | 2 | The Bluetooth devices are paired. The system will not prompt the user for authorization when the remote device initiates a connection to the local device. |
Constructs a QBluetoothLocalDevice with parent.
Construct new QBluetoothLocalDevice for address.
Destroys the QBluetoothLocalDevice.
Returns the MAC address of this Bluetooth device.
Returns a list of all available local Bluetooth devices.
Signal emitted for pairing if there's an exceptional error
Returns the current host mode of this local Bluetooth device.
See also setHostMode().
The state of the host has transitioned to a different HostMode
Returns true the QBluetoothLocalDevice represents an available local Bluetooth device; otherwise return false.
Returns the name assgined by the user to this Bluetooth device.
To be called after getting a pairingDisplayConfirmation(). The accept parameter either accepts the pairing or rejects it.
Signal by some platforms to display a pairing confirmation dialog for address. The user is asked to confirm the pin is the same on both devices. QBluetoothLocalDevice::pairingConfirmation(bool) must be called to indicate if the user accepts or rejects the displayed pin.
Signal by some platforms to display the pin to the user for address. The pin is automatically generated, and does not need to be confirmed.
Pairing has completed with address. Current pairing status is in pairing.
Returns the current bluetooth pairing status of address, if it's unpaired, paired, or paired and authorized.
Powers on the device on returning it to the hostMode() state is was in when powered down
Set the pairing status with address. The results are returned via the signal pairingFinished(). Caution: creating a pairing may take minutes, and can require the user to acknowledge dialogs.
Sets the host mode the this local Bluetooth device to mode.
See also hostMode().
© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.
All other trademarks are property of their respective owners. Privacy Policy
Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.
Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.