# EasyDarwin（实时数据转换）
EasyDarwin是视频设备数据接入和转换的工具，本章节阐述了集成到DataStoreETL中的EasyDarwin工具的使用说明。
# 环境准备
支持X86架构的64位Linux系统，如Ubuntu 18.x、Centos 7.x。
# 安装配置
- 进入DataStore-ETL安装目录的sources目录，执行解压命令tar -zxvf EasyDarwin-linux-8.1.0.tar.gz。
- 解压完后，修改EasyDarwin-linux-8.1.0文件夹权限为777。如下图：
- 进入安装目录下的sources/EasyDarwin-linux-8.1.0目录下，编辑easydarwin.ini文件。
支持配置端口（Web站点、RTSP服务）、是否缓存（save_stream_to_local）等配置
提示：
默认会缓存到sources/EasyDarwin-linux-8.1.0/cache目录下，供实时和近历史调阅，目前客户端推流不能断，若断了，则会覆盖历史文件；且缓存数据会比较大，一个视频流服务1秒需要大约1～1.5M磁盘空间，需注意磁盘空间；
- 进入安装目录下的sources/EasyDarwin-linux-8.1.0目录下，执行sh start.sh。
- 进入Web站点，能看到如下界面，则说明启动成功。
- 进入安装目录下的sources/EasyDarwin-linux-8.1.0目录下，执行sh stop.sh，Web站点访问不了，则说明关闭成功。
# 配置示例
# 推流工具
# 视频文件推RTSP流（linux）
进入安装目录下的sources/EasyDarwin-linux-8.1.0目录下，执行sh tools/video2rtsp.sh ../video/video1.MP4 rtsp://192.168.91.123:10554/video4 脚本，其中参数1为mp4文件路径，参数2为rtsp服务URL，则可将给定路径视频文件作为视频流推送到rtsp服务器；
若使用示例数据，则可简化为sh tools/video2rtsp_sample.sh bigdata脚本，则可将tools目录下的bigdata.mp4文件作为视频流，循环推送到rtsp服务器，其中bigdata为流服务名，可自行修改；
若需要推送到远程服务器，也可以指定RTSP服务信息，如下：
输入地址 http://{ip}:10008 ，进入Web站点，可以看到视频流服务。
# 视频文件推RTSP流（windows）
在CMD中执行sources\EasyDarwin-linux-8.1.0\tools目录下的video2rtsp.bat脚本，给{视频文件路径}、{服务名} 参数。如图：
若使用示例数据，在CMD中执行\sources\EasyDarwin-linux-8.1.0\tools目录下的video2rtsp_sample.bat脚本，给{服务名} 参数，即可在windows下推送视频流。
# 摄像头推RTSP流（linux）
进入安装目录下的sources/EasyDarwin-linux-8.1.0目录下，执行
sh tools/camera2rtsp.sh camera脚本，则可将本地摄像头作为视频流，循环推送到rtsp服务器，其中camera为流服务名，可自行修改；
提示：
摄像头推流可能会有大约5～10秒的延迟；
若需要推送到远程服务器，也可以指定RTSP服务信息，如下
输入地址 http://{ip}:10008 ，进入Web站点，可以看到视频流服务
# 摄像头推RTSP流（windows）
打开设备管理器，找到对应的摄像头设备及设备名称，如下图
在CMD中执行sources\EasyDarwin-linux-8.1.0\tools目录下的camera2rtsp.bat脚本，给{设备名称}、{服务名} 参数，设备名称用双引号括起
执行完后能在easydarwin管理站点中看到推流服务列表
# 客户端
# 桌面端
桌面端软件可使用RTSP（TCP）流服务地址进行播放，安装支持RTSP网络视频流的桌面软件，如VLC等，在Web站点中复制视频流地址，点击确认，即可直接播放。
# Web端
Web端无法直接连接RTSP（TCP）的服务，需要采用基于Web的播放协议，常见的有Http-mp4. HLS、http-flv、webrtc等，该软件支持HLS协议的Web服务，注意需要开启缓存。视频流Web服务地址格式为：
http://[host]:[port]/record/[服务名]/[日期]/out.m3u8
其中，port：默认为10008
服务名：视频流服务名称，如camera01
日期：年月日格式，如20211220