Member Function Documentation

QBluetoothLocalDevice::​QBluetoothLocalDevice(QObject * parent = 0)

Constructs a QBluetoothLocalDevice with parent.

QBluetoothLocalDevice::​QBluetoothLocalDevice(const QBluetoothAddress & address, QObject * parent = 0)

Construct new QBluetoothLocalDevice for address. If address is default constructed the resulting local device selects the local default device.

[virtual] QBluetoothLocalDevice::​~QBluetoothLocalDevice()

Destroys the QBluetoothLocalDevice.

QBluetoothAddress QBluetoothLocalDevice::​address() const

Returns the MAC address of this Bluetooth device.

[static] QList<QBluetoothHostInfo> QBluetoothLocalDevice::​allDevices()

Returns a list of all available local Bluetooth devices.

QList<QBluetoothAddress> QBluetoothLocalDevice::​connectedDevices() const

Returns the list of connected devices. This list is different from the list of currently paired devices.

On Android it is not possible to retrieve a list of connected devices. It is only possible to listen to (dis)connect changes. For convenience, this class monitors all connect and disconnect events since its instanciation and returns the current list when calling this function. Therefore it is possible that this function returns an empty list shortly after creating an instance.

This function was introduced in Qt 5.3.

See also deviceConnected() and deviceDisconnected().

[signal] void QBluetoothLocalDevice::​deviceConnected(const QBluetoothAddress & address)

This signal is emitted when the local device establishes a connection to a remote device with address.

This function was introduced in Qt 5.3.

See also deviceDisconnected() and connectedDevices().

[signal] void QBluetoothLocalDevice::​deviceDisconnected(const QBluetoothAddress & address)

This signal is emitted when the local device disconnects from a remote Bluetooth device with address.

This function was introduced in Qt 5.3.

See also deviceConnected() and connectedDevices().

[signal] void QBluetoothLocalDevice::​error(QBluetoothLocalDevice::Error error)

Signal emitted if there's an exceptional error while pairing.

HostMode QBluetoothLocalDevice::​hostMode() const

Returns the current host mode of this local Bluetooth device.

See also setHostMode().

[signal] void QBluetoothLocalDevice::​hostModeStateChanged(QBluetoothLocalDevice::HostMode state)

The state of the host has transitioned to a different HostMode.

bool QBluetoothLocalDevice::​isValid() const

Returns true if the QBluetoothLocalDevice represents an available local Bluetooth device; otherwise return false.

If the local Bluetooth adapter represented by an instance of this class is removed from the system (e.g. removal of the underlying Bluetooth dongle) then this instance will become invalid. An already invalid QBluetoothLocalDevice instance remains invalid even if the same Bluetooth adapter is returned to the system.

See also allDevices().

QString QBluetoothLocalDevice::​name() const

Returns the name assgined by the user to this Bluetooth device.

[slot] void QBluetoothLocalDevice::​pairingConfirmation(bool accept)

To be called after getting a pairingDisplayConfirmation(). The accept parameter either accepts the pairing or rejects it.

Accepting a pairing always refers to the last pairing request issued via requestPairing().

[signal] void QBluetoothLocalDevice::​pairingDisplayConfirmation(const QBluetoothAddress & address, QString pin)

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. The pairingConfirmation() function must be called to indicate if the user accepts or rejects the displayed pin.

This signal is only emitted for pairing requests issues by calling requestPairing().

See also pairingConfirmation().

[signal] void QBluetoothLocalDevice::​pairingDisplayPinCode(const QBluetoothAddress & address, QString 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.

This signal is only emitted for pairing requests issues by calling requestPairing().

[signal] void QBluetoothLocalDevice::​pairingFinished(const QBluetoothAddress & address, QBluetoothLocalDevice::Pairing pairing)

Pairing or unpairing has completed with address. Current pairing status is in pairing. If the pairing request was not successful, this signal will not be emitted. The error() signal is emitted if the pairing request failed. The signal is only ever emitted for pairing requests which have previously requested by calling requestPairing() of the current object instance.

Pairing QBluetoothLocalDevice::​pairingStatus(const QBluetoothAddress & address) const

Returns the current bluetooth pairing status of address, if it's unpaired, paired, or paired and authorized.

void QBluetoothLocalDevice::​powerOn()

Powers on the device after returning it to the hostMode() state, if it was powered off.

Note: Due to varying security policies on the supported platforms, this method may have differing behaviors on the various platforms. For example the system may ask the user for confirmation before turning Bluetooth on or off. Please refer to the platform specific Bluetooth documentation for details.

void QBluetoothLocalDevice::​requestPairing(const QBluetoothAddress & address, Pairing pairing)

Set the pairing status with address. The results are returned by the signal, pairingFinished(). On BlackBerry AuthorizedPaired is not possible and will have the same behavior as Paired. Caution: creating a pairing may take minutes, and may require the user to acknowledge.

void QBluetoothLocalDevice::​setHostMode(QBluetoothLocalDevice::HostMode mode)

Sets the host mode of this local Bluetooth device to mode.

Note: Due to varying security policies on the supported platforms, this method may have differing behaviors on the various platforms. For example the system may ask the user for confirmation before turning Bluetooth on or off and not all host modes may be supported. Please refer to the platform specific Bluetooth documentation for details.

See also hostMode().