# @aglyn/plugins-video-delivery 中文文档

规范地址：https://npmcn.com/package/%40aglyn/plugins-video-delivery/

版本：1\.18\.0
npm 元数据更新时间：2026-11-07T06:41:48.588Z
中文译文更新时间：2026-11-05T23:23:20.488Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40aglyn/plugins-video-delivery
原文对照：https://npmcn.com/package/%40aglyn/plugins-video-delivery/?lang=original
项目主页：https://aglyn.com/
源码仓库：https://github.com/aglyn/aglyn

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

- 包体积（解压后）：141 kB，30 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-09-20T23:53:47.782Z
- 最新版本发布：2026-11-07T06:41:48.212Z
- 近 30 天下载量：9663（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：161（近 12 个月 161 个）

## 中文简介

Cloudflare R2的图书馆录像通过一名工人提供,是核心媒体传送合同的幕后黑手(`core.media-delivery` 内 `@aglyn/aglyn/plugin-manager/media-delivery-provider`) (中文(简体) ). Core 作出每个访问决定, 绝不命名提供者; 此插件持有

## 安装

```sh
npm install @aglyn/plugins-video-delivery
```

也可以使用：`pnpm add @aglyn/plugins-video-delivery`、`yarn add @aglyn/plugins-video-delivery`、`bun add @aglyn/plugins-video-delivery`

## README

# @aglyn/plugins-video-交付

从Cloudflare R2通过一个工人提供图书馆录像 核心媒体交付合同`core.media-delivery` 内 `@aglyn/aglyn/plugin-manager/media-delivery-provider`) (中文(简体) ). 核心使每个 访问决定, 绝不命名提供者; 此插件保存副本 并服务于他们.

> 从Aglyn monorepo出版到npm. 随后的版本 [语义版本](https://semver.org/)。 。 。 .

## 安装

```bash
npm install @aglyn/plugins-video-delivery
```

通过 Aglyn 的插件管理器装入插件( A)`@aglyn/aglyn`由控制台和租户运行时间组成;它不是一个独立的图书馆.

-   `declarations.server.ts` 将供应商登记在两个应用程序的启动处 (单位:千美元)`serverDeclarations` 内 `plugins.config.json`) (中文(简体) ).
-   `video-delivery-provider.ts` ——适配器:复制到R2通过它的S3 API 和 交付 URL 被刻入 `MEDIA_VIDEO_DELIVERY_HOST`。 。 。 .
-   `r2-object-store.ts`, (中文(简体) ), `sigv4.ts` 四个S3呼叫复制流程, 与 SigV4 在 Web Crypto 上签名。 没有SDK.
-   `delivery-token.ts` – 一个符号格式的平台薄荷和 工人验证.
-   `worker/video-worker.ts` ——工人报. 它能证实迹象, 签名和它命名的对象键) 装有射程的桶装 `HEAD`。 。 。 . `wrangler.jsonc` 部署它作为 工人 `video`。 。 。 .

## 开关

三个都开着之前,这里什么也没有

1.  设置. `store` 需求 `R2_ACCOUNT_ID`, (中文(简体) ), `R2_ACCESS_KEY_ID`, (中文(简体) ), `R2_SECRET_ACCESS_KEY` 财务报告和审定财务报表 `R2_VIDEO_BUCKET` - 只有在有副本的情况下 写作,这是控制台. `deliver` 需求 `MEDIA_VIDEO_DELIVERY_HOST` 财务报告和审定财务报表 `MEDIA_VIDEO_DELIVERY_SECRET` 任意刻入URL:控制台和 租户的应用程序。 秘诀不是 `TOKEN_SIGNING_SECRET`和劳动者 和它自己的秘密一样.
2.  释放旗 `release_video_delivery`, 平均数值。 它的大门复制为 还有快递.
3.  由该资产当前字节制成的副本 。 直到一个存在,视频 从平台上服务,一如既往.

## 当插件打开时, 哪些内容是真实的

-   已出版的网页允许发送主机在 `media-src` 独自一人 (单位:千美元)`mediaDeliveryOrigin` 重播时 `security-origins.js`,其内容如下: `MEDIA_VIDEO_DELIVERY_HOST` 规则 `videoDeliveryOrigin` 适用;a 这里的Spec将两者按到相同的答案). 没有它,浏览器 拒绝重定向.
-   月台的桶里保存着所有视频 存储柜台算它 一次;一个副本的大小从未加入. 让R2复制唯一的副本 视频的存储成本模型取决于该步骤 。 。 。 .
-   Cloudflare 接收客户视频,并在中途接收取景者的IP地址 和用户代理。 一定是开着的 `/legal/subprocessors` 在国旗被悬挂之前 任何客户。 由所有者决定并公布; 此插件 声明否 `subprocessors` 条目,直到该页面带有行.

## 许可证

阿帕奇2.0 (英语). 资料来源: [https://github.com/aglyn/aglyn/tree/main/libs/plugins/video-交付 互联网档案馆的存檔,存档日期2014-12-21](https://github.com/aglyn/aglyn/tree/main/libs/plugins/video-delivery)

## 常见问题

### @aglyn/plugins-video-delivery 是什么？

Cloudflare R2的图书馆录像通过一名工人提供,是核心媒体传送合同的幕后黑手\(core\.media-delivery 内 @aglyn/aglyn/plugin-manager/media-delivery-provider\) \(中文\(简体\) \)\. Core 作出每个访问决定, 绝不命名提供者; 此插件持有

### 如何安装 @aglyn/plugins-video-delivery？

在项目目录运行 npm install @aglyn/plugins-video-delivery，或使用 pnpm add / yarn add / bun add。

### @aglyn/plugins-video-delivery 支持 TypeScript 吗？

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

### @aglyn/plugins-video-delivery 支持 ESM 还是 CommonJS？

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

### @aglyn/plugins-video-delivery 可以商用吗？

@aglyn/plugins-video-delivery 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aglyn/plugins-video-delivery 的下载量有多少？

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

### @aglyn/plugins-video-delivery 还在维护吗？

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