@amazon/vinyl-transmux

中文文档
5.0.0发布于 2026/11/16Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 2546

MPEG-TS为fMP4转录器,用于浏览器和节点.

中文使用文档
文档目录8 节
  1. 安装
  2. 建筑
  3. 使用量
  4. 支持的格式
  5. MP4 框写器
  6. ID3 标记
  7. H.264 SPS分析
  8. 许可证

@amazon/ vinyl- transmux (中文(简体) )

Website npm size

将 MPEG- TS 和 原始 ADTS 片段转换为零碎的 MP4( fMP4) 进行回放 通过媒体源扩展. 外相依无相.

安装

npm install @amazon/vinyl-transmux

建筑

软件包分为三层:

┌─────────────────────────────────────────────┐
│  transmux      Stateful transmuxer          │
│                (createTransmuxer)           │
├─────────────────────────────────────────────┤
│  sampleEntry   Codec-specific MP4 boxes     │
│                (mp4a/esds, avc1/avcC)       │
├──────────────────┬──────────────────────────┤
│  mp4             │  mpegts / adts           │
│  Generic fMP4    │  Demux + parse           │
│  box writer      │                          │
└──────────────────┴──────────────────────────┘
  • ưμ㼯a ——通用ISO BMFF框写器. 生产 ftyp, (中文(简体) ), moov, (中文(简体) ), moof, (中文(简体) ), mdat,以及所有结构子框。 没有密码知识。 可配置通过 选项,带有合理的默认值.
  • 缩写 ——MPEG Transport Stream demuxer. 中国铁路总公司. PAT/PMT 组合 包,取出PTS时间戳.
  • 备注 ——音频数据传输流解析器. 提取 AAC 框架边界, 样本率和频道配置.
  • 样本 —— Codec特有MP4样本条目构建器. 生产 mp4a + 键 esds 审计咨询委员会 avc1 + 键 avcC 页:1 这是唯一的一层与 密码知识.
  • 变相器 ——国语管弦乐家. 检测输入格式( MPEG- TS 或 原始) ADTS 、 demux 、 解析码器配置, 构建 fMP4 init 和介质 部分.

使用量

import { createTransmuxer } from '@amazon/vinyl-transmux'

const transmuxer = createTransmuxer()

// For each HLS segment (ArrayBuffer of MPEG-TS or ADTS data):
const result = transmuxer.transmux(segmentData)

// result.initSegment — ftyp + moov (always returned, cached after first call)
// result.mediaSegment — moof + mdat
// result.duration — segment duration in seconds

转接器很稳重 呼叫 transmux() 每段按顺序排列。 这个 音轨解码时间戳、序列号和代码配置 打电话 初始端段在第一次呼叫时生成, 并缓存到后续 打电话.

支持的格式

投入产出状态
阿拉伯会计社fMP4 音频 (mp4a(中文(简体) )对
带有 AAC 的 MPEG- TSfMP4 音频 (mp4a(中文(简体) )对
带有H.264的MPEG-TSfMP4视频(avc1(中文(简体) )对
MPEG- TS 粘合剂fMP4 视频+音频(多特拉克)对

MP4 框写器

这个 mp4 模块是通用的 fMP4 盒式刻录器,可独立使用 转换器 :

import {
    box,
    fullBox,
    ftyp,
    moov,
    audioTrak,
    videoTrak,
    moof,
    mdat,
    patchDataOffset,
} from '@amazon/vinyl-transmux'

const ftypBox = ftyp({
    majorBrand: 'dash',
    compatibleBrands: ['iso6', 'mp41'],
})

const moovBox = moov(
    audioTrak({
        trackId: 1,
        sampleRate: 44100,
        channelCount: 2,
        sampleEntry: myAudioSampleEntry,
    }),
    videoTrak({
        trackId: 2,
        width: 1920,
        height: 1080,
        sampleEntry: myVideoSampleEntry,
    })
)

const moofBox = moof({
    sequenceNumber: 1,
    trackId: 1,
    baseDecodeTime: 0,
    samples: [
        { duration: 1024, size: 400 },
        { duration: 1024, size: 380 },
    ],
})
patchDataOffset(moofBox, moofBox.byteLength)
const mdatBox = mdat(rawMediaData)

ID3 标记

引导 ID3v2 标记( HLS 中常见的计时元数据) 自动跳过 在格式检测之前.

H.264 SPS分析

变压器包括一个能取出分辨率和 序列参数集NAL单元的配置信息。 它支持基线, 主和高剖面图,包括铬格式和缩放矩阵 扩展.

许可证

阿帕奇 - 2.0

版本与发布记录

@amazon/vinyl-transmux 共发布 44 个版本,首次发布于 2026/05/28;过去 12 个月发布了 44 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
5.0.0latest2026/11/16今天
4.1.1-next.20261115174554next2026/11/16今天
4.1.1-next.202611151724472026/11/16今天
4.1.1-next.202611151644392026/11/16今天
4.1.1-next.202611150013552026/11/151 天前
4.1.1-next.202611131749092026/11/142 天前

其他发布通道:hotfix-chromos → 1.2.1,hotfix-close-drm-sessions → 1.2.2,next → 4.1.1-next.20261115174554。

关于 @amazon/vinyl-transmux 的常见问题

@amazon/vinyl-transmux 是什么?

MPEG-TS为fMP4转录器,用于浏览器和节点.

如何安装 @amazon/vinyl-transmux?

在项目目录运行 npm install @amazon/vinyl-transmux,或使用 pnpm add / yarn add / bun add。

@amazon/vinyl-transmux 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@amazon/vinyl-transmux 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@amazon/vinyl-transmux 可以商用吗?

@amazon/vinyl-transmux 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@amazon/vinyl-transmux 的下载量有多少?

根据 npm 官方下载统计,@amazon/vinyl-transmux 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,546 次,日均约 85 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@amazon/vinyl-transmux 还在维护吗?

最新版本 5.0.0 发布于 2026/11/16(今天);至今共发布 44 个版本,其中过去 12 个月发布了 44 个;首次发布于 2026/05/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。