From 118a5b4004e362d7a9785f99e61d9682eef64e78 Mon Sep 17 00:00:00 2001 From: Jerome Mohm <104490445+jrmmhm@users.noreply.github.com> Date: Tue, 10 Nov 2026 20:25:34 +0100 Subject: [PATCH 1/2] fix(Mp4): forward whole probe buffer once a local MP4 is optimized When FileAudioSource needed more than one read to decide that a local MP4 is already optimized, only the last chunk reached the parser and the earlier probe bytes, including the ftyp atom, were dropped. --- AudioStreaming/Streaming/Audio Source/FileAudioSource.swift | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/AudioStreaming/Streaming/Audio Source/FileAudioSource.swift b/AudioStreaming/Streaming/Audio Source/FileAudioSource.swift index 4a356b3..25a111a 100644 --- a/AudioStreaming/Streaming/Audio Source/FileAudioSource.swift +++ b/AudioStreaming/Streaming/Audio Source/FileAudioSource.swift @@ -128,8 +128,10 @@ final class FileAudioSource: NSObject, CoreAudioStreamSource { break case .optimized: mp4IsAlreadyOptimized = true + // The probe buffer holds every byte read so far, not just this chunk + let probedData = mp4ProbeBuffer mp4ProbeBuffer = Data() - delegate?.dataAvailable(source: self, data: data) + delegate?.dataAvailable(source: self, data: probedData) case let .needsRestructure(moovOffset): mp4ProbeBuffer = Data() try performMp4Restructure(inputStream: inputStream, moovOffset: moovOffset) From 6528e3779d0228e68a3fb757aaa6148acfeda689 Mon Sep 17 00:00:00 2001 From: Jerome Mohm <104490445+jrmmhm@users.noreply.github.com> Date: Wed, 11 Nov 2026 21:08:44 +0100 Subject: [PATCH 2/2] test(Mp4): cover local MP4 files optimized after several reads Unit tests check that FileAudioSource hands every probed byte to the parser, with two controls for the first-read and restructure paths. A player test plays a short AAC fixture whose moov atom starts beyond the first 64 KiB read to its end. --- .../Audio Source/FileAudioSourceTests.swift | 126 ++++++++++++++++++ .../Mp4ProbeForwardPlaybackTests.swift | 105 +++++++++++++++ .../faststart-free-before-moov.m4a | Bin 0 -> 91291 bytes Package.swift | 2 + 4 files changed, 233 insertions(+) create mode 100644 AudioStreamingTests/Streaming/Audio Source/FileAudioSourceTests.swift create mode 100644 AudioStreamingTests/Streaming/Audio Source/Mp4ProbeForwardPlaybackTests.swift create mode 100644 AudioStreamingTests/Streaming/Audio Source/faststart-free-before-moov.m4a diff --git a/AudioStreamingTests/Streaming/Audio Source/FileAudioSourceTests.swift b/AudioStreamingTests/Streaming/Audio Source/FileAudioSourceTests.swift new file mode 100644 index 0000000..cd93a17 --- /dev/null +++ b/AudioStreamingTests/Streaming/Audio Source/FileAudioSourceTests.swift @@ -0,0 +1,126 @@ +// +// FileAudioSourceTests.swift +// AudioStreamingTests +// + +import XCTest +@testable import AudioStreaming + +class FileAudioSourceTests: XCTestCase { + /// The default read size of `FileAudioSource` + private let readSize = 64 * 1024 + + func test_Optimized_Mp4_Decided_After_Several_Reads_Forwards_All_Bytes() throws { + // a free atom larger than one read pushes the moov atom beyond the first read + let ftyp = mp4Atom("ftyp", payload: ftypPayload) + let free = mp4Atom("free", payload: pattern(count: 96 * 1024, modulo: 251)) + let moov = mp4Atom("moov", payload: pattern(count: 248, modulo: 253)) + let mdat = mp4Atom("mdat", payload: pattern(count: 32 * 1024, modulo: 241)) + let file = ftyp + free + moov + mdat + XCTAssertGreaterThan(ftyp.count + free.count, readSize, "moov must start beyond the first read") + + let result = try readAll(file: file) + + XCTAssertNil(result.error) + XCTAssertEqual(result.data.count, file.count, "byte count") + XCTAssertEqual(result.data, file) + } + + func test_Optimized_Mp4_Decided_On_First_Read_Forwards_All_Bytes() throws { + let ftyp = mp4Atom("ftyp", payload: ftypPayload) + let free = mp4Atom("free", payload: pattern(count: 100, modulo: 251)) + let moov = mp4Atom("moov", payload: pattern(count: 248, modulo: 253)) + let mdat = mp4Atom("mdat", payload: pattern(count: 32 * 1024, modulo: 241)) + let file = ftyp + free + moov + mdat + XCTAssertLessThan(file.count, readSize, "the whole file must fit in the first read") + + let result = try readAll(file: file) + + XCTAssertNil(result.error) + XCTAssertEqual(result.data.count, file.count, "byte count") + XCTAssertEqual(result.data, file) + } + + func test_Non_Optimized_Mp4_Restructure_Path_Is_Unchanged() throws { + let ftyp = mp4Atom("ftyp", payload: ftypPayload) + let mdat = mp4Atom("mdat", payload: pattern(count: 4 * 1024, modulo: 241)) + // no stco or co64 inside, so restructuring leaves the moov atom as it is + let moov = mp4Atom("moov", payload: mp4Atom("udta", payload: Data(count: 8))) + // a trailing atom keeps the synchronous moov read from ending exactly at EOF + let free = mp4Atom("free", payload: Data(count: 8)) + let file = ftyp + mdat + moov + free + + let result = try readAll(file: file) + + // ftyp and moov first, then everything from the mdat atom onwards + let expected = ftyp + moov + file.subdata(in: ftyp.count ..< file.count) + XCTAssertNil(result.error) + XCTAssertEqual(result.data.count, expected.count, "byte count") + XCTAssertEqual(result.data, expected) + } + + // MARK: - Helpers + + private var ftypPayload: Data { + Data("M4A ".utf8) + Data([0x00, 0x00, 0x02, 0x00]) + Data("M4A isom".utf8) + } + + private func mp4Atom(_ type: String, payload: Data) -> Data { + var atom = Data() + withUnsafeBytes(of: UInt32(8 + payload.count).bigEndian) { atom.append(contentsOf: $0) } + atom.append(Data(type.utf8)) + atom.append(payload) + return atom + } + + private func pattern(count: Int, modulo: Int) -> Data { + Data((0 ..< count).map { UInt8($0 % modulo) }) + } + + /// Plays the given bytes as a local `.m4a` file through `FileAudioSource` and records what reaches the delegate + private func readAll(file: Data) throws -> (data: Data, error: Error?) { + let url = FileManager.default.temporaryDirectory + .appendingPathComponent("FileAudioSourceTests-\(UUID().uuidString).m4a") + try file.write(to: url) + defer { try? FileManager.default.removeItem(at: url) } + + let queue = DispatchQueue(label: "file-audio-source-tests") + let source = FileAudioSource(url: url, underlyingQueue: queue) + let recorder = RecordingSourceDelegate(finished: expectation(description: "source finished")) + source.delegate = recorder + queue.async { source.seek(at: 0) } + + wait(for: [recorder.finished], timeout: 10) + return queue.sync { + source.close() + return (recorder.data, recorder.error) + } + } +} + +private final class RecordingSourceDelegate: AudioStreamSourceDelegate { + let finished: XCTestExpectation + var data = Data() + var error: Error? + + init(finished: XCTestExpectation) { + // an error can be followed by the end of the file + finished.assertForOverFulfill = false + self.finished = finished + } + + func dataAvailable(source _: CoreAudioStreamSource, data: Data) { + self.data.append(data) + } + + func errorOccurred(source _: CoreAudioStreamSource, error: Error) { + self.error = error + finished.fulfill() + } + + func endOfFileOccurred(source _: CoreAudioStreamSource) { + finished.fulfill() + } + + func metadataReceived(data _: [String: String]) {} +} diff --git a/AudioStreamingTests/Streaming/Audio Source/Mp4ProbeForwardPlaybackTests.swift b/AudioStreamingTests/Streaming/Audio Source/Mp4ProbeForwardPlaybackTests.swift new file mode 100644 index 0000000..9865ff9 --- /dev/null +++ b/AudioStreamingTests/Streaming/Audio Source/Mp4ProbeForwardPlaybackTests.swift @@ -0,0 +1,105 @@ +// +// Mp4ProbeForwardPlaybackTests.swift +// AudioStreamingTests +// + +import XCTest +@testable import AudioStreaming + +final class Mp4ProbeForwardPlaybackTests: XCTestCase { + /// The default read size of `FileAudioSource` + private let readSize = 64 * 1024 + + func test_Local_Mp4_Optimized_After_Several_Reads_Plays_To_End() throws { + // A 2 s, 440 Hz, 44.1 kHz mono AAC-LC tone (ffmpeg, 64 kbit/s, -movflags +faststart), with a + // 72 KiB top-level free atom inserted before moov and the stco chunk offsets shifted to match + let fixtureURL = try XCTUnwrap(Bundle.module.url(forResource: "faststart-free-before-moov", withExtension: "m4a")) + let data = try Data(contentsOf: fixtureURL) + // the fixture is only recognised as optimized once more than the first read is buffered + XCTAssertEqual(try Mp4Restructure().checkIsOptimized(data: Data(data.prefix(readSize))), .undetermined) + XCTAssertEqual(try Mp4Restructure().checkIsOptimized(data: data), .optimized) + + let recorder = Mp4PlaybackRecorder() + let finished = expectation(description: "audioPlayerDidFinishPlaying") + recorder.onFinish = { finished.fulfill() } + + let player = AudioPlayer() + player.delegate = recorder + // AudioPlayer.init creates its output unit asynchronously + RunLoop.main.run(until: Date().addingTimeInterval(1)) + + var progressSamples: [Double] = [] + let sampler = Timer.scheduledTimer(withTimeInterval: 0.1, repeats: true) { _ in + progressSamples.append(player.progress) + } + player.play(url: fixtureURL) + // a short wait, so that a stalled player fails on the assertions below instead of a timeout + let waitResult = XCTWaiter().wait(for: [finished], timeout: 8) + sampler.invalidate() + recorder.onFinish = nil + player.stop() + + let positiveProgress = progressSamples.filter { $0 > 0 } + let observed = "waiter=\(waitResult.rawValue) events=\(recorder.events) maxProgress=\(progressSamples.max() ?? 0)" + + XCTAssertEqual(waitResult, .completed, "playback did not finish; \(observed)") + XCTAssertTrue(recorder.started, "playback did not start; \(observed)") + XCTAssertTrue(recorder.errors.isEmpty, "unexpected errors: \(recorder.errors)") + XCTAssertGreaterThan(positiveProgress.last ?? 0, positiveProgress.first ?? 0, "progress did not grow; \(observed)") + XCTAssertEqual(recorder.finishReason, .eof, "unexpected stop reason; \(observed)") + XCTAssertGreaterThan(recorder.finishProgress ?? 0, 1.8, "did not play the whole 2 s; \(observed)") + } +} + +private final class Mp4PlaybackRecorder: AudioPlayerDelegate { + private let start = Date() + private(set) var events: [String] = [] + private(set) var started = false + private(set) var errors: [String] = [] + private(set) var finishProgress: Double? + private(set) var finishReason: AudioPlayerStopReason? + var onFinish: (() -> Void)? + + private func log(_ text: String) { + events.append(String(format: "+%.2fs ", Date().timeIntervalSince(start)) + text) + } + + func audioPlayerDidStartPlaying(player _: AudioPlayer, with _: AudioEntryId) { + started = true + log("didStartPlaying") + } + + func audioPlayerDidFinishBuffering(player _: AudioPlayer, with _: AudioEntryId) { + log("didFinishBuffering") + } + + func audioPlayerStateChanged(player _: AudioPlayer, with newState: AudioPlayerState, previous: AudioPlayerState) { + log("stateChanged \(previous) -> \(newState)") + } + + func audioPlayerDidFinishPlaying(player _: AudioPlayer, + entryId _: AudioEntryId, + stopReason: AudioPlayerStopReason, + progress: Double, + duration: Double) + { + log(String(format: "didFinishPlaying \(stopReason) progress=%.3f duration=%.3f", progress, duration)) + guard finishProgress == nil else { return } + finishProgress = progress + finishReason = stopReason + onFinish?() + } + + func audioPlayerUnexpectedError(player _: AudioPlayer, error: AudioPlayerError) { + errors.append("\(error)") + log("unexpectedError \(error)") + } + + func audioPlayerDidCancel(player _: AudioPlayer, queuedItems _: [AudioEntryId]) { + log("didCancel") + } + + func audioPlayerDidReadMetadata(player _: AudioPlayer, metadata _: [String: String]) { + log("didReadMetadata") + } +} diff --git a/AudioStreamingTests/Streaming/Audio Source/faststart-free-before-moov.m4a b/AudioStreamingTests/Streaming/Audio Source/faststart-free-before-moov.m4a new file mode 100644 index 0000000000000000000000000000000000000000..9e3cdf00b25139326ee235a5bb6da38e7cd88d8c GIT binary patch literal 91291 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