# @amazon/vinyl-transmux 中文文档

规范地址：https://npmcn.com/package/%40amazon/vinyl-transmux/

版本：5\.0\.0
npm 元数据更新时间：2026-11-16T02:14:57.373Z
中文译文更新时间：2026-11-16T02:21:32.954Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40amazon/vinyl-transmux
原文对照：https://npmcn.com/package/%40amazon/vinyl-transmux/?lang=original
项目主页：https://github.com/amazonmusic/vinyl#readme
源码仓库：https://github.com/amazonmusic/vinyl

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：405 kB，44 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-05-27T23:27:13.292Z
- 最新版本发布：2026-11-16T02:14:56.998Z
- 近 30 天下载量：2546（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：44（近 12 个月 44 个）

## 中文简介

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

## 安装

```sh
npm install @amazon/vinyl-transmux
```

也可以使用：`pnpm add @amazon/vinyl-transmux`、`yarn add @amazon/vinyl-transmux`、`bun add @amazon/vinyl-transmux`

## README

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

[![Website](https://img.shields.io/badge/website-amazonmusic.github.io%2Fvinyl-blue)](https://amazonmusic.github.io/vinyl) [![npm](https://img.shields.io/npm/v/@amazon/vinyl-transmux.svg)](https://www.npmjs.com/package/@amazon/vinyl-transmux) [![size](https://img.shields.io/bundlejs/size/@amazon/vinyl-transmux.svg?label=size)](https://bundlejs.com/?q=@amazon/vinyl-transmux)

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

## 安装

```shell
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 和介质 部分.

## 使用量

```typescript
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- TS | fMP4 音频 (`mp4a`(中文(简体) ) | 对 |
| 带有H.264的MPEG-TS | fMP4视频(`avc1`(中文(简体) ) | 对 |
| MPEG- TS 粘合剂 | fMP4 视频+音频(多特拉克) | 对 |

## MP4 框写器

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

```typescript
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 是什么？

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 和提交记录判断。

