Skip to content

pecasha/eagle-plugin-alpha-video-format-extension

Repository files navigation

Eagle-Plugin-Alpha-MP4-Format-Extension

Eagle MP4 透明格式扩展插件

开发

安装依赖

pnpm i # npm i

打包编译

测试

pnpm run build:test # npm run build:test

正式

pnpm run build:prod # npm run build:prod

项目结构

  1. 项目根目录中的文件只是项目开发配置或编译配置。
  2. 所有的插件代码、插件配置、资源文件均在/src/目录中。
  3. 插件核心代码均封装在/src/core/目录中,使用TypeScript语法及ES Module标准进行编写,可以使用NPM依赖包。
  4. 插件业务代码在/src/plugin/目录中(此处的代码文件结构均遵循Eagle官方的开发文档标准,关于Eagle插件官方提供的标准及文件结构,可以查看 Eagle Plugin API ),使用JavaScript语法及CommonJS标准进行编写,不建议在此处引用NPM依赖包,此处的thumbnailviewer代码只对页面DOM视图进行操作,其它任何操作都封装至/src/core/核心代码,通过实例化后调用。
  5. 在编译时会先用Rollup/src/core/中的代码打包为单独的模块,并且合并为一个单独的cjs文件以供/src/plugin/中引用(所以要在/src/core/index.ts中将所有需要给/src/plugin/调用的类或方法导出),之后会使用Gulp/src/plugin/中的插件基本业务代码以及资源文件进行压缩合并,输出至/dist/文件夹中。

调试

  • 将本项目打包编译后,在Eagle中按P键打开插件面板,点击开发者选项-导入本地项目,选择本插件根目录中编译后的dist文件夹路径,在插件列表中将会出现MP4 透明格式扩展
  • 将透明视频文件导入到Eagle中,双击打开即可进行直接预览。
  • 如需使用开发工具调试或查看console日志,在Eagle中单击选中需要调试的透明视频文件,然后按P键打开插件面板,点击插件列表中的MP4 透明格式扩展,会在新窗口中出现预览,此时在新窗口中按F12键,即可打开Chrome Dev Tools开发工具。

说明

  • 最终编译输出至/dist/目录中的文件是可供Eagle插件系统本地调试使用的完整文件包。如需发布生成.eagleplugin格式的Eagle 插件包文件,可先按照 [调试] 中的方式将本地插件导入到Eagle中,之后在插件列表中点击MP4 透明格式扩展右侧的,选择打包插件即可。
  • 关于插件开发或Eagle相关问题,可前往 Eagle 插件开发群 进行交流或反馈。
  • 插件是基于YYEVA(YY Effect Video Animate)项目开发的,前往YYEVA官网
  • 因为YYEVA的支持,所以插件能够同时支持VAPAFX的透明视频。
  • 因为.mp4的文件扩展名会跟正常的视频文件混淆,所以需要将文件扩展名改为.eva.vap.afx才可使用插件预览。
  • 关于VAP(Video Animation Player)点击查看
  • 关于AFX 透明视频点击查看
  • 因为相同的原理,所以插件也能够支持字节跳动AlphaPlayer的透明视频格式,但是您需要将视频扩展名修改为.eva才可使用插件预览。关于AlphaPlayer点击查看