@donkeyclip/motorcortex-player

中文文档
2.17.0发布于 2026/05/04MITESM + CJS近 30 天下载 7680

MotorCortex 的玩家插件

中文使用文档
文档目录15 节
  1. 演示
  2. 安装
  3. 导入
  4. 选项
  5. 方法
  6. 主题
  7. 透明
  8. 蓝色
  9. 绿色
  10. 黄色
  11. 阴暗
  12. 暗金刚
  13. 白金笔
  14. 自定义
  15. 驴子剪接查询

摩托计算器

目录

演示

看这里

内部/特征

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

我们的玩家包括什么?

Player Controls Image

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

开始

安装

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

导入

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

创建玩家

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

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

选项

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

选项默认值说明
剪贴板- 说吧玩家将控制的 MotorCortex Clip 对象
显示卷虚假显示或隐藏主音量控制 (# 2)
东道主无效玩家默认的"包装"其容器下方的"剪接"和座位会利用它的全宽. 如果您想要玩家在不同的主机( 元素) 上被渲染, 您可以在此通过此元素
按钮{循环:真,满分:真,设置:真}一个可以选择三个按钮中的哪个对象(# 4: 循环通过密钥"loop", # 5: 设置通过密钥"设置", # 6: 全屏通过密钥"fullScreen"). 通过将对应的密钥设置为真或假来启用并禁用按钮, 因此
时间格式编号此选项允许您设定玩家时间( 第 3) 上的时间单位 。 默认为 ss,这意味着时间将以表单显示: < 已过期秒 > / < 总秒 > 。 如果您想要表格中的表示: ms/ ms 您可以设置此选项为 “ ms ”
主题"透明"您可以在此选择玩家可用的主题之一 。 现有主题有:"透明","蓝色","黄色","绿色","白金","黑暗"和"默认"等
主题CSS- 说吧使用此属性定义自己的主题 . 检查如何定义自定义主题
音量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- 说吧您可以使用代码退出全屏模式
//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

蓝色

Player Controls

绿色

Player Controls

黄色

Player Controls

阴暗

Player Controls

暗金刚

Player Controls

白金笔

Player Controls

自定义

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

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. 提交日期: 调取请求 这样我们就可以回顾一下你的变化

发起人:

版本与发布记录

@donkeyclip/motorcortex-player 共发布 89 个版本,首次发布于 2021/09/23;过去 12 个月发布了 3 个版本。

版本发布日期距今
2.17.0latest2026/05/046 个月前
2.16.12026/05/016 个月前
2.16.02026/04/306 个月前
2.15.182025/10/231.1 年前
2.15.172025/10/231.1 年前
2.15.142025/08/011.3 年前

关于 @donkeyclip/motorcortex-player 的常见问题

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