在Qt开发中，与蓝牙相关的API主要包括QBluetooth和QBluetoothDeviceDiscoveryAgent两个类。QBluetooth用于管理设备的蓝牙连接，而QBluetoothDeviceDiscoveryAgent用于搜索周围的蓝牙设备。

首先我们需要在AndroidManifest.xml文件中添加蓝牙权限：

```

```

接下来需要在代码中引用QBluetooth和QBluetoothDeviceDiscoveryAgent类：

```

#include

#include

#include

```

在进行蓝牙操作前，需要先实例化QBluetoothLocalDevice对象。例如：

```

QBluetoothLocalDevice localDevice;

```

接下来可以通过下面的代码查询本地设备是否支持蓝牙：

```

if (!localDevice.isValid()) {

qDebug() << "本地设备不支持蓝牙";

return;

}

```

接下来使用QBluetoothServiceDiscoveryAgent对象来扫描周围的蓝牙设备。示例如下：

```

auto discoveryAgent = new QBluetoothDeviceDiscoveryAgent(this);

connect(discoveryAgent, &QBluetoothDeviceDiscoveryAgent::deviceDiscovered,

this, &Bluetooth::deviceDiscovered);

connect(discoveryAgent, QOverload::of(&QBluetoothDeviceDiscoveryAgent::error),

this, &Bluetooth::deviceScanError);

connect(discoveryAgent, &QBluetoothDeviceDiscoveryAgent::finished,

this, &Bluetooth::scanFinished);

// 开始扫描

discoveryAgent->start();

```

在声明了QBluetoothDeviceDiscoveryAgent的对象后，我们需要声明三个信号和三个槽用于处理扫描的设备。其中设备发现信号deviceDiscovered包括扫描到的设备的QBluetoothDeviceInfo对象作为参数，错误信号deviceScanError包含错误码作为参数，结束信号scanFinished没有参数。

接下来是我们不要忘记的信号槽对应关系：

```

void Bluetooth::deviceDiscovered(const QBluetoothDeviceInfo &device)

{

qDebug() << "发现设备：" << device.name() << endl;

}

void Bluetooth::deviceScanError(QBluetoothDeviceDiscoveryAgent::Error error)

{

qDebug() << "扫描设备出现错误：" << error;

}

void Bluetooth::scanFinished()

{

qDebug() << "扫描设备完成";

}

```

最后，我们需要连接到扫描完成信号，以确保在结束后清理蓝牙设备。例如：

```

connect(discoveryAgent, &QBluetoothDeviceDiscoveryAgent::finished,

discoveryAgent, &QBluetoothDeviceDiscoveryAgent::deleteLater);

```

以上是Qt安卓开发使用蓝牙的基本原理及详细介绍。希望对大家有所帮助！