# @crvouga/mockingbird-service-mediaconvert 中文文档

规范地址：https://npmcn.com/package/%40crvouga/mockingbird-service-mediaconvert/

版本：3\.11\.0
npm 元数据更新时间：2026-11-11T02:26:35.206Z
中文译文更新时间：2026-11-11T05:55:08.334Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40crvouga/mockingbird-service-mediaconvert
原文对照：https://npmcn.com/package/%40crvouga/mockingbird-service-mediaconvert/?lang=original
项目主页：https://github.com/crvouga/mockingbird/tree/main/packages/service/mediaconvert#readme
源码仓库：https://github.com/crvouga/mockingbird

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

- 包体积（解压后）：4.3 MB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-09-22T23:55:40.528Z
- 最新版本发布：2026-11-11T02:26:34.851Z
- 近 30 天下载量：3076（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：41（近 12 个月 41 个）

## 中文简介

状态 AWS Elemental Media Convert 模拟器,包含端点发现,同步任务, EventBridge 事件,以及决定性的 S3 输出.

## 安装

```sh
npm install @crvouga/mockingbird-service-mediaconvert
```

也可以使用：`pnpm add @crvouga/mockingbird-service-mediaconvert`、`yarn add @crvouga/mockingbird-service-mediaconvert`、`bun add @crvouga/mockingbird-service-mediaconvert`

## README

# @crvouga/mockingbird-service-medicalconvert (中文(简体) )

> 本地模拟器。 真正的API合同. 部分 [嘲笑鸟](https://github.com/crvouga/mockingbird)。 。 。 .

用于官方SDK v3客户端的状态 AWS Elemental Media Convert仿真器. 它支持端点发现,一个同步的任务,决定控制,事件Bridge相容事件,输出写入一个已配置的仿真器S3服务.

## 安装

```bash
npm install -D @crvouga/mockingbird-service-mediaconvert
```

仅限无害环境管理。 节点22+或Bun 1.2+.

## 使用量

```ts
import {
  CreateJobCommand,
  DescribeEndpointsCommand,
  MediaConvertClient,
} from "@aws-sdk/client-mediaconvert"
import { createServer } from "@crvouga/mockingbird-service-mediaconvert/server"

// Test setup: start the emulator and point the discovery client at it.
const server = await createServer()
const aws = {
  region: "us-east-1",
  credentials: { accessKeyId: "fixture", secretAccessKey: "fixture" },
}
const discovery = new MediaConvertClient({ ...aws, endpoint: server.url })

// Application code, unchanged. DescribeEndpoints returns the emulator URL, which the
// second client uses to submit jobs.
const { Endpoints } = await discovery.send(new DescribeEndpointsCommand({}))
const mediaConvert = new MediaConvertClient({ ...aws, endpoint: Endpoints?.[0]?.Url })
const { Job } = await mediaConvert.send(
  new CreateJobCommand({
    Role: "arn:aws:iam::000000000000:role/MediaConvert",
    Settings: {
      Inputs: [{ FileInput: "s3://inputs/source.mp4" }],
      OutputGroups: [
        {
          OutputGroupSettings: {
            Type: "FILE_GROUP_SETTINGS",
            FileGroupSettings: { Destination: "s3://outputs/video/" },
          },
        },
      ],
    },
  }),
)
// Job.Status === "SUBMITTED"

await server.close()
```

支持的操作有描述端点(Description Endpoints),CreateJob(CreateJob),GetJob(GetJob)和CancelJob等. CreateJob保留了角色,队列,用户Metadata,以及完整的嵌入式设置结构. 重复的客户端请求返回原工作 .

## 控件

-   `GET /__admin/jobs` 财务报告和审定财务报表 `GET /__admin/jobs/:id` 检查提交的任务和确切设置.
-   `POST /__admin/jobs/:id/transition` 接受 `status` (单位:千美元)`PROGRESSING`, (中文(简体) ), `COMPLETE`, (中文(简体) ), `ERROR`,或 `CANCELED`\+ 可选 `progress`, (中文(简体) ), `durationInMs`, (中文(简体) ), `size`, (中文(简体) ), `names`, (中文(简体) ), `errorCode`,以及 `errorMessage`。 。 。 .
-   完成一个任务时, 向每个 HLS 或文件组 S3 目标写决定性输出字节 `s3.endpoint` 已配置.
-   每个状态都改变 发出一个事件Bridge 兼容 `MediaConvert Job State Change` 活动通过共享的 webhook 中枢.
-   错误预设为 `too_many_requests`, (中文(简体) ), `internal_error`,以及 `unavailable`。 。 。 .

共享运行时间提供重置,时钟,日记,度量衡,断层,和命名空间隔离.

## API 密码

-   `MediaConvertAPI`, (中文(简体) ), `MediaConvertAPIOptions`, (中文(简体) ), `MediaConvertEvent`, (中文(简体) ), `TransitionOptions`:处理器,事件,和决定控制.
-   `MediaConvertJob`, (中文(简体) ), `MediaConvertJobStatus`, (中文(简体) ), `OutputGroupDetail`: 持久就业状态.
-   `createRuntime`, (中文(简体) ), `MediaConvertRuntime`, (中文(简体) ), `MediaConvertRuntimeOptions`:完整的"鸟"跑步时间和"网球"中枢.
-   `MEDIACONVERT_NAMESPACE`, (中文(简体) ), `MEDIACONVERT_PRESETS`, (中文(简体) ), `accessKeyCredential`:常数和故障控制.
-   `document`, (中文(简体) ), `operationIds`, (中文(简体) ), `supportedOperationIds`: 生成了 OpenAPI 元数据.
-   `createServer`, (中文(简体) ), `MediaConvertServerOptions`, (中文(简体) ), `DEFAULT_PORT`, (中文(简体) ), `serveTarget` 从 `./server`:节点HTTP适配器和CLI集成.

## 故意不模拟

所提交的HLS/MP4结构以外的真实转码,IAM评价,任意操作,生产限制,计费,仪表板,和编码器没有被模拟.

官方预言: [AWS 元素介质转换 API 参考](https://docs.aws.amazon.com/mediaconvert/latest/apireference/what-is.html)。 。 。 .

## 常见问题

### @crvouga/mockingbird-service-mediaconvert 是什么？

状态 AWS Elemental Media Convert 模拟器,包含端点发现,同步任务, EventBridge 事件,以及决定性的 S3 输出\.

### 如何安装 @crvouga/mockingbird-service-mediaconvert？

在项目目录运行 npm install @crvouga/mockingbird-service-mediaconvert，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mockingbird-mediaconvert，可以用 npx mockingbird-mediaconvert 直接运行。

### @crvouga/mockingbird-service-mediaconvert 支持 TypeScript 吗？

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

### @crvouga/mockingbird-service-mediaconvert 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @crvouga/mockingbird-service-mediaconvert 可以商用吗？

@crvouga/mockingbird-service-mediaconvert 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @crvouga/mockingbird-service-mediaconvert 的下载量有多少？

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

### @crvouga/mockingbird-service-mediaconvert 还在维护吗？

最新版本 3\.11\.0 发布于 2026/11/11（今天）；至今共发布 41 个版本，其中过去 12 个月发布了 41 个；首次发布于 2026/09/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。