SPB Git

Repository Public

CameraRecorder.swift 5.8 KB 109 lines swift

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
Files main
Menu

Theme