# @beyondwords/player 中文文档

规范地址：https://npmcn.com/package/%40beyondwords/player/

版本：0\.5\.4
npm 元数据更新时间：2026-11-06T08:30:19.799Z
中文译文更新时间：2026-11-08T00:39:13.752Z
软件包许可：See license in README\.md

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

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

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

- 包体积（解压后）：9.7 MB，11 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2023-03-22T15:46:18.130Z
- 最新版本发布：2026-11-06T08:30:19.416Z
- 近 30 天下载量：8602（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：165（近 12 个月 17 个）

## 中文简介

BeyondWords是一款AI语音和音频CMS,它使出版商能够将其内容转化为为受众提供的自然发声和吸引人的音频体验. 此寄存器包括 BeyondWords 播放器, 它与

## 安装

```sh
npm install @beyondwords/player
```

也可以使用：`pnpm add @beyondwords/player`、`yarn add @beyondwords/player`、`bun add @beyondwords/player`

## README

## 超越 Words 播放器

BeyondWords是一款AI语音和音频CMS,它使出版商能够将其内容转化为为受众提供的自然发声和吸引人的音频体验. 这个寄存器包括"BeyondWords"播放器,它与"BeyondWords"音频CMS无缝地融合,并可以轻松地被嵌入到您的网站或app中. 您可以创建账户 [这里](https://dash.beyondwords.io/auth/signup)。 。 。 .

将 BeyondWords 播放器嵌入您网站的最简单方法是复制 beyondWords CMS 中的玩家脚本。 但是,对于那些希望 进一步自定义玩家,此文档提供了有用的指南和 对每个玩家设置的详细解释. 你可以看到一个演示 播放器 [这里](https://beyondwords-io.github.io/player-demo)。 。 。 .

请参看我们 **[正式文件](https://docs.beyondwords.io/docs-and-guides/distribution/player/overview)** 更多信息.

默认玩家的 Light, Dark, 以及 视频调色板记录在 [默认玩家调色板](https://npmcn.com/package/%40beyondwords/player/doc/color-palettes.md)。 。 。 .

## 开发设置

我们建议您使用节点版本来管理节点版本. 有一个 `.nodenv` 在寄存器根中的文件。 你得先安排好这个 接下来, 运行以下操作以安装依赖并启动端口 8000 的服务器 :

```sh
./bin/setup
./bin/server
```

玩家在修改代码时会活装.

`http://localhost:8000` 开始为空: 输入工程ID, 加上内容或 播放列表 ID, 在右侧的控制面板并按下获取 。 然后小组 显示什么 `/player` 结束点返回,玩家下面的文章是 从该内容本身的片段重建,所以突出显示和点击到播放可以 被审判反对。 任何你改变的面板 覆盖项目 设置,且页面的 URL 保留这些更改,以便作为再Pro共享:

```
http://localhost:8000/?projectId=12345&contentId=abc-123&set=theme:dark&set=radius:0
```

## 测试

您可以使用:

```sh
./bin/test_units
./bin/test_screenshots
./bin/test_accessibility
./bin/lint
```

截图和无障碍测试使用 Playwright 并被粘贴到 避免由于浏览器版本差异导致测试失败. 你会需要 安装了Docker来运行这些测试. 这些测试在推时自动运行 给 GitHub .

## 部署

1.  更新版本为 `./bin/version <version>`
    
2.  以 `Release version <version>`
    
3.  按下更改并等待CI通过
    
4.  随版本添加标签 : `git tag <version>`
    
5.  按下标签 `git push --tags`
    
6.  从标签中创建 GitHub 释放并等待 CD 通过
    
7.  运行 `./bin/purge_cache` (编) `--azure` 也可以清洗 Azure Front Door ) 或等待~24小时后缓存失效.
    
    在npm发布完成后15分钟再使用清洗脚本.
    

## 捐款

我们欢迎我们的顾客和公众的贡献。 请 打开 GitHub 问题, 如果您在使用玩家时有困难 工作没有预期的好.

我们更希望你别把这个仓库叉开 [联系我们](mailto:support@beyondwords.io) 如果您有一个要求是 当前玩家未满足 。 请注意,可以建立一个习惯 在已有播放器上方的用户界面.

## 许可证

版权 (c)2023 Lstn Ltd (以"Beyond Words"为交易). 版权所有.

该存放处及其内容,包括但不限于源代码、文件和资产,是Beyond Words的唯一财产,受适用的版权、商标和其他知识产权法的保护.

您被允许使用玩家嵌入, SDK 和您的项目提供的国家防范机制软件包。 未经BeyondWords公司事先书面许可,不得以任何形式或任何手段以电子或机械形式复制、分发、修改或传送该储存库的任何部分,除非是为了提交拉动请求和对项目作出贡献.

欢迎以拉动请求形式提供的捐款;然而,BeyondWords保留审查、批准或拒绝对守则作任何修改的权利.

询问和许可请求请与 [支持@ beyondwords.io](mailto:support@beyondwords.io)。 。 。 .

## 常见问题

### @beyondwords/player 是什么？

BeyondWords是一款AI语音和音频CMS,它使出版商能够将其内容转化为为受众提供的自然发声和吸引人的音频体验\. 此寄存器包括 BeyondWords 播放器, 它与

### 如何安装 @beyondwords/player？

在项目目录运行 npm install @beyondwords/player，或使用 pnpm add / yarn add / bun add。

### @beyondwords/player 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/beyondwords\_\_player 是否存在。

### @beyondwords/player 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @beyondwords/player 可以商用吗？

@beyondwords/player 使用 See license in README\.md 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @beyondwords/player 的下载量有多少？

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

### @beyondwords/player 还在维护吗？

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