@crvouga/mockingbird-service-mediaconvert

中文文档
3.11.0发布于 2026/11/11MITTypeScriptES Module构建来源已验证近 30 天下载 3076

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

中文使用文档
文档目录5 节
  1. 安装
  2. 使用量
  3. 控件
  4. API 密码
  5. 故意不模拟

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

本地模拟器。 真正的API合同. 部分 嘲笑鸟。 。 。 .

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

安装

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

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

使用量

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 参考。 。 。 .

版本与发布记录

@crvouga/mockingbird-service-mediaconvert 共发布 41 个版本,首次发布于 2026/09/23;过去 12 个月发布了 41 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.11.0latest2026/11/11今天
3.10.92026/11/038 天前
3.10.82026/11/038 天前
3.10.72026/11/038 天前
3.10.62026/11/038 天前
3.10.52026/11/038 天前

关于 @crvouga/mockingbird-service-mediaconvert 的常见问题

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