# @mattebox/cast-receiver 中文文档

规范地址：https://npmcn.com/package/%40mattebox/cast-receiver/

版本：0\.3\.1
npm 元数据更新时间：2026-11-01T19:52:04.492Z
中文译文更新时间：2026-11-01T20:08:54.621Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：201 kB，78 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.19
- 运行依赖：0 个
- peer 依赖：mattebox ^0\.17\.0，@mattebox/player \>=0\.5\.0，@mattebox/player-core ^0\.9\.0
- 首次发布：2026-09-21T15:27:46.148Z
- 最新版本发布：2026-11-01T19:52:04.145Z
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

谷歌的Cast接收器框架与钩子之间的桥梁。没有自己的DOM。

## 安装

```sh
npm install @mattebox/cast-receiver
```

也可以使用：`pnpm add @mattebox/cast-receiver`、`yarn add @mattebox/cast-receiver`、`bun add @mattebox/cast-receiver`

## README

# @mattebox / cast-receiver

这个库将谷歌的Cast接收器框架（CAF，版本3）连接到 `<mattebox-player>`． 你可以将网页变成Chromecast接收器 几行代码。库不创建DOM，导入它也不创建DOM 副作用。

安装库及其对等依赖项：

```sh
npm install @mattebox/cast-receiver @mattebox/player @mattebox/player-core mattebox
```

添加谷歌的框架到你的页面：

```html
<script src="https://www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
```

创建接收者，创建带有接收者处理程序的玩家，然后 启动接收器：

```ts
import { createReceiver } from '@mattebox/cast-receiver';
import { MatteboxPlayerElement } from '@mattebox/player';
import full from 'mattebox/presets/full';

const receiver = createReceiver({ preset: full });
const player = new MatteboxPlayerElement({ handlers: receiver.handlers() });
document.body.append(player);
receiver.start(player);
```

| 图书馆是这样做的 | 库不这样做 |
| --- | --- |
| 它通过了发送方的 `LOAD` 通过你的 `resolve` 然后加载播放器 | 它不创建或追加任何元素 |
| 它报告来自视频和引擎的媒体状态 | 它不知道令牌是什么，也不知道许可证来自哪里 |
| 它在稳定的Cast id下选择音频和文本轨道 | 它不捆绑引擎预设。您的页面导入了一个 |
| 它将玩家的错误发送给每个发送者 | 它不加载谷歌的框架。你的页面会加载它 |
| 它传递自定义名称空间 | 它没有提供一个虚假的框架。图书馆有自己的测试 |

框架的脚本从来不是库的依赖项。引擎， 核心和玩家是相互依赖的。

你可以在仓库中阅读指南： [文档/指南](https://github.com/jboix/mattebox-receiver/blob/main/docs/guide/README.md).

## 许可证

麻省理工学院

## 常见问题

### @mattebox/cast-receiver 是什么？

谷歌的Cast接收器框架与钩子之间的桥梁。没有自己的DOM。

### 如何安装 @mattebox/cast-receiver？

在项目目录运行 npm install @mattebox/cast-receiver，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：mattebox（^0\.17\.0）、@mattebox/player（\>=0\.5\.0）、@mattebox/player-core（^0\.9\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @mattebox/cast-receiver 支持 TypeScript 吗？

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

### @mattebox/cast-receiver 支持 ESM 还是 CommonJS？

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

### @mattebox/cast-receiver 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.19。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @mattebox/cast-receiver 可以商用吗？

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

### @mattebox/cast-receiver 还在维护吗？

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