音视频视频处理音频处理【免费下载链接】mediabunnyPure TypeScript media toolkit for reading, writing, and converting video and audio files, directly in the browser.项目地址https://gitcode.com/gh_mirrors/me/mediabunny点击查看免费下载导读Mediabunny v1.52.0 为 AVC、HEVC、VP9 与 AV1 四款视频编码器带来了基于量化器quantizer的恒定质量编码能力从此你设置的质量等级意味着恒定的画质而非恒定的码率且现有代码无需任何改动即可自动获得这项改进。读完本文你将理解量化器的底层压缩原理、掌握新版QualityAPI 的完整用法含逐帧量化器控制并了解它在浏览器WebCodecs与 Node.jsFFmpeg两条编码路径下的实现细节与降级策略。什么是量化器量化器quantizer是视频编码器内部控制丢多少数据的旋钮量化值越低保留的信息越多、画质越高、文件越大量化值越高丢弃的信息越多、画质越低、文件越小。其原理建立在舍入rounding之上帧或帧间差分会被变换为一组整数系数随后这些系数被除以量化值这里做了简化。由于运算发生在整数空间大量数值会因舍入变为 0 而被彻底压缩掉。解码时所有系数再乘以量化值大致恢复到原始数值——但由于舍入已经发生数据损失不可避免这正是有损编码的本质。这套机制之所以行之有效是因为人眼几乎察觉不到被丢弃的数据。与设定编码码率每帧字节数大致恒定相比设定量化器得到的是每帧画质大致恒定编码器在复杂场景下会投入更多比特在画面简单、变化少的场景则保持精简。在追求视觉体验稳定的场景中这通常是更理想的行为——你可以在 src/encode.ts 中看到 Mediabunny 为各编码器定义的量化器合理区间。这个概念在 FFmpeg 中被称为 CRFconstant-rate factor恒定速率因子本质上与量化器是同一回事。如果你用过 FFmpeg 的-crf 18这类参数那么你已经理解量化器的工作方式了。使用量化器编码零改动升级直接使用质量等级如果你已经在用质量等级如QUALITY_MEDIUM进行编码那么 v1.52.0 的量化器支持不需要任何代码改动const conversion await Conversion.init({ input, output, video: { bitrate: QUALITY_MEDIUM, }, }); await conversion.execute();旧版 Mediabunny 的做法是根据目标尺寸估算一个合理的码率然后整个视频都按这个码率编码。新版则真正确保了每一帧——乃至整个视频——都保持中等水准的画质。从 src/encode.ts 的_toVideoRateControl实现可以看到当使用主观质量等级且当前编码器支持量化器时Mediabunny 会直接把该等级线性映射到编码器原生的量化器区间中等质量映射到合理区间中接近最佳的一端从而进入恒定质量模式。固定量化器值如果你希望更直接地控制可以钉死一个精确的量化器值。该刻度是编码器原生的数值越小画质越好AVC / HEVC0–51VP90–63AV10–255video: { codec: avc, bitrate: new Quality({ quantizer: 26 }), }其中codec: avc是 Mediabunny 对 H.264 的命名HEVC、VP9、AV1 同理。量化器的合法取值范围定义在源码的VIDEO_CODEC_QUANTIZER_SUPPORT表中src/encode.tsAVC/HEVC 为 0–51VP9 为 0–63AV1 为 0–255同时记录了对每个编码器而言合理的 worst/best 端点例如 AVC 的 41/16供质量等级映射使用。如果显式量化器超出范围Quality构造会抛出异常除非同时提供了 bitrate 作为降级方案。逐帧量化器控制当你直接驱动编码器例如使用VideoSampleSource时甚至可以为每一帧指定不同的量化器——例如把更多比特花在你更在意的关键帧上const source new VideoSampleSource({ codec: avc, bitrate: new Quality({ quantizer: 26 }), }); // 之后对每个 sample await source.add(sample, { avc: { quantizer: 40 } });这里的{ avc: { quantizer } }对应 WebCodecs 的逐帧VideoEncoderEncodeOptions。Mediabunny 在 src/encode.ts 中通过buildQuantizerEncodeOptions为 AVC/HEVC/VP9/AV1 分别构造对应的逐帧量化器选项并src/encode.ts在全局声明中为VideoEncoderEncodeOptions补齐了hevc、vp9、av1的 quantizer 字段。运行环境与自动降级量化器编码在浏览器中通过 WebCodecs 实现在 Node.js 中通过 mediabunny/server 实现——后者现在会让 FFmpeg 的编码器运行在恒定量化器模式constant-quantizer mode下。当运行环境不支持量化器模式、而用户使用的是主观质量等级如QUALITY_MEDIUM时Mediabunny 会自动降级为码率模式保证代码在不同环境中都能正常工作。新的 Quality API伴随量化器支持Mediabunny 对质量 API 做了一次整体清理所有影响编码压缩率的东西现在统一流经Quality类。你可以用命名等级、自定义 0–1 数值或显式的码率控制参数来构造它完整类型定义见 src/encode.tsnew Quality(medium); // 命名等级 new Quality(0.85); // 自定义等级0 最差1 最佳 new Quality({ bitrate: 1e6 }); // 显式码率VBR new Quality({ bitrate: 1e6, bitrateMode: constant }); // CBR new Quality({ quantizer: 26 }); // 显式量化器 new Quality({ quantizer: 26, bitrate: 1e6 }); // 量化器 码率降级各构造形式的行为细节命名等级very-low、low、medium、high、very-high分别映射到 0、0.25、0.5、0.75、1见 src/encode.ts 的QUALITY_LEVELS表。自定义数值范围 0–10 代表最差、1 代表最佳范围外的极端值也被允许但在某些系统上可能无法正常工作。量化器显式要求量化器驱动编码。若编码器不支持量化器已提供 bitrate 时以 bitrate 为降级方案否则直接抛错如Codec ... does not support quantizer-based encoding或范围越界错误见 src/encode.ts。bitrateModevariable默认或constant仅当解析为码率编码时生效。preferBitrate仅能与quality组合使用设为true时即使量化器可用也强制走码率适合需要可预测输出体积的场景。从源码看Mediabunny 在内部会把质量等级映射为两种互斥的速率控制方案当编码器支持量化器且未设置preferBitrate时质量等级会被线性插值到该编码器的量化器区间否则通过computeVideoBitratesrc/encode.ts按基准码率 × 编码器效率系数 × 质量指数曲线估算码率。音频侧同样基于Quality_toAudioBitratesrc/encode.ts为 AAC、Opus、MP3、Vorbis、AC-3、E-AC-3、DTS 各维护一个基准码率并按质量因子缩放AAC 与 MP3 还会就近对齐到合法码率档位。为了真正欢迎Quality类加入 Mediabunny所有此前命名为bitrate的字段现已弃用deprecated推荐字段改为qualityconst conversion await Conversion.init({ input, output, video: { quality: new Quality(medium), }, });旧的QUALITY_VERY_LOW、QUALITY_LOW、QUALITY_MEDIUM、QUALITY_HIGH、QUALITY_VERY_HIGH常量仍然导出但同样被标记为弃用建议改用new Quality(...)形式见 src/encode.ts。从质量等级到量化器的映射原理当你使用new Quality(medium)这类主观等级时Mediabunny 并不直接把它当码率用而是借助_toVideoRateControlsrc/encode.ts完成一次质量 → 量化器的映射查询VIDEO_CODEC_QUANTIZER_SUPPORT[codec]得到该编码器的 min/max/worst/best 四个端点对主观质量值q执行round(lerp(worst, best, q))并 clamp 到合法范围得到目标量化器若同时设置了显式量化器则量化器优先bitrate 仅作为不可用时的兜底若仅设了显式量化器则 bitrateMode 会被设为quantizer驱动整条编码管线进入恒定质量模式。也就是说质量等级在支持量化器的编码器上自动获得恒定质量这正是现有代码免费升级的来源——浏览器测试用例 test/browser/quality.test.ts 中中等质量对 avc/hevc/vp9/av1/vp8 逐一验证了这条路径vp8 不支持量化器因此会走码率路径。Node.js 端FFmpeg 恒定量化器模式的接入细节在 Node.js 环境中mediabunny/server 的NodeAvVideoEncoderpackages/server/src/video-encoder.ts负责驱动 FFmpeg 编码器。它通过supports()声明当bitrateMode quantizer时仅支持 avc/hevc/vp9/av1其余情况额外支持 vp8/prores。量化器模式下的关键实现细节编码器选择量化器模式下会优先排除绝大多数硬件编码器——代码注释说明 NVENC 是唯一已知能以恒定量化器模式驱动的硬件编码器packages/server/src/video-encoder.ts。码率置零量化器模式把bitRate设为 0避免目标码率把编码器拉回错误的速率控制模式packages/server/src/video-encoder.ts。量化器换算与设置Mediabunny 使用 AV1 的 0–255 量化索引而 libaom-av1/libsvtav1 等编码器期望 0–63 刻度因此做round(quantizer / 4)换算随后为 libx264/libx265 设置qp为 libvpx-vp9/libaom-av1 设置crf为 libsvtav1/librav1e 设置qp为 NVENC 设置rcconstqpqp并额外把qMin/qMax都钉死为目标值确保 crf 类编码器真正保持恒定量化器packages/server/src/video-encoder.ts。逐帧换量化器由于几乎没有任何 FFmpeg 编码器支持在初始化后修改量化器当逐帧量化器值变化时编码器会先排空drain当前编码器再重建一个新的 codec context——实现注释中坦诚写道 Dirty but what else are you gonna dopackages/server/src/video-encoder.ts。这意味着逐帧量化器控制会带来一定的重建开销适合用于关键帧多花比特这类低频差异化场景。测试与验证量化器功能在仓库中有完整的自动化测试覆盖可作为你验证环境与排查问题的参照test/browser/quality.test.ts浏览器端覆盖五个命名等级、自定义等级0.85、preferBitrate、显式码率VBR/CBR、显式量化器、量化器码率兜底等全部构造形态显式量化器用例在环境不支持时会校验是否以明确的错误信息拒绝。test/node/server-extension.test.tsNode.js 端服务扩展与 FFmpeg 编码路径的集成验证。测试中的通用模式是用Input读取测试素材如test/public/video.mp4通过Conversion.init配合video: { codec, quality }执行转码最终断言utilizedTracks中确实产出视频轨道——你可以在自己的转码流程中复用同样的断言思路来验证量化器路径是否被真正命中。详细文档量化器与质量编码的更完整说明可继续阅读Media sources 指南的 Encoding quality 章节Quality类的定性qualitative与定量quantitative两种用法以及各视频/音频源的配置示例VideoSampleSource、CanvasSource、AudioSampleSource等。Quality类的 API 定义与类型签名src/encode.ts。Node.js 服务端扩展说明docs/guide/extensions/server.md。各编码器的量化器合法范围与 codec 字符串规范可参照仓库的 codec-registry 目录 中 avc/hevc/vp9/av1 等条目。赞分享音视频视频处理音频处理【免费下载链接】mediabunnyPure TypeScript media toolkit for reading, writing, and converting video and audio files, directly in the browser.项目地址https://gitcode.com/gh_mirrors/me/mediabunny点击查看免费下载相关推荐微信聊天记录怎么永久保存留痕WeChatMsg免费导出完整指南微信聊天记录怎么永久保存留痕WeChatMsg免费导出完整指南 上周整理旧手机小周想找回去年工作群里一条带合同金额的通知。翻了半天微信的搜索框只看到最SmartTube视频编解码AV1、VP9、AVC格式支持的底层原理SmartTube视频编解码AV1、VP9、AVC格式支持的底层原理 你是否曾在播放4K视频时遇到卡顿或是疑惑为什么同样的视频文件在不同设备上画质差异明显音视频客户端开源视频编解码器生态VP9、AV1与HEVC的竞争格局开源视频编解码器生态VP9、AV1与HEVC的竞争格局 在数字视频技术快速发展的今天视频编解码器已成为互联网内容分发的核心技术。本文将深入分析三大主流视频编文档教程音视频视频上一篇免费跨平台VSDX图表编辑drawio-desktop完整入门指南下一篇告别录屏模糊画质这款免费的抖音视频下载工具一条命令搞定无水印批量下载创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考