QBluetoothLocalDevice 类

成员函数文档

[显式] QBluetoothLocalDevice::QBluetoothLocalDevice(QObject *parent = nullptr)

使用 parent 构造 QBluetoothLocalDevice。

另请参阅isValid。

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

为 地址 构造新的 QBluetoothLocalDevice。如果 地址 是默认构造的，那么生成的本地设备选择本地默认设备。

另请参阅isValid。

[虚函数，不然不抛出异常] QBluetoothLocalDevice::~QBluetoothLocalDevice()

销毁 QBluetoothLocalDevice。

QBluetoothAddress QBluetoothLocalDevice::address() const

返回此蓝牙设备的 MAC 地址。

[静态] QList<QBluetoothHostInfo> QBluetoothLocalDevice::allDevices()

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

QList<QBluetoothAddress> QBluetoothLocalDevice::connectedDevices() const

返回连接设备列表。此列表与当前配对设备列表不同。

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

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

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

当本地设备通过 地址 建立与远程设备的连接时发出此信号。

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

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

当本地设备从通过 地址 的远程蓝牙设备断开时发出此信号。

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

[信号，自 6.2 版起] void QBluetoothLocalDevice::errorOccurred(QBluetoothLocalDevice::Error error)

如果配对时发生异常 错误，则发出此信号。

此函数是在 Qt 6.2 中引入的。

QBluetoothLocalDevice::HostMode QBluetoothLocalDevice::hostMode() const

获取本地蓝牙设备的当前主模式。在macOS上，它可以是 HostPoweredOff 或 HostConnectable。

另见：setHostMode。

[信号] void QBluetoothLocalDevice::hostModeStateChanged(QBluetoothLocalDevice::HostMode state)

主机模式已转换为不同的 HostMode。

bool QBluetoothLocalDevice::isValid() const

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

如果using本类的实例表示的本地蓝牙适配器从系统（例如，移除底层蓝牙适配器）中移除，则此实例将无效。当相同的蓝牙适配器返回到系统时，已无效的 QBluetoothLocalDevice 实例仍然无效。

另见：allDevices。

QString QBluetoothLocalDevice::name() const

返回用户分配给此蓝牙设备的名称。

[信号] 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)

使用地址设置配对状态。结果通过信号pairingFinished()返回。

在Android和macOS上，AuthorizedPaired不可用，其行为与Paired相同。在Windows上，精确的配对模式决策由操作系统负责。

在macOS上，无法解除设备的配对。如果请求解除配对，尽管设备仍然配对，pairingFinished()会立即发出。对于之前未配对的设备可以请求配对。另外，AuthorizedPaired与Paired具有相同的行为。

注意：创建配对可能需要数分钟，可能需要用户确认。

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

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

一些转换，如开启或关闭设备，可能需要一些时间。因此，后续调用应在hostModeStateChanged()信号完成上一个请求后进行。如果忽略这一点，此类一系列调用的结果定义不良。

另请参阅hostMode。