QBluetoothLocalDevice provides functions for getting and setting the state of local Bluetooth devices.
On iOS and Windows, this class cannot be used because the platform does not expose any data or API which may provide information on the local Bluetooth device.
- class PySide6.QtBluetooth.QBluetoothLocalDevice([parent=None])¶
address is default constructed the resulting local device selects the local default device.
This enum describes the pairing state between the two Bluetooth devices.
The Bluetooth devices are not paired.
The Bluetooth devices are paired. The system will prompt the user for authorization when the remote device initiates a connection to the local device.
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.
This enum describes the most of the local Bluetooth device.
Power off the device
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.
Remote Bluetooth devices can discover the presence of the local Bluetooth device. The device will also be connectable, and powered on. On Android, this mode can only be active for a maximum of 5 minutes.
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 gaming devices, as service discovery can be skipped on devices not in LimitedInquiry mode. In this mode, the device will be connectable and powered on, if required. This mode is is not supported on Android. On macOS, it is not possible to set the
hostMode()to or .
This enum describes errors that maybe returned
No known error
Error in pairing
- Return type
Returns the MAC address of this Bluetooth device.
On Android, this function always returns the constant value
02:00:00:00:00:00 as local address starting with Android 6.0. The programmatic access to the device’s local MAC address was removed.
- static PySide6.QtBluetooth.QBluetoothLocalDevice.allDevices()¶
- Return type
Returns a list of all available local Bluetooth devices. On macOS, there is only the “default” local device.
- Return type
Returns the list of connected devices. This list is different from the list of currently paired devices.
On Android and macOS, 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.
Returns the current host mode of this local Bluetooth device. On macOS, it is either
- Return type
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.
- Return type
Returns the name assgined by the user to this Bluetooth device.
- PySide6.QtBluetooth.QBluetoothLocalDevice.pairingFinished(address, pairing)¶
Returns the current bluetooth pairing status of
address, if it’s unpaired, paired, or paired and authorized.
Powers on the device after returning it to the
hostMode() state, if it was powered off.
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. On macOS it is not possible to power on/off Bluetooth. Please refer to the platform specific Bluetooth documentation for details.
- PySide6.QtBluetooth.QBluetoothLocalDevice.requestPairing(address, pairing)¶
pairing status with
address. The results are returned by the signal,
pairingFinished() . On Android and macOS,
AuthorizedPaired is not possible and will have the same behavior as Paired.
On macOS, it is not possible to unpair a device. If Unpaired is requested,
pairingFinished() is immediately emitted although the device remains paired. It is possible to request the pairing for a previously unpaired device. In addition
AuthorizedPaired has the same behavior as
Caution: creating a pairing may take minutes, and may require the user to acknowledge.
Sets the host mode of this local Bluetooth device to
Some transitions such as turning the device on or off may take some time. Therefore subsequent calls should only be made once the
hostModeStateChanged() signal has concluded the previous request. If this is ignored the result of such a series of calls is not well defined.
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. On macOS, it is not possbile to programmatically change the
hostMode() . A user can only switch Bluetooth on/off in the System Preferences. Please refer to the platform specific Bluetooth documentation for details.
© 2022 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.