CameraCaptureOptions

nonisolated class CameraCaptureOptions

Overview

描述「相機硬體要以什麼規格採集畫面」— 決定相機吐出的 frame 尺寸、幀率、 使用哪一顆鏡頭。此為採集層設定，跟編碼層 (VideoPublishOptions) 分離：

• CameraCaptureOptions.fps = 相機硬體吐幀速率（AVCaptureDevice 採樣頻率）

• VideoPublishOptions.maxFps = 編碼器發送端節流上限（軟體丟幀）

兩者可各自設定：capture 30fps 拍、encode 只送 15fps 出去也合法。

let options = CameraCaptureOptions(
    dimensions: .h720_169,
    fps: 15,
    position: .front
)
let track = localParticipant.setCamera(enabled: true, options: options)

CameraCapturer.set(options:)。

Topics

Structures

• struct Dimensions

  相機採集解析度

Initializers

• init(dimensions: Dimensions, fps: Int, position: AVCaptureDevice.Position, device: AVCaptureDevice?, autoCorrectOrientation: Bool, isMirrored: Bool)

Instance Properties

• let autoCorrectOrientation: Bool

  是否自動校正採集方向（預設 true）

• let device: AVCaptureDevice?

  明確指定某一顆相機（可選）

• let dimensions: Dimensions

  相機採集解析度（預設 720p 16:9）

• let fps: Int

  相機採集幀率 — 每秒送出幾張畫面（預設 30）

• let isMirrored: Bool

  是否鏡像採集（預設 false）

• let position: AVCaptureDevice.Position

  鏡頭位置偏好（預設 .front）

Instance Methods

• func copyWith(dimensions: Dimensions?, fps: Int?, position: AVCaptureDevice.Position?, device: AVCaptureDevice??, autoCorrectOrientation: Bool?, isMirrored: Bool?) -> CameraCaptureOptions

  複製並覆蓋部分選項