Qt6开发Android应用开启闪光灯手电筒功能无效问题求助

Qt 6.3.1版本QCamera控制移动端闪光灯失败，核心原因有三点：

• 调用时序错误：QCamera的硬件特性加载是异步流程，在相机未完成初始化、未激活的状态下直接调用setTorchMode()、查询支持性，后端会直接返回不支持/不执行操作，所有模式配置必须在相机激活完成后执行才有效。
• 权限缺失：Qt 6在Android/iOS平台不会自动申请相机运行时权限，哪怕硬件本身支持闪光灯，未拿到权限时所有硬件特性查询都会返回false。另外之前查询的是isFlashModeSupported()，该接口对应拍照瞬间补光的Flash模式，常亮手电筒对应的是Torch模式，两个接口的支持性返回是独立的，查错接口也会得到错误结果。
• 后端适配bug：Qt 6.3.1的多媒体模块对部分国产定制Android系统的相机HAL层适配不全，部分设备上即使权限、时序都正确，也可能返回Torch模式不支持。

1. 先补全平台权限配置 #

• Android端：在项目的AndroidManifest.xml中添加以下配置

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera.flash" android:required="false"/>

• iOS端：在项目的Info.plist中添加NSCameraUsageDescription字段，写明相机权限用途，否则系统会直接拦截权限申请。

2. 修正QCamera调用逻辑 #

不要在构造函数、相机未激活时直接配置模式，通过信号监听相机激活状态，启动前先申请运行时权限，参考代码：

// 类构造函数中初始化相机、绑定信号
cam = new QCamera(QCameraDevice::BackFace, this);
connect(cam, &QCamera::activeChanged, this, [this](bool isActive){
    if (isActive) {
        // 相机激活完成后再查询特性、设置模式
        bool torchSupported = cam->isTorchModeSupported(QCamera::TorchOn);
        ui->Flash->setText(torchSupported ? "Torch: Yes" : "Torch: No");
    }
});

// 按钮点击触发的手电筒控制逻辑
void YourWidget::onTorchControlClicked()
{
#if QT_CONFIG(permissions)
    // 先申请相机运行时权限
    QCameraPermission cameraPerm;
    const auto permStatus = qApp->checkPermission(cameraPerm);
    if (permStatus == Qt::PermissionStatus::Undetermined) {
        qApp->requestPermission(cameraPerm, this, [this](const QPermission& result){
            if (result.status() == Qt::PermissionStatus::Granted) {
                cam->start();
            }
        });
        return;
    }
    if (permStatus == Qt::PermissionStatus::Denied) {
        // 可在此处添加权限被拒的提示
        return;
    }
#endif
    // 权限校验通过后操作相机
    if (!cam->isActive()) {
        cam->start();
        // 等activeChanged信号触发后再开Torch
        connect(cam, &QCamera::activeChanged, this, [this](){
            cam->setTorchMode(QCamera::TorchOn);
            // 单次触发后断开信号避免重复绑定
            disconnect(cam, &QCamera::activeChanged, this, nullptr);
        }, Qt::SingleShotConnection);
    } else {
        // 已激活状态直接切换模式
        auto currentTorchState = cam->torchMode();
        cam->setTorchMode(currentTorchState == QCamera::TorchOn ? QCamera::TorchOff : QCamera::TorchOn);
    }
}

3. 闪烁功能实现 #

用QTimer定时切换Torch模式即可，避免阻塞UI线程：

// 头文件声明私有成员 QTimer *blinkTimer;
blinkTimer = new QTimer(this);
connect(blinkTimer, &QTimer::timeout, this, [this](){
    static bool blinkState = false;
    cam->setTorchMode(blinkState ? QCamera::TorchOff : QCamera::TorchOn);
    blinkState = !blinkState;
});

// 开启闪烁：设置间隔（单位ms）后启动定时器
// blinkTimer->start(500);
// 关闭闪烁：停止定时器后关闭手电筒
// blinkTimer->stop();
// cam->setTorchMode(QCamera::TorchOff);

4. 适配特殊设备 #

如果上述逻辑在部分Android设备上仍然无法点亮闪光灯，是Qt 6.3.1后端适配缺陷导致，可直接通过Qt JNI接口调用Android原生CameraManager接口控制手电筒，不需要依赖QCamera的会话逻辑，兼容性更高。

内容的提问来源于stack exchange，提问作者Mysterious Bits