QBluetoothLocalDevice Class

成员功能文档

[explicit] QBluetoothLocalDevice::QBluetoothLocalDevice(QObject *parent = nullptr)

构建一个 QBluetoothLocalDevice（蓝牙本地设备），parent 。

另请参阅 isValid().

[explicit] QBluetoothLocalDevice::QBluetoothLocalDevice(const QBluetoothAddress &address, QObject *parent = 0)

为address 构建新的 QBluetoothLocalDevice。如果address 是默认构造，生成的本地设备将选择本地默认设备。

另请参阅 isValid().

[virtual noexcept] QBluetoothLocalDevice::~QBluetoothLocalDevice()

摧毁QBluetoothLocalDevice.

QBluetoothAddress QBluetoothLocalDevice::address() const

返回蓝牙设备的 MAC 地址。

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

返回所有可用本地蓝牙设备的列表。在 macOS 上，只有 "默认 "本地设备。

QList<QBluetoothAddress> QBluetoothLocalDevice::connectedDevices() const

返回已连接设备的列表。该列表不同于当前已配对设备的列表。

在 Android 和 macOS 上，无法检索已连接设备的列表。只能监听（取消）连接的变化。为方便起见，该类会监控自启动以来的所有连接和断开事件，并在调用此函数时返回当前列表。因此，在创建实例后不久，该函数可能会返回一个空列表。

另请参阅 deviceConnected() 和deviceDisconnected()。

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

当本地设备通过address 与远程设备建立连接时，就会发出该信号。

另请参阅 deviceDisconnected() 和connectedDevices()。

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

当本地设备与远程蓝牙设备断开连接时会发出该信号，address 。

另请参阅 deviceConnected() 和connectedDevices()。

[signal, since 6.2] void QBluetoothLocalDevice::errorOccurred(QBluetoothLocalDevice::Error error)

配对过程中出现异常error 时发出的信号。

该函数在 Qt 6.2 中引入。

QBluetoothLocalDevice::HostMode QBluetoothLocalDevice::hostMode() const

返回本地蓝牙设备的当前主机模式。在 macOS 上，它是HostPoweredOff 或HostConnectable 。

另请参阅 setHostMode()。

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

state 的主机已过渡到不同的HostMode 。

bool QBluetoothLocalDevice::isValid() const

如果QBluetoothLocalDevice 代表可用的本地蓝牙设备，则返回true ；否则返回 false。

如果该类实例所代表的本地蓝牙适配器从系统中移除（如移除底层蓝牙加密狗），则该实例将变为无效。即使同一蓝牙适配器返回到系统中，已经失效的QBluetoothLocalDevice 实例仍将保持失效。

另请参阅 allDevices().

QString QBluetoothLocalDevice::name() const

返回用户为该蓝牙设备指定的名称。

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

配对或解除配对已通过address 完成。当前配对状态见pairing 。如果配对请求未成功，则不会发出该信号。如果配对请求失败，则会发出errorOccurred() 信号。只有在配对请求之前调用当前对象实例的requestPairing() 时，才会发出该信号。

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

返回address 的当前蓝牙配对状态，是未配对、已配对还是已配对并授权。

void QBluetoothLocalDevice::powerOn()

如果设备已关闭电源，则在返回hostMode() 状态后开启设备。

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

使用address 设置pairing 状态。结果通过信号pairingFinished() 返回。

在 Android 和 macOS 上，AuthorizedPaired 是不可能的，其行为与 Paired 相同。在 Windows 上，具体的配对模式由操作系统决定。

在 macOS 上，无法取消设备配对。如果请求取消配对，则会立即发出pairingFinished() 信号，但设备仍保持配对状态。可以为之前未配对的设备请求配对。此外，AuthorizedPaired 的行为与Paired 相同。

注意：创建配对可能需要几分钟时间，而且可能需要用户确认。

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

将此本地蓝牙设备的主机模式设置为mode 。

某些转换（如打开或关闭设备）可能需要一些时间。因此，只有在hostModeStateChanged() 信号结束前一个请求后，才能进行后续调用。如果忽略了这一点，一系列呼叫的结果将无法很好地界定。

另请参阅 hostMode().