秀++视频算法仓库-厂家对接规约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技术，由杭州美畅物联技术有限公司精心打造，通过提供云、中台、边、旁路、端等一系列产品，完美适配您的各种视频应用和开发的需求。

视频的应用和开发，就找秀++！