Mp4BoxKit 1.0.1
See the version list below for details.
dotnet add package Mp4BoxKit --version 1.0.1
NuGet\Install-Package Mp4BoxKit -Version 1.0.1
<PackageReference Include="Mp4BoxKit" Version="1.0.1" />
<PackageVersion Include="Mp4BoxKit" Version="1.0.1" />
<PackageReference Include="Mp4BoxKit" />
paket add Mp4BoxKit --version 1.0.1
#r "nuget: Mp4BoxKit, 1.0.1"
#:package Mp4BoxKit@1.0.1
#addin nuget:?package=Mp4BoxKit&version=1.0.1
#tool nuget:?package=Mp4BoxKit&version=1.0.1
Mp4BoxKit
Простая и лёгкая .NET-библиотека для чтения, записи и инспекции MP4/fMP4. Она рассчитана на потоковую запись: вы передаёте готовые access units и codec configuration, а на выходе получаете classic MP4-файл или самостоятельные сегменты fragmented MP4.
Основные сценарии — H.264/H.265 видео и AAC аудио. Reader также разбирает смешанные classic/fragmented файлы, sample tables, edit lists, структуру боксов и границы fMP4-сегментов. Ядро библиотеки не зависит от платформы и совместимо с AOT; FFmpeg используется только в необязательном native-тестовом проекте.
Что умеет библиотека
- classic MP4, включая FastStart;
- fragmented MP4 с initialization, media и index частями;
sidx,mfra/tfra,styp;- синхронный вывод или асинхронный
IFmp4SegmentSink; - H.264/H.265 NAL framing и проверку
avcC/hvcC; - AAC-LC с автоматическим
esdsили явной codec configuration; - разбор ADTS AAC;
- unified
Mp4Readerдля classic и fragmented MP4; - инспекцию боксов, треков, сэмплов и fMP4-сегментов.
Поддерживаемые кодеки
Видео
- H.264
- H.265
- AV1
- VP8
- VP9
- MPEG-4
- MPEG2
- MJPEG (частично)
Аудио
- AAC
- MP3
- Opus
- AC-3
- PCM (частично
ipcm/fpcm/lpcm/sowt/twos/in24/in32)
Субтитры
- tx3g
- wvtt (только чтение)
Чтение MP4
using Mp4BoxKit;
using var input = File.OpenRead("input.mp4");
var reader = new Mp4Reader(input);
while (await reader.ReadSampleAsync() is { } sample)
{
// sample.Track, sample.Pts, sample.Dts, sample.Duration,
// sample.Flags, sample.Data
Console.WriteLine($"{sample.Track} {sample.Pts} {sample.Data.Length}");
}
Reader сам определяет, classic это файл или fragmented. Mp4Reader.Info
содержит brand, layout и список треков.
Запись classic MP4
using Mp4BoxKit;
using Mp4BoxKit.Codecs;
var avcC = AvcConfiguration.CreateFromSpsPps(sps, pps);
using var output = File.Create("video.mp4");
using var writer = new Mp4FileWriter(
new StreamMp4Output(output),
new Mp4FileWriterOptions { FastStart = true });
var video = writer.AddVideo(new VideoTrackOptions(
Codec.H264,
Width: 1280,
Height: 720,
TimeScale: 90_000,
CodecConfiguration: avcC));
writer.WriteSample(
video,
accessUnit,
pts: 0,
dts: 0,
flags: SampleFlags.KeyFrame);
writer.Complete();
Каждый вызов WriteSample должен содержать один полный access unit.
H.264/H.265 samples — это length-prefixed NAL units, а не Annex B. Для Annex B:
writer.WriteSample(
video,
AvcSample.FromAnnexB(annexB),
pts,
dts,
SampleFlags.KeyFrame);
Запись fragmented MP4
using var output = File.Create("video-fragmented.mp4");
using var writer = new Mp4FragmentedWriter(
new StreamMp4Output(output),
new Mp4FragmentedWriterOptions
{
FragmentBoundary = Fmp4FragmentBoundary.EveryKeyFrame,
WriteSegmentIndex = true,
WriteRandomAccessIndex = true
});
var video = writer.AddVideo(new VideoTrackOptions(
Codec.H264,
Width: 1280,
Height: 720,
TimeScale: 90_000,
CodecConfiguration: avcC));
writer.WriteSample(video, accessUnit, pts, dts, SampleFlags.KeyFrame);
writer.FlushFragment();
writer.Complete();
Для сетевой доставки вместо seekable output передайте IFmp4SegmentSink:
sealed class SegmentSink : IFmp4SegmentSink
{
public ValueTask WriteAsync(Fmp4Segment segment, CancellationToken ct)
{
// segment.Kind: Initialization, Media или Index
return SendAsync(segment.Data, ct);
}
}
await using var writer = new Mp4FragmentedWriter(options, sink);
await writer.WriteSampleAsync(video, accessUnit, pts, dts, flags, ct);
await writer.CompleteAsync(ct);
Fmp4Segment содержит reference track, timescale, earliest PTS, duration,
keyframe flag и sample count.
AAC
Для AAC-LC esds может быть сгенерирован из sample rate и channel count:
var audio = writer.AddAudio(new AudioTrackOptions(
Codec.Aac,
Channels: 2,
SampleRate: 48_000,
TimeScale: 48_000));
Для HE-AAC/SBR/PS и других профилей передайте явную codec configuration:
var esds = AacConfiguration.CreateEsdsFromAudioSpecificConfig(asc);
ADTS-фреймы можно преобразовать в raw AAC samples:
if (!AacAdts.TryParse(frame, out _))
{
throw new InvalidDataException("Invalid ADTS frame.");
}
var config = AacAdts.CreateEsds(frame);
var payload = AacAdts.GetPayload(frame);
writer.WriteSample(audio, payload, pts, dts, SampleFlags.KeyFrame, duration: 1024);
Инспекция MP4
using Mp4BoxKit.Inspection;
using var input = File.OpenRead("video.mp4");
var inspection = await Mp4Inspector.InspectAsync(
input,
"video.mp4",
new InspectOptions
{
IncludeSamples = true,
MaxSamples = 1000
});
Console.WriteLine(inspection.Movie.MajorBrand);
Console.WriteLine(inspection.Movie.DurationSeconds);
Console.WriteLine(inspection.Tracks.Count);
Console.WriteLine(inspection.Boxes.Count);
Console.WriteLine(inspection.Segments.Count);
var json = InspectionJson.Serialize(inspection);
Результат содержит вложенное дерево боксов с offset и выбранными полями,
summary треков, метаданные сэмплов, moof + mdat сегменты и warnings при
достижении лимитов или ошибках формата.
Inspect(byte* data, int length, ...) доступен для unmanaged/WASM-буфера и
не копирует входные данные. Обычный managed overload принимает
ReadOnlyMemory<byte> и не делает лишнюю копию для array-backed памяти.
CLI и GUI
CLI
dotnet run --project src/Mp4BoxKit.Cli -- video.mp4
dotnet run --project src/Mp4BoxKit.Cli -- video.mp4 --boxes --samples --segments
dotnet run --project src/Mp4BoxKit.Cli -- video.mp4 --json out.json --csv out/
Флаги:
--summary --boxes --samples --segments
--depth --max-boxes --max-samples --max-segments --max-input-bytes
--json --csv --boxes-csv --samples-csv --segments-csv
Имя собранного executable: boxkit.
Браузерные GUI
NativeAOT-LLVM используется для production-демо и GitHub Pages; Blazor — для
разработки и отладки. Оба используют общий UI из demo.
Общие файлы браузерного UI находятся в demo:
demo/index.html
demo/app.js
demo/styles.css
demo/runtime.js
NativeAOT-сборка дополнительно создаёт:
demo/Mp4BoxKit.NativeWasm.js
demo/Mp4BoxKit.NativeWasm.wasm
Эти два сгенерированных файла игнорируются Git; UI и runtime adapter являются исходниками.
NativeAOT-LLVM
Нужны .NET 10, workload wasm-tools и Emscripten 3.1.56. Проект использует
пакеты из dotnet-experimental через корневой NuGet.Config.
dotnet publish src/Mp4BoxKit.NativeWasm -c Release -r browser-wasm -o demo
Запуск через любой static server:
Blazor WASM
Blazor — вариант для разработки и отладки. Он ссылается на
Mp4BoxKit.Inspection напрямую и вызывает его из общего JS UI через
[JSInvokable]:
dotnet run --project src/Mp4BoxKit.Blazor -c Debug
Открыть http://localhost:5081
Сборка и тесты
dotnet restore Mp4BoxKit.slnx
dotnet build Mp4BoxKit.slnx -c Release
dotnet test Mp4BoxKit.slnx -c Release
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.