Repository Public
1// SP Lecture Studio — LectureCapture2// File: Packages/LectureCapture/Sources/CameraRecorder.swift3// Description: Optional face camera: AVCaptureSession recording fragmented QuickTime segments (recoverable after a crash) aligned on the recording clock.4//5// Author: Simon-Pierre Boucher6// Contact: contact@spboucher.ai7import Foundation8import AVFoundation9import LectureCore10import LectureStorage1112public struct CameraDevice: Hashable, Sendable, Identifiable {13 public var id: String14 public var name: String15 public var isFront: Bool16}1718/// Records the face camera as video-only movie segments. Audio always comes from the audio path, never from here.19/// One segment per recording run (start → pause/stop); movie fragments are flushed every 5 s so that an interrupted20/// segment remains readable up to its last fragment.21public final class CameraRecorder: NSObject, AVCaptureFileOutputRecordingDelegate, @unchecked Sendable {22 public let session = AVCaptureSession()23 private let output = AVCaptureMovieFileOutput()24 private let queue = DispatchQueue(label: "ai.spboucher.lecture.camera")25 private var pending: [URL: (segment: MediaSegment, clock: RecordingClock)] = [:]26 private var nextIndex = 127 private let lock = NSLock()28 /// Called on the main queue when a segment file is complete.29 public var onSegment: ((MediaSegment) -> Void)?30 public var onError: ((String) -> Void)?31 public private(set) var isConfigured = false3233 public static func devices() -> [CameraDevice] {34 #if os(iOS)35 let types: [AVCaptureDevice.DeviceType] = [.builtInWideAngleCamera, .external]36 #else37 let types: [AVCaptureDevice.DeviceType] = [.builtInWideAngleCamera, .external, .continuityCamera]38 #endif39 return AVCaptureDevice.DiscoverySession(deviceTypes: types, mediaType: .video, position: .unspecified).devices40 .map { CameraDevice(id: $0.uniqueID, name: $0.localizedName, isFront: $0.position == .front) }41 }4243 /// Configures the session with the given camera (front camera by default). Requires camera permission.44 public func configure(deviceID: String? = nil) throws {45 let device = deviceID.flatMap { AVCaptureDevice(uniqueID: $0) }46 ?? AVCaptureDevice.default(.builtInWideAngleCamera, for: .video, position: .front)47 ?? AVCaptureDevice.default(for: .video)48 guard let device else { throw AudioSourceError.engine("no camera") }49 session.beginConfiguration()50 defer { session.commitConfiguration() }51 session.inputs.forEach(session.removeInput)52 if session.canSetSessionPreset(.hd1280x720) { session.sessionPreset = .hd1280x720 } else { session.sessionPreset = .medium }53 let input = try AVCaptureDeviceInput(device: device)54 guard session.canAddInput(input) else { throw AudioSourceError.engine("camera input rejected") }55 session.addInput(input)56 if !session.outputs.contains(output) {57 guard session.canAddOutput(output) else { throw AudioSourceError.engine("camera output rejected") }58 session.addOutput(output)59 }60 output.movieFragmentInterval = CMTime(seconds: 5, preferredTimescale: 600)61 isConfigured = true62 }6364 public func startPreview() { queue.async { if !self.session.isRunning { self.session.startRunning() } } }65 public func stopPreview() { queue.async { if self.session.isRunning && !self.output.isRecording { self.session.stopRunning() } } }6667 public func setNextIndex(_ index: Int) { lock.lock(); nextIndex = index; lock.unlock() }6869 /// Starts a new camera segment for `session`. The segment start time is taken from the recording clock when the70 /// first frame is written.71 public func startSegment(package: ProjectPackage, recordingSession: RecordingSession, clock: RecordingClock) {72 guard isConfigured else { return }73 lock.lock(); let index = nextIndex; nextIndex += 1; lock.unlock()74 let name = ProjectLayout.segmentFileName(kind: .camera, session: recordingSession, index: index)75 let relative = ProjectLayout.mediaDirectory + "/" + name76 let url = package.url(relative)77 queue.async {78 if !self.session.isRunning { self.session.startRunning() }79 try? FileManager.default.removeItem(at: url)80 let seg = MediaSegment(kind: .camera, path: relative, index: index, start: clock.now(), duration: .zero, finalized: false)81 self.lock.lock(); self.pending[url.standardizedFileURL] = (seg, clock); self.lock.unlock()82 self.output.startRecording(to: url, recordingDelegate: self)83 }84 }8586 public func stopSegment() { queue.async { if self.output.isRecording { self.output.stopRecording() } } }8788 public func fileOutput(_ output: AVCaptureFileOutput, didStartRecordingTo fileURL: URL, from connections: [AVCaptureConnection]) {89 lock.lock(); defer { lock.unlock() }90 let key = fileURL.standardizedFileURL91 if var p = pending[key] { p.segment.start = p.clock.now(); pending[key] = p }92 }9394 public func fileOutput(_ output: AVCaptureFileOutput, didFinishRecordingTo outputFileURL: URL, from connections: [AVCaptureConnection], error: Error?) {95 lock.lock(); let entry = pending.removeValue(forKey: outputFileURL.standardizedFileURL); lock.unlock()96 guard var seg = entry?.segment else { return }97 // A recording can end with an error (disk full, interruption) and still have produced a usable file.98 if let probe = MediaProbe.probe(outputFileURL, kind: .camera) {99 seg.duration = probe.duration; seg.finalized = true100 seg.sha256 = try? Hashing.sha256(of: outputFileURL)101 let cb = onSegment102 DispatchQueue.main.async { cb?(seg) }103 } else if let error {104 let cb = onError105 DispatchQueue.main.async { cb?(error.localizedDescription) }106 }107 }108}109