switchCameraPosition()

@discardableResult func switchCameraPosition() async throws -> Bool

Return Value

true —— 擷取中，且要的那顆鏡頭已換上（device 已是它）。 false —— 沒換上：鏡頭停止中（只記住，startCapture() 時套用）、加不進去已還原， 或還沒換就被之後的呼叫取代（連續呼叫只執行最後一次，前面的都回 false）

Discussion

切前後鏡頭 = 回「依 position 自動挑選」，清除先前指定的 options.device。 擷取中才即時切換；停止中只記住 position，startCapture() 時套用。

鏡頭在擷取佇列裡加不進去時（例如被其他 App 占用），SDK 還原成原本的鏡頭、 position 與 options 回到原值，不丟錯誤，回 false。

Throws

CameraCapturerError.deviceNotAvailable —— 另一個方向沒有鏡頭；position 不變