capture(_:)

func capture(_ pixelBuffer: CVPixelBuffer)

Parameters

pixelBuffer

要注入的 CVPixelBuffer（其尺寸即為送出解析度）

Discussion

接受 NV12（420YpCbCr8BiPlanarVideoRange / FullRange）或 BGRA（32BGRA）。 BGRA 來源（例：Flutter RGBA→BGRA 截圖、Metal render 輸出）會自動 BGRA→NV12， 確保下游 nv12ToToxVideoFrame → sendVideoFrame 路徑能正常解析。

⚠️ 不提供解析度切換功能：本方法只做格式正規化（BGRA→NV12），尺寸原樣直通 —— 送出去的解析度 = 你注入的 pixelBuffer 的實際尺寸。 若要動態調整解析度，請自行在注入前調整 input pixelBuffer 的尺寸 （例如自己 render 到目標尺寸再餵進來）。SDK 刻意不代勞：BufferTrack 是外部餵入決定 尺寸的透明管道，且下游（發送/顯示/錄影/合成）皆能自適應任意尺寸。

可在任何執行緒呼叫；尺寸變更事件仍在 main 觸發。