builtInTripleCamera 0.5倍变焦videoZoomFactor取值及初始配置疑问

你的核心问题是对多摄设备的videoZoomFactor对应关系存在误解，现有代码的初始配置会直接打开2倍放大画面，完全不符合默认无缩放的需求。

缩放因子对应规则 #

你查到的文档中「1.0为全视场」的描述是早期单摄设备的规则，引入多摄虚拟设备后，虚拟摄像头支持低于1.0的缩放值来调用超广角镜头，但1.0作为广角主摄基准视场的定义从未改变。

• 所有AVFoundation捕获设备的videoZoomFactor基准逻辑统一：1.0永远对应该虚拟设备的原生广角主摄全视场，也就是用户打开相机时预期的默认无缩放状态，和设备是单摄、双摄、三摄没有关系。
• 具体到builtInTripleCamera（整合超广角、广角、长焦的三摄虚拟设备）：
  • 允许的最小缩放值由minAvailableVideoZoomFactor属性决定，三摄设备上这个值通常为0.5，对应0.5倍超广角视场，不是1.0
  • videoZoomFactor = 1.0刚好对应广角主摄的原生1x视场，就是你需要的默认无缩放状态
  • videoZoomFactor = 2.0是广角主摄裁切输出的2倍放大画面，属于用户主动变焦后的放大状态，完全不是默认状态
• 你之前的倍率换算逻辑完全颠倒：系统相机UI显示的变焦倍率，在1x以上区间和videoZoomFactor数值直接对应，0.5x超广角对应0.5的缩放因子，不存在「0.5倍变焦对应缩放因子2.0」的情况。

代码修正建议 #

• 不需要按设备类型单独判断初始缩放值，所有设备统一设置videoZoomFactor = 1.0即可实现默认无缩放效果。
• 设置缩放因子时建议先做范围钳位，避免不同设备参数差异导致配置失败。
• 原代码存在逻辑漏洞：函数传入了device参数，内部配置时却调用了外部的videoDevice属性，需要统一使用传入的实例。

修正后的核心实现代码：

var videoDevice: AVCaptureDevice?

init() {
    getBestDevice()
    setInitialZoomFactor(for: self.videoDevice)
}

let discoverySession = AVCaptureDevice.DiscoverySession(deviceTypes: [.builtInTripleCamera, .builtInDualWideCamera, .builtInDualCamera, .builtInWideAngleCamera], mediaType: .video, position: .back)

func getBestDevice() {
    let devices = discoverySession.devices
    guard !devices.isEmpty else { fatalError("Missing capture devices.")}
    videoDevice = devices.first
}

func setInitialZoomFactor(for device: AVCaptureDevice?) {
    guard let device = device else { return }
    
    do {
        try device.lockForConfiguration()
        // 钳位默认缩放值到设备支持的合法范围，1.0为统一默认无缩放基准
        let minZoom = device.minAvailableVideoZoomFactor
        let maxZoom = device.activeFormat.videoMaxZoomFactor
        device.videoZoomFactor = min(max(1.0, minZoom), maxZoom)
        device.unlockForConfiguration()
    } catch {
        print("Zoom configuration failed: \(error.localizedDescription)")
    }
}

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