第28章 Qt Sensors传感器：加速度计、陀螺仪、磁力计、光线传感器、传感器数据融合

说到移动端开发，传感器这块儿是绕不开的。我最早接触Qt Sensors是在做一个室内导航项目，当时被陀螺仪的漂移问题折腾得够呛。后来慢慢摸透了这些传感器的脾气，才发现——嗯，其实Qt封装得挺友好的，关键是你得知道每个传感器能干什么、不能干什么。

28.1 传感器基础概念

传感器说白了就是把物理世界的信号转成数字信号。手机里常见的传感器有加速度计、陀螺仪、磁力计、光线传感器等等。Qt把它们统一封装成了QSensor的子类，用起来非常一致。

我个人习惯把传感器分为三类：

• 运动类：加速度计、陀螺仪、陀螺仪
• 环境类：光线传感器、温度传感器、气压计
• 位置类：磁力计（电子罗盘）

每个传感器都有三个核心要素：数据速率、数据范围、精度。这三个参数直接影响你拿到的数据质量。

28.2 加速度计（Accelerometer）

加速度计测量的是设备在X、Y、Z三个轴上的加速度，单位是m/s²。注意，它测的是「比力」，也就是包含重力在内的总加速度。

我在项目中遇到过一个问题：手机平放时，Z轴读数应该是9.8左右，但有些设备会读到9.6或10.0。这是因为传感器出厂校准有偏差。解决办法是——做一次静态校准，记录偏移量。

// 创建加速度计
QAccelerometer *sensor = new QAccelerometer(this);
sensor->setDataRate(50); // 50Hz采样率

// 连接数据槽
connect(sensor, &QAccelerometer::readingChanged, this, [=]() {
    QAccelerometerReading *reading = sensor->reading();
    qreal x = reading->x();
    qreal y = reading->y();
    qreal z = reading->z();
    qDebug() << "加速度:" << x << y << z;
});

sensor->start();

28.3 陀螺仪（Gyroscope）

陀螺仪测量的是角速度，单位是rad/s。它告诉你设备在绕哪个轴旋转、转得多快。但有个坑——陀螺仪有零偏漂移。你把它静止放着，读数可能不是0，而是0.01或-0.02。

我曾经做过一个AR应用，用陀螺仪跟踪手机姿态。刚开始直接积分角速度，结果5分钟后姿态就飘到天上去了。后来加了卡尔曼滤波才稳住。

QGyroscope *gyro = new QGyroscope(this);
gyro->setDataRate(100);

connect(gyro, &QGyroscope::readingChanged, this, [=]() {
    QGyroscopeReading *reading = gyro->reading();
    qreal rx = reading->x(); // 绕X轴角速度
    qreal ry = reading->y(); // 绕Y轴角速度
    qreal rz = reading->z(); // 绕Z轴角速度
});

gyro->start();

28.4 磁力计（Magnetometer）

磁力计测量的是磁场强度，单位是微特斯拉（µT）。它最常用的场景就是做电子罗盘，告诉你北在哪。

但磁力计有个大问题——容易受干扰。手机扬声器、马达、甚至你手上的金属手表都会影响读数。我在做导航项目时，发现手机靠近电脑音箱时，方向直接偏了30度。

QMagnetometer *mag = new QMagnetometer(this);
mag->setDataRate(50);

connect(mag, &QMagnetometer::readingChanged, this, [=]() {
    QMagnetometerReading *reading = mag->reading();
    qreal mx = reading->x();
    qreal my = reading->y();
    qreal mz = reading->z();
    qreal calib = reading->calibrationLevel(); // 校准等级 0~1
});

mag->start();

28.5 光线传感器（Light Sensor）

光线传感器相对简单，它只返回一个值——环境光照强度，单位是lux。应用场景主要是自动调节屏幕亮度。

QLightSensor *light = new QLightSensor(this);
light->setDataRate(10); // 光线变化不快，10Hz足够

connect(light, &QLightSensor::readingChanged, this, [=]() {
    QLightReading *reading = light->reading();
    qreal lux = reading->lux();
    // 根据lux调整UI亮度
});

light->start();

嗯，这里要注意：光线传感器的响应速度比较慢，不要指望它瞬间捕捉到变化。我一般会加一个滑动平均滤波，让亮度变化更平滑。

28.6 传感器数据融合

单个传感器都有缺陷，但把它们组合起来就能互补。最经典的融合就是「加速度计 + 陀螺仪 + 磁力计」得到稳定的姿态角（俯仰、横滚、偏航）。

Qt没有直接提供融合算法，但我们可以用QOrientationSensor或者自己实现互补滤波。我个人推荐互补滤波，计算量小，效果也不错。

// 互补滤波伪代码
void updateAttitude(qreal dt, 
                    qreal gx, qreal gy, qreal gz,  // 陀螺仪
                    qreal ax, qreal ay, qreal az,  // 加速度计
                    qreal mx, qreal my, qreal mz)  // 磁力计
{
    // 1. 从加速度计计算俯仰和横滚
    qreal pitch = atan2(-ax, sqrt(ay*ay + az*az));
    qreal roll  = atan2(ay, az);
    
    // 2. 从磁力计计算偏航（需要先补偿俯仰和横滚）
    // ... 坐标变换代码略 ...
    
    // 3. 互补滤波：陀螺仪积分 + 加速度计/磁力计修正
    const qreal alpha = 0.98; // 权重
    pitch = alpha * (pitch + gx * dt) + (1-alpha) * pitch_acc;
    roll  = alpha * (roll  + gy * dt) + (1-alpha) * roll_acc;
    yaw   = alpha * (yaw   + gz * dt) + (1-alpha) * yaw_mag;
}

28.7 知识体系总览

下面这张图把本章的核心逻辑串起来了。你看一眼就能明白每个传感器负责什么、融合后得到什么。

28.8 实际项目中的注意事项

最后分享几个我在项目中踩过的坑：

• 传感器启动顺序：先启动所有传感器，等第一个数据到来后再开始融合。否则初始时刻数据为空，融合结果会跳变。
• 线程问题：readingChanged信号是在传感器线程中发出的，不要在槽函数里做耗时操作。如果需要处理大量数据，用Qt::QueuedConnection或者自己开工作线程。
• 省电策略：不需要高频率时，把setDataRate设低一点。比如光线传感器10Hz就够，没必要跑100Hz。
• 设备差异：不同手机的传感器质量差别很大。低端机的陀螺仪漂移可能比高端机大一个数量级。做产品时一定要在多种设备上测试。

---