# @donkeyclip/motorcortex-player 中文文档

规范地址：https://npmcn.com/package/%40donkeyclip/motorcortex-player/

版本：2\.17\.0
npm 元数据更新时间：2026-05-03T21:02:08.957Z
中文译文更新时间：2026-11-12T16:10:45.933Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：317 kB，57 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- Node.js 要求：\>=12
- 运行依赖：1 个
- peer 依赖：@donkeyclip/motorcortex \>=9\.19\.0，@donkeyclip/motorcortex-player-lite \>=1\.0\.0
- 首次发布：2021-09-23T14:09:08.501Z
- 最新版本发布：2026-05-03T21:02:08.802Z
- 近 30 天下载量：7680（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：89（近 12 个月 3 个）

## 中文简介

MotorCortex 的玩家插件

## 安装

```sh
npm install @donkeyclip/motorcortex-player
```

也可以使用：`pnpm add @donkeyclip/motorcortex-player`、`yarn add @donkeyclip/motorcortex-player`、`bun add @donkeyclip/motorcortex-player`

## README

# 摩托计算器

**目录**

-   [摩托计算器](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-motorcortex-player)
    -   [演示](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-demo)
-   [内部/特征](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-intro--features)
-   [开始](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-getting-started)
    -   [安装](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-installation)
    -   [导入](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-importing)
-   [创建玩家](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-creating-player)
    -   [选项](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-options)
    -   [方法](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-methods)
    -   [主题](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-themes)
        -   [透明](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-transparent)
        -   [蓝色](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-blue)
        -   [绿色](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-green)
        -   [黄色](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-yellow)
        -   [阴暗](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-dark)
        -   [暗金刚](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-darkgold)
        -   [白金笔](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-whitegold)
        -   [自定义](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-custom)
    -   [驴子剪接查询](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-donkeyclip-queryparams)
-   [捐款](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-contributing)
-   [发起人:](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-sponsored-by)

## 演示

[看这里](https://donkeyclip.github.io/motorcortex-player/demo/)

# 内部/特征

MotorCortex Player是一款为MotorCortex Clips特别设计的类似视频的播放器. 除其他功能外,玩家允许用户播放/暂停并寻求一个Clip,控制主音量和回放速度等.

我们的玩家包括什么?

![Player Controls Image](https://donkey-spaces.ams3.digitaloceanspaces.com/assets/motorcortex-player/teo-player-numbers.png?)

1.  播放/暂停按钮
2.  主音量
3.  时间: Clip 的回放/总剪辑时间所经过的时间
4.  循环: 如果您想要设置 Clip 播放回放的循环, 请点击此按钮 。 两个灰色锚点会出现在时间线上,从那里可以定义回路边界.
5.  选项: 单击打开选项面板
6.  全屏: 剪接去全屏
7.  指针事件:启用"指针事件"将允许您鼠标访问剪贴板的内容. 否则会禁用 Clip 内容上的所有鼠标( 指针) 事件
8.  显示音量: 显示或隐藏主音量控制 (# 2)
9.  速度:单击打开速度变化控制
10.  玩家的背景颜色
11.  实际的机车夹

# 开始

## 安装

```bash
$ npm install --save @donkeyclip/motorcortex-player
# OR
$ yarn add @donkeyclip/motorcortex-player
```

## 导入

```javascript
import MCPlayer from "@donkeyclip/motorcortex-player";
```

# 创建玩家

玩家可以使用任何摩托Cortex Clip. 以下是一个最小配置的例子:

```javascript
const player = new MCPlayer({ clip: MyClip });
```

## 选项

除(强制性) `clip` 选项,该选项应在即时播放器上传递

| 选项 | 默认值 | 说明 |
| --- | :-: | --- |
| 剪贴板 | \- 说吧 | 玩家将控制的 MotorCortex Clip 对象 |
| 显示卷 | 虚假 | 显示或隐藏主音量控制 (# 2) |
| 东道主 | 无效 | 玩家默认的"包装"其容器下方的"剪接"和座位会利用它的全宽. 如果您想要玩家在不同的主机( 元素) 上被渲染, 您可以在此通过此元素 |
| 按钮 | {循环:真,满分:真,设置:真} | 一个可以选择三个按钮中的哪个对象(# 4: 循环通过密钥"loop", # 5: 设置通过密钥"设置", # 6: 全屏通过密钥"fullScreen"). 通过将对应的密钥设置为真或假来启用并禁用按钮, 因此 |
| 时间格式 | 编号 | 此选项允许您设定玩家时间( 第 3) 上的时间单位 。 默认为 ss,这意味着时间将以表单显示: < 已过期秒 > / < 总秒 > 。 如果您想要表格中的表示: ms/ ms 您可以设置此选项为 “ ms ” |
| 主题 | "透明" | 您可以在此选择玩家可用的主题之一 。 现有主题有:"透明","蓝色","黄色","绿色","白金","黑暗"和"默认"等 |
| 主题CSS | \- 说吧 | 使用此属性定义自己的主题 . [检查如何定义自定义主题](https://npmcn.com/package/%40donkeyclip/motorcortex-player/#readme-custom) |
| 音量 | 1个 | 您可以使用此选项定义音量值 。 可接受值为 0 和 1 之间的任意数字或等于该数字 |
| 速度 | 1个 | 来自女巫的地产,你可以选择执行速度. 任何正值或负值均可接受 |
| 循环 | 虚假 | 一个布尔指标, 剪辑是否会与循环选项结合 |
| 自动播放 | 虚假 | 此选项可以在装入完成后自动启动剪贴板 |
| 控件 | 真实 | 此选项允许您选择玩家控件是否可见, 因此对用户有用 。 当此选项被禁用时, 您无法通过单击事件来播放或暂停剪辑 。 如果玩家类型设定为"滚动",则可以滚动事件 |
| 缩放到配置 | 真实 | 用于定义剪贴板是否将自动缩放以适应其主机元素的属性 |
| 溢出额 | "隐藏" | 要定义剪贴板边框以外的元素是否可见的属性 。 任何 Cs 溢出值都是可以接受的 |
| 大纲 | 未设定 | 一个属性来定义剪辑的边框样式 。 这在编辑时间上可能有用 。 接受任何 Css 边框值 |
| 可见 | 未设定 | 一个要定义的属性, 如果您想要您的剪辑在玩家控制之上 。 接受值未定义, “总是” |
| 指针事件 | 真实 | 这个选项在剪辑上方增加了一个透明的div元素来防止剪辑元素上的用户事件(如选择). 启用时, 剪辑上的任何点击事件都会触发播放或暂停事件 |
| 背景颜色 | 黑头 | 定义玩家背景的 Css 颜色值 |
| 速度数值 | \[-1、0.5、1、2\] | 在速度设置面板上作为支持选项提供的数组值 。 此选项不会阻止用户在程序上将剪辑速度更改为速度Values属性中未提供的另一个值 |
| 哑巴 | 虚假 | 要定义剪贴板启动时是否变音的布尔属性 |
| 当前脚本 |  | (兴趣驴克林开发者) 如果片段将从包含玩家的外部来源的脚本上加载,则可以提供脚本元素的引用,并使用所有可用的控件属性作为脚本的数据-\*属性(如:currentScript=document.currentScript) |
| 毫秒( m) | 0 个 | 从女巫开始的一毫秒 片段就会开始 |
| 缩略图 | \- 说吧 | 在闲置状态下显示的缩略图图像 URL |
| 缩略图颜色 | \- 说吧 | 在闲置状态下显示的缩略图背景颜色 |
| 类型 | "违约" | 您可以选择“ 滚动器” 或“ 默认” 类型 。 如果您不定义此属性, 默认玩家正在激活 |
| 滚动动画 | 虚假 | 如果您将此属性设置为真实, 您可以通过延长滚动时间来将动画添加到滚动中 |
| 最大滚动集 | 第50条 | 可以存储滚动事件来扩展滚动体验. 此属性在滚动动画设定为真实的情况下最有效, 它需要大于零的界面值 |
| 节次 | \- 说吧 | 当您想要对滚动事件进行搜索时, 可以将区域定义为毫秒的阵列 。 页:1 请注意,零(启动)和夹片的持续时间(结束)需要作为值. |

## 方法

| 名称 | 参数 | 说明 |
| --- | :-: | --- |
| 微秒变化 | 函数(毫升秒) | 每次片段变化一毫秒后调用函数调用 |
| 转到米利秒 | 函数( 毫升秒, 剪接命令 = QQ) | 巫师的功能你可以在剪辑时间线上创造出一段旅程. 剪辑命令接受“ 前面” 和“ 之后” 属性, 例如您可以在行程前暂停剪辑, 并在行程后“ 播放 ” ( 如“ 停止” 和“ 播放 ” 之前的剪辑命令 ” ) |
| 创建循环 | 函数( msStart, msEnd) | 通过这种方法,您可以定义一个带边界的循环。 循环选项必须设置为真实, 才能工作 |
| 更改设置 | 函数( 新选项) | 此功能允许您在初始化后操纵玩家选项. 这里可以使用“ 选项” 一节中提供的所有选项 |
| 更改 InitParams 数据 | 图标对象 | 您可以通过这种方法提供新的值来改变剪辑中的任何初始参数 。 任何在此不会被定义的参数都会与之前的初始参数状态保持不变. |
| 输入FullScreen | \- 说吧 | 您可以使用代码输入全屏模式 |
| 自动退出Screen | \- 说吧 | 您可以使用代码退出全屏模式 |

```javascript
//example using player methods
import MClayer from "@donkeyclip/motorcortex-player";
const player = new MCPlayer({
  clip: MyClip,
  onMillisecondChange: (ms) => console.log("There goes another millisecond. I am gonna live forever"),
});
player.changeSettings({ controls: false, speed: "2", loop: true });
player.createLoop(1000, 3000);
player.changeInitParams({ text: "hello world" });
```

## 主题

### 透明

![Player Controls](https://donkey-spaces.ams3.digitaloceanspaces.com/assets/motorcortex-player/transparent.png?)

### 蓝色

![Player Controls](https://donkey-spaces.ams3.digitaloceanspaces.com/assets/motorcortex-player/blue.png?)

### 绿色

![Player Controls](https://donkey-spaces.ams3.digitaloceanspaces.com/assets/motorcortex-player/green.png?)

### 黄色

![Player Controls](https://donkey-spaces.ams3.digitaloceanspaces.com/assets/motorcortex-player/yellow.png?)

### 阴暗

![Player Controls](https://donkey-spaces.ams3.cdn.digitaloceanspaces.com/assets/motorcortex-player/dark.png?)

### 暗金刚

![Player Controls](https://donkey-spaces.ams3.digitaloceanspaces.com/assets/motorcortex-player/darkGold.png?)

### 白金笔

![Player Controls](https://donkey-spaces.ams3.digitaloceanspaces.com/assets/motorcortex-player/whiteGold.png?)

### 自定义

您只需在属性内定义以下 ass 文本 `themeCSS` 在玩家选项属性主题中使用名称

```javascript
const player = new MCPlayer({
  clip: MyClip,
  themeCSS: `
  .--mc-player.theme-test {
    --activeColor: 136, 136, 500;
    --defaultColor: 136, 136, 136;
    --backgroundColor: 29, 31, 37, 1;
    --loopBarColor: rgba(var(--activeColor), 0.2);
    --grad-display: none;
  }`,
  theme: "theme-test",
});
```

## 驴子剪接查询

所有玩家选项都可以被驴克立普通过查询参数来利用. 任何布尔类型选项都可以启用,而不需要“ true”值。 要禁用默认启用的选项, 您必须设置“ 假” 等值 :

```
https://api.donkeyclip.com/v1/embed/xxxxxxxxxx?controls=false&autoPlay&scaleToFit&theme=yellow&speed=2
```

为了开发目的,您可以使用以下查询参数测试不同的MotorCortex, Player, 和 Bundler 版本:

-   移动
-   玩家转换
-   捆绑转换

例如: `https://api.donkeyclip.com/v1/embed/xxxxxxxxxx?controls&mcversion=7.4.0&playerversion=2.5.0&bundlerversion=7.0.1`

# 捐款

一般来说,我们遵循"叉并拉"的Git工作流程,所以如果要提交补丁和添加,你应该遵循下一步:

1.  **叉头** gitHub 上的重播
2.  **克隆** 工程到您的机器
3.  **提交** 更改您的分支
4.  **推开** 你的工作回到你的叉子上
5.  提交日期: **调取请求** 这样我们就可以回顾一下你的变化

# 发起人:

[![](https://presskit.donkeyclip.com/logos/donkey%20clip%20logo.svg)](https://donkeyclip.com/)

## 常见问题

### @donkeyclip/motorcortex-player 是什么？

MotorCortex 的玩家插件

### 如何安装 @donkeyclip/motorcortex-player？

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

### @donkeyclip/motorcortex-player 支持 TypeScript 吗？

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

### @donkeyclip/motorcortex-player 支持 ESM 还是 CommonJS？

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

### @donkeyclip/motorcortex-player 需要什么版本的 Node\.js？

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

### @donkeyclip/motorcortex-player 可以商用吗？

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

### @donkeyclip/motorcortex-player 的下载量有多少？

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

### @donkeyclip/motorcortex-player 还在维护吗？

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