SwiftUI应用中手电筒无故熄灭问题排查求助

问题回顾 #

已实现手电筒切换方法toggleTorch，切换功能本身正常，但存在两个核心问题：

• 本地维护的手电筒状态参数无法与设备实际状态同步
• 页面滑动、TabView切换时手电筒会无故熄灭，手势操作流畅时触发概率较低，减少不必要的Tab切换后问题有所缓解，怀疑是边缘上滑退出手势被误判导致

可能原因分析 #

1. 系统手势触发的资源回收：iOS的边缘滑动手势（返回/退出）在触发过程中，系统可能暂时禁用相机相关资源（包括手电筒，因手电筒依赖AVCaptureDevice），若手势中途取消，系统未必会自动恢复手电筒状态。
2. 视图生命周期的影响：TabView切换或页面滑动时，对应视图可能被销毁或重建，若没有对AVCaptureDevice的状态做持久化处理，系统可能重置手电筒配置。
3. 本地状态与设备状态不同步：仅通过按钮触发切换，未监听设备本身的torchMode变化，当系统或其他操作修改手电筒状态时，本地UI无法及时同步，也难以察觉异常熄灭的原因。

解决方案 #

1. 用单例管理器统一维护手电筒状态 #

创建一个ObservableObject管理器，负责手电筒的切换、状态监听，确保本地状态与设备实际状态同步：

import AVFoundation
import Combine

class TorchManager: ObservableObject {
    @Published var isTorchActive = false
    private var captureDevice: AVCaptureDevice?
    private var cancellables = Set<AnyCancellable>()
    
    init() {
        captureDevice = AVCaptureDevice.default(for: .video)
        setupTorchStateObserver()
    }
    
    // 监听设备torchMode的变化，同步本地状态
    private func setupTorchStateObserver() {
        guard let device = captureDevice else { return }
        device.publisher(for: \.torchMode)
            .sink { [weak self] mode in
                self?.isTorchActive = mode == .on
            }
            .store(in: &cancellables)
    }
    
    func toggleTorch() {
        guard let device = captureDevice, device.hasTorch else {
            print("手电筒不可用")
            return
        }
        
        do {
            try device.lockForConfiguration()
            let targetMode = device.torchMode == .off ? .on : .off
            device.torchMode = targetMode
            device.unlockForConfiguration()
        } catch {
            print("切换手电筒失败：\(error.localizedDescription)")
        }
    }
}

在视图中使用该管理器：

struct FlashlightView: View {
    @StateObject private var torchManager = TorchManager()
    
    var body: some View {
        Button(action: torchManager.toggleTorch) {
            Image(systemName: torchManager.isTorchActive ? "flashlight.on.fill" : "flashlight.off.fill")
                .font(.system(size: 40))
                .foregroundColor(torchManager.isTorchActive ? .yellow : .gray)
        }
    }
}

2. 维持AVCaptureSession活跃 #

手电筒依赖AVCaptureDevice，若没有活跃的AVCaptureSession，系统可能在视图切换时回收资源。可以在管理器中添加一个持久化的session：

// 在TorchManager中添加
private var captureSession: AVCaptureSession?

private func setupCaptureSession() {
    guard let device = captureDevice else { return }
    let session = AVCaptureSession()
    do {
        let input = try AVCaptureDeviceInput(device: device)
        if session.canAddInput(input) {
            session.addInput(input)
        }
        session.startRunning()
        captureSession = session
    } catch {
        print("初始化捕获会话失败：\(error)")
    }
}

// 在init中调用setupCaptureSession()
init() {
    captureDevice = AVCaptureDevice.default(for: .video)
    setupCaptureSession()
    setupTorchStateObserver()
}

3. 处理视图生命周期，避免状态丢失 #

在包含手电筒功能的视图中，通过onDisappear和onAppear处理状态恢复（按需使用，避免强制保持手电筒常亮影响用户体验）：

struct FlashlightView: View {
    @StateObject private var torchManager = TorchManager()
    @State private var lastTorchState = false
    
    var body: some View {
        Button(action: torchManager.toggleTorch) {
            // ... 按钮内容
        }
        .onAppear {
            // 视图出现时恢复之前的状态
            if lastTorchState {
                torchManager.toggleTorch()
            }
        }
        .onDisappear {
            // 记录当前状态
            lastTorchState = torchManager.isTorchActive
        }
    }
}

4. 排查系统手势干扰 #

若确认是边缘手势导致的熄灭，可以在特定视图中临时禁用边缘返回手势（谨慎使用，避免影响用户体验）：

struct DisableEdgeSwipe: UIViewControllerRepresentable {
    func makeUIViewController(context: Context) -> UIViewController {
        let vc = UIViewController()
        DispatchQueue.main.async {
            vc.navigationController?.interactivePopGestureRecognizer?.isEnabled = false
        }
        return vc
    }
    
    func updateUIViewController(_ uiViewController: UIViewController, context: Context) {}
}

// 在视图中使用
struct FlashlightView: View {
    var body: some View {
        // ... 视图内容
        .background(DisableEdgeSwipe())
    }
}

5. 确保相机权限配置 #

在Info.plist中添加相机权限描述，否则手电筒功能可能被系统限制：

<key>NSCameraUsageDescription</key>
<string>需要相机权限以使用手电筒功能</string>

内容的提问来源于stack exchange，提问作者Richard Kirk