README.md

quick-media

多媒体处理web服务

mult-media process Web Service by FFMPEG & ImageMagic & SpringMVC

quick-media原理介绍、使用教程、资源模板等相关博文，都可以在专栏 《quick-media | 一灰灰Learning》 获取哦

本项目为一个提供图片 + 音频 + 视频 + 二维码 + 网页 + markdown处理的Web项目，我们的目标是封装一套多媒体文件处理的公共类库，简化各种复杂的调用；利用 spring-boot 来提供http接口实现多媒体的操作实例功能

整理了下QuickMedia的使用与技术文档，可以通过下面的链接进行查看

• http://liuyueyi.gitee.io/quick-media/#/
• https://liuyueyi.github.io/quick-media/#/
• 3.x 系列教程 quick-media | 一灰灰Learning

线上体验地址

• Z+ | web : http://tool.hhui.top

使用说明

目前最新版jar包已提交到maven仓库，因此想直接引入的小伙伴，推荐直接使用下面的中央仓库引入方式（请注意jitpack的包通常来讲更新会更频繁些，而中央仓库的会更稳定些；相同的版本号对应的代码保持一致）

中央仓库引入地址:

• 引入依赖：https://mvnrepository.com/artifact/com.github.liuyueyi.media
• 历史版本：version in mvn repository*

举例如二维码插件的依赖如下即可

<!-- https://mvnrepository.com/artifact/com.github.liuyueyi.media/qrcode-plugin -->
<dependency>
    <groupId>com.github.liuyueyi.media</groupId>
    <artifactId>qrcode-plugin</artifactId>
    <!-- 以中央仓库最新版本为准 -->
</dependency>

---

在下载本项目之后，有些常见事项需要注意一二

• 工程中使用lombok简化大量的代码，因此使用idea的童鞋请装一下lombok的插件(最新版已移除lombok依赖)
• 部分插件依赖第三方库，如 ffmpge, phantomjs, image-magic，请确保已经安装

jitpack使用方式

由于某些原因，导致github访问太慢，无法下载依赖包时，这里也给出了第二种选择方案，借助jitpack仓库，详情使用文档，请查看：quick-media jitpack-仓库导入

一个简单的示例如下:

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>http://jitpack.io</url>
    </repository>
</repositories>


<!-- 请注意groupId和github的方式有一些区别哦 -->
<dependency>
    <groupId>com.github.liuyueyi.quick-media</groupId>
    <artifactId>qrcode-plugin</artifactId>
    <version>3.0.1</version>
</dependency>

I. 项目分析

1. 技术栈

• spring-boot
• ffmpeg
• ImageMagic
• zxing
• batik
• flexmark
• phantomjs
• jhlabs

2. 结构分析

目前项目主要结构区分为web/plugins两个模块，

web

• 根据spring-boot可以迅速搭建一个web服务，提供http接口用于功能测试
• 内部集成了一个简单的web网站，打开: http://media.hhui.top:8089/media/webs 查看
• 使用ReactJS，前后端分离，写了一个更友好的网站，打开: https://zweb.hhui.top/#/index 查看
• 内部实现了小程序【图文小工具】的后端逻辑
• 本项目所有功能，将移植到 一灰灰的神奇小工具

plugins

插件工程，根据不同的场景，支持不同的服务功能，目前将所有的插件抽象出来，可以独立作为工具包提供给第三方依赖，直接引入使用

audio-plugin

提供音频转码服务，使用依赖如下，详细查看: audio-plugin说明

中央仓库导入方式，注意groupId不同(为什么需要改变groupId? 因为上传到maven中央仓库，要求groupId与github的项目所属相同)

<!-- https://mvnrepository.com/artifact/com.github.liuyueyi.media/audio-plugin -->
<!-- 请注意最新报，请直接到maven中央仓库查看，或者到迭代日志中获取 -->
<dependency>
    <groupId>com.github.liuyueyi.media</groupId>
    <artifactId>audio-plugin</artifactId>
</dependency>

date-plugin

提供时间戳、日期转换为农历日期，详细查看：date-plugin说明

<!-- https://mvnrepository.com/artifact/com.github.liuyueyi.media/date-plugin -->
<dependency>
    <groupId>com.github.liuyueyi.media</groupId>
    <artifactId>date-plugin</artifactId>
</dependency>

image-plugin

提供图片合成，提供gif图片生成等图片操作的封装类，详细查看： image-plugin说明

<!-- https://mvnrepository.com/artifact/com.github.liuyueyi.media/image-plugin -->
<dependency>
    <groupId>com.github.liuyueyi.media</groupId>
    <artifactId>image-plugin</artifactId>
</dependency>

markdown-plugin

markdown转html，转图片的封装类， 详细内容查看: markdown-plugin

<!-- https://mvnrepository.com/artifact/com.github.liuyueyi.media/markdown-plugin -->
<dependency>
    <groupId>com.github.liuyueyi.media</groupId>
    <artifactId>markdown-plugin</artifactId>
</dependency>

phantom-plugin

提供根据phantomjs渲染html的封装

<!-- https://mvnrepository.com/artifact/com.github.liuyueyi.media/phantom-plugin -->
<dependency>
    <groupId>com.github.liuyueyi.media</groupId>
    <artifactId>phantom-plugin</artifactId>
</dependency>

qrcode-plugin

提供二维码生成和解析的封装，详细查看: qrcode-plugin使用说明

qrcode使用手册

<!-- https://mvnrepository.com/artifact/com.github.liuyueyi.media/qrcode-plugin -->
<dependency>
    <groupId>com.github.liuyueyi.media</groupId>
    <artifactId>qrcode-plugin</artifactId>
</dependency>

svg-plugin

提供svg文档的渲染，输出图片的封装，详细查看: svg-plugin使用说明

<!-- https://mvnrepository.com/artifact/com.github.liuyueyi.media/svg-core -->
<dependency>
    <groupId>com.github.liuyueyi.media</groupId>
    <artifactId>svg-core</artifactId>
</dependency>

imagic-plugin

基于imagic-magic实现的图片编辑插件封装，详细查看: imagic-plugin使用说明

<!-- https://mvnrepository.com/artifact/com.github.liuyueyi.media/imagic-plugin -->
<dependency>
    <groupId>com.github.liuyueyi.media</groupId>
    <artifactId>imagic-plugin</artifactId>
</dependency>

photo-plugin

相片、图片处理插件，适用于图像的各种处理，如灰度，素描，滤镜等

<!-- https://mvnrepository.com/artifact/com.github.liuyueyi.media/photo-plugin -->
<dependency>
    <groupId>com.github.liuyueyi.media</groupId>
    <artifactId>photo-plugin</artifactId>
</dependency>

II. 已支持服务

1. 音频转码

• 音频不同格式的相互转码

2. 二维码生成 & 解析

• 二维码生成
• 个性二维码生成
  • 支持logo
  • 支持logo样式 （圆角logo， 边框）
  • 支持二维码颜色设置
  • 支持二维码圆角
  • 支持探测图形颜色设置
  • 支持探测图形图片定制
  • 支持背景图
  • 支持背景图圆角设置
  • 支持base64格式的二维码图片
  • 支持二维码定制绘制信息样式
    • 三角形
    • 矩形
    • 小矩形
    • 圆角矩形
    • 五边形
    • 六边形
    • 八边形
    • 五角星
    • 圆
  • 自定义图片, 码元图，背景图，NxM资源图
  • 前置图支持
• 动态二维码生成支持
• 二维码信息解析
• 以下为3.x以上版本新增功能
• 矢量二维码
  • svg矢量二维码
  • 支持logo，logo样式，边框
  • 默认提供的几何样式
    • 三角形
    • 矩形
    • 小矩形
    • 圆角矩形
    • 五边形
    • 五角星
    • 六边形
    • 八遍性
    • 圆
    • 文字
• 支持自定义的渲染扩展
  • 通过实现 IDrawStyle 来实现自定义的渲染样式支持
• 支持模板渲染

2.x 系列教程

查看更多二维码详情

3.x 系列教程

3.x系列教程

最新版本3.0.1，详情查看 迭代日志

给出一个实际生成的case如下:

3. 图片

• 长图文生成
  • 水平文字，上下布局长图文生成
  • 垂直文字，左右布局长图文生成
  • 第三方字体支持
• markdown 转 image
  • markdown 转 html
  • html 转 image
  • 利用phantomjs实现html转image
• gif图生成
• 合成
  • 图片合成支持
• 水印
• svg渲染
• 裁剪
• 压缩
• 旋转
• 缩放
• 灰度化，像素化
• 转字符图
• 位图转矢量图
• 图片自动裁剪
• jpg/png转svg
• 格式转换
• 相片处理
  • 相片转素描

查看更多图片服务详情

4. 图像

• 图像转素描风格

5. 视频相关

• 视频压缩
• 转码
• 截取
• 码率调整
• 生成gif

III. 阶段记录

详情查看: quick-media更新迭代日志

IV. 文档

所有使用以及技术文档，开发过程中一些常见问题汇总，可以点击👉: quick-media文档

问题记录汇总

• 图片旋转不生效问题
• markdonw转图片中文乱码问题
• 兼容ImageIO读取jpeg图片变红
• Batik渲染png图片异常的bug修复

V. 其他

其他

看到下面的star走势图，难道真的没有动心点点🖱小小的👍一下么

联系我

如使用过程中遇到了问题，在查看教程无果之后，请优先提issue，当然也欢迎联系我；

• QQ： 一灰灰/3302797840
• WeChat: 一灰/liuyueyi25

扫描关注

创作不易，你们的支持是我更新的动力

打赏列表

1一分也是❤️，感谢大佬的打赏 (打赏的小伙伴不妨留个备注名)

• datouliang
• *桑
• 坏笑

公众号&博客

打赏码

---

实例演示

0. 应用网站

项目本身提供一个控制台，基于reactjs搭建，在console模块下，启动即可

• http://localhost:8089

使用react.js重构后的前端网站，实现前后端分离，前端网页借助gitee的pages直接部署，测试链接

• gitee静态页面: http://liuyueyi.gitee.io/zweb
• https://zweb.hhui.top/#/index 服务器hold不住，后端逻辑已下线😭

web实际演示图: