秀++视频算法仓库-厂家对接规约V5
一、概要
（1）每个算法厂家在秀++云平台上会有一个厂商标识，譬如CS101；算法厂家可能有多个算法引擎，每个引擎有一个标识譬如Q101，引擎可以理解为一个可执行程序，可以同时分析多路算法；每个算法在秀++也有标识，譬如SF101。 这三个标识秀++会和厂商进行分享。
树状图理解：
厂商
--算法引擎
----烟火判断
----安全帽
----XXXX算法
（2）算法引擎会安装在一个载体上，也许在云端，也许在VCELL上。如果在VCELL上,我们也保证VCELL肯定能上互联网。所以算法厂家需做到：
① 引擎连上网以后，要定期同远端厂商自己的云端授权记录做比对，比对不通过就不能运行，更不能进行算法分析。
② 连不上网，引擎可以不工作。
（3）算法引擎和秀++的交互遵循两个原则：
① 算法引擎自己取流去分析。至于用图片还是用视频流甚至切图间隔由算法保证。 vcell或者秀++云端，会将要进行智能分析的对象写成一个全局的配置文件，这个文件路径是固定的，在电脑上的各个算法引擎程序，引擎自己去读这个文件然后按这个文件去获得要分析的是谁，取流的地址（rtsp地址）是什么。请注意，如果切图，也请不要引起磁盘碎片，所以尽量在内存中解决。
② 算法引擎分析后的结果，请http推送给秀++。
二、模拟全流程
（1）秀++向A厂商买了A算法引擎的2个算法，各自2路。
对厂商而言，把这个授权信息放到云端自己的服务器。
（2）秀++授权到1台VCELL上。
① 内部流程1：安装了一套vcell,安装好了那个引擎。
② 内部流程2：秀++云上对vcell进行授权。
（3）客户实际使用vcell,完成对具体通道的绑定。
用vcell的WEB来做算法绑定。配置结束后，vcell 的java生成了一个配置，文件全路径是 C:\Program Files (x86)\sppvcell\algConfig.json，格式如第三章定义。
（4）算法引擎开始工作
说明：
1）判断网络、判断授权。
2）如果一切成立，通过C:\Program Files (x86)\sppvcell\algConfig.json 这个文件来具体知道分析谁，怎么取流等。
3）分析后的结果传出，按第四章定义。
三、algConfig.json 定义
{
"heartBeatUrl": "http://127.0.0.1/event/heartBeat.json",//心跳推送地址
"nodifyUrl": "http://127.0.0.1/event/notify.json",//事件推送地址
"channels": [{
"deviceId": "xxxxx",//设备id
"channelIndex": 1,//通道索引
"csId": "CS101", //厂商ID，不是自己厂商ID的就不要分析了。
"yqId": "YQ101",//引擎ID，不是自己的引擎ID也不要分析了。
"sfId": "SF101",//算法类型ID 例如：未戴安全帽 1、火焰识别 2......
"rtspUrl": "http://xxxx/x/x",//trsp视频流地址
"time1": "10:05-21:05",//最多有4个时间段,每个时间段都是24小时制的，如果是全天分析的，则会是00:00-00:00
"time2": "",
"time3": "",
"time4": ""
}, {
"deviceId": "xxxxx",
"channelIndex": 1,
"csId": "CS101",
"yqId": "YQ101",
"sfId": "SF101",
"rtspUrl": "http://xxxx/x/x",
"time1": "10:05-21:05",
"time2": "",
"time3": "",
"time4": ""
}]
}
四、消息推送格式
1、警情推送：以post 方式推送，utf-8编码格式,json格式，参数如下：
{
“deviceId”:”xxxxx”,
“channelIndex”:1,
“csId”:”cs101”,
“yqId”:”yq101”,
“sfId”:”sf101”,
“type”:1, 事件大类: 1-告警，2-故障
“eventType”:101,事件类型 100, "入侵检测" 101, "徘徊检测" 等详情参考秀加加事件类型
“dateTime”:”2020-11-16 12:12:11”,
“ descripion”:”未戴安全帽”,
“base64File”:”xxxxx” //图片base64 数据
}
2、心跳推送：以post 方式推送，utf-8编码格式,json格式，参数如下：
{
“csId”:”cs101”,
“yqId”:”yq101”
}
--------------------------------------------------------------------------------
秀++视频开放平台（www.showplusplus.cn）专注于音视频信号的接入、管理、分发及AI技术，由杭州美畅物联技术有限公司精心打造，通过提供云、中台、边、旁路、端等一系列产品，完美适配您的各种视频应用和开发的需求。
视频的应用和开发，就找秀++！
