QBluetoothLocalDevice Class

成员函数文档

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

使用parent 实例化一个QBluetoothLocalDevice。

另请参阅 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 上，无法解除设备的配对关系。如果请求 Unpaired，尽管设备仍保持配对状态，但会立即触发pairingFinished() 信号。可以请求与之前已解除配对的设备重新配对。此外，AuthorizedPaired 的行为与Paired 相同。

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

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

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

某些状态转换（例如设备开机或关机）可能需要一定时间。因此，后续调用应仅在 `hostModeStateChanged()` 信号确认前一次请求已完成之后才进行。若忽略此要求，此类连续调用的结果将未定义。

另请参阅 hostMode()。