easyCV

  Video recorder and snapshot(video image capture) library,based on javaCPP & javaCV & FFmpeg. 
  基于javaCV的跨平台视频录像和快照(视频截图)库，开箱即用。

Update

2019年12月2日
1、本次更新主要针对videoRecorder工作线程在特定情况下（异常）出现无法回收的bug

2019年7月22日
1、新增BufferGrabber和BufferedImageGrabber的连续截图语法糖
2、截图库不再依赖javaCV

2019年7月17日b
1、增加连续截图功能，目前只限通过BytesGrabber进行连续截图
1.1、连续截图提供视频源地址、截图总数、间隔（隔几帧）
1.2、简单测试了连续截图功能暂时未发现问题，近期将实现其他接口的连续截图功能语法糖
2、代码结构调整，抽象出一个桥接接口Grabber，用于方便不同接口实现能够对像素格式进行不同方式的操作

2019年7月17日a
1、调整了截图库代码结构
2、向下兼容老版本，但不再推荐使用原有的调用方式
3、新增了一个图像像素数据字节数组抓取器(BytesGrabber)，它能够获得图像的像素数组
4、新增了一个Base64图像编码数据抓取器（Base64Grabber），用于取代原来的调用方式
5、重新根据ffmpeg4.x最新解码库api实现视频解码流程，支持B、P帧解码，与原有代码不兼容，所以新创建新的FFmpeg4VideoImageGrabber以示区别
6、推荐的使用方式是
`
//可以通过BufferedImageGrabber直接截取得到java图像
BufferedImageGrabber grabber=new FFmpeg4VideoImageGrabber();
//可以通过Base64Grabber轻松截取base64图像编码数据
Base64Grabber grabber=new FFmpeg4VideoImageGrabber();
//可以通过BufferGrabber获取截图图像的缓冲数据
BufferGrabber grabber =new FFmpeg4VideoImageGrabber();
//可以通过BytesGrabber获取截图图像的像素数组数据
BytesGrabber grabber=new FFmpeg4VideoImageGrabber();
`
根据需要自行调用和管理，本项目只提供可靠的截图库，而不是大而全的框架。

Use samples

目前除了Base64Grabber之外其他Grabber都实现了连续截图api

	//可以通过BufferedImageGrabber直接截取得到java图像
	BufferedImageGrabber grabber=new FFmpeg4VideoImageGrabber();
	//可以通过Base64Grabber轻松截取base64图像编码数据
	Base64Grabber grabber=new FFmpeg4VideoImageGrabber();
	//可以通过BufferGrabber获取截图图像的缓冲数据
	BufferGrabber grabber =new FFmpeg4VideoImageGrabber();
	//可以通过BytesGrabber获取截图图像的像素数组数据
	BytesGrabber grabber=new FFmpeg4VideoImageGrabber();

Online demo

1、截图服务在线演示：http://eguid.cc/screenshot/test

2、录像服务在线演示：http://eguid.cc/videorecord/test

   可以通过http://eguid.cc/screenshot/查看历史截图列表
   同样可以通过http://eguid.cc/videorecord/查看历史录像列表并进行点播观看

Dependency library

  Corelib based on 'javaCPP 1.4.X' & 'javaCPP-FFMPEG-1.4.x' & 'javacv 1.4.x',exaples based on 'spring-boot 2.x'.

Build

  Based on jdk1.8,build on maven 3.7.

About core library

  核心库提供截图快照和视频录像两套API，exaples中提供了几个演示示例，分别依赖录像和截图corelib

Examples project description

提供了几个springboot演示服务demo，截图服务演示demo默认使用8081端口，录像服务使用8082端口。
其中截图功能支持保存成文件和返回base64两种方式获取截图。
截图文件与录像文件都需要额外配合一个单独http/ftp服务才能进行访问
录像服务演示demo除了需要指定保存路径外，与截图服务相同，我们一般把录像文件存放到http/ftp服务的根目录下，方便点播，推荐使用nginx、apache和iis）。
demo中涉及到截图和录像信息的表结构都是简单的单表，这里就不提供了，直接查看*Mapper.xml文件即可

Format of video&Image support

Video source support rtsp/rtmp/flv/hls/file formats,Record video file support mp4/flv/mkv/avi .... formats.
Image file support jpg/png/jpeg/gif/bmp.
视频源支持rtsp/rtmp/flv/hls/视频文件等多种格式。
录像文件可以支持mp4/flv/mkv/avi等多种视频格式。
视频快照（视频截图）支持jpg/png/jpeg/gif/bmp等图片格式，常见的格式基本都支持。