Instance Method

stopRecording(completion:)

停止錄影（engine 在背景 finalize，不阻塞呼叫端）

func stopRecording(completion: ((RecordingFileInfo?) -> Void)? = nil)

Parameters

completion: 檔案實際寫入完成後呼叫（main queue），帶出剛寫完的錄影檔資訊；停止時非錄影中、或檔案寫入失敗時帶 nil。

本方法立即返回，實際的 fMP4 收尾（AVAssetWriter.finishWriting）在背景進行，期間 state 為 .finalizing，完成後轉 .idle。檔案在 completion 觸發前不可讀取。

completion 只服務主動呼叫者。engine 錯誤與磁碟臨界的自動停止不經過此參數，需訂閱 lastFinishedFile 才收得到（三條路徑都會更新該屬性）。