SPB Git

Repository Public License

Transcript.swift 3.7 KB 78 lines swift

1//2//  ORIX Audio3//  File: Core/Sources/ORIXAudioCore/Speech/Transcript.swift4//  Description: Transcript model (timed segments, optional words and manual speaker labels) and text search.5//6//  Author: Simon-Pierre Boucher7//  Contact: contact@spboucher.ai8//9import Foundation1011public struct TranscriptWord: Codable, Sendable, Hashable {12    public var text: String13    public var start: Double14    public var end: Double15    public var confidence: Double?16    public init(text: String, start: Double, end: Double, confidence: Double? = nil) { self.text = text; self.start = start; self.end = end; self.confidence = confidence }17}1819public struct TranscriptSegment: Codable, Sendable, Hashable, Identifiable {20    public var id = UUID()21    public var start: Double22    public var end: Double23    public var text: String24    /// Set by the user only ("Speaker 1"…). ORIX Audio does not identify voices.25    public var speaker: String?26    public var words: [TranscriptWord] = []27    public var isEdited = false28    public init(start: Double, end: Double, text: String, speaker: String? = nil, words: [TranscriptWord] = []) {29        self.start = start; self.end = end; self.text = text; self.speaker = speaker; self.words = words30    }31}3233public struct Transcript: Codable, Sendable, Equatable {34    public var localeIdentifier: String35    /// Which recogniser produced it, e.g. "SpeechTranscriber (on-device)".36    public var engine: String37    public var createdAt: Date38    public var segments: [TranscriptSegment]3940    public init(localeIdentifier: String, engine: String, createdAt: Date = .now, segments: [TranscriptSegment]) {41        self.localeIdentifier = localeIdentifier; self.engine = engine; self.createdAt = createdAt; self.segments = segments42    }4344    public var plainText: String { segments.map(\.text).joined(separator: " ") }45    public var wordCount: Int { segments.reduce(0) { $0 + $1.text.split(whereSeparator: \.isWhitespace).count } }46    public var duration: Double { segments.last?.end ?? 0 }4748    public func segmentIndex(at time: Double) -> Int? {49        segments.lastIndex { $0.start <= time + 0.01 }.flatMap { time <= segments[$0].end + 0.5 || $0 == segments.count - 1 ? $0 : $0 }50    }5152    /// Case- and diacritic-insensitive search; returns matching segment indices.53    public func search(_ query: String) -> [Int] {54        let q = query.trimmingCharacters(in: .whitespacesAndNewlines)55        guard !q.isEmpty else { return [] }56        return segments.indices.filter { segments[$0].text.range(of: q, options: [.caseInsensitive, .diacriticInsensitive]) != nil }57    }5859    /// Groups recogniser output into readable segments: breaks at sentence punctuation, long pauses, or when a segment grows past `maxDuration`.60    public static func segment(words: [TranscriptWord], maxDuration: Double = 12, pause: Double = 0.9) -> [TranscriptSegment] {61        var out: [TranscriptSegment] = []62        var current: [TranscriptWord] = []63        func flush() {64            guard let first = current.first, let last = current.last else { return }65            let text = current.map(\.text).joined(separator: " ").replacingOccurrences(of: "  ", with: " ").trimmingCharacters(in: .whitespaces)66            if !text.isEmpty { out.append(TranscriptSegment(start: first.start, end: last.end, text: text, words: current)) }67            current = []68        }69        for w in words {70            if let last = current.last, let first = current.first, w.start - last.end > pause || w.end - first.start > maxDuration { flush() }71            current.append(w)72            if let c = w.text.trimmingCharacters(in: .whitespaces).last, ".!?…".contains(c), current.count >= 3 { flush() }73        }74        flush()75        return out76    }77}78
Files main
Menu

Theme