JT-T-1353-2020交通运输视频交换技术要求

ICS35.240.60L70中华人民共和国交通运输行业标准JT/T1353—2020交通运输视频交换技术要求2020-12-30发布2021-03-01实施中华人民共和国交通运输部发布ⅠJT/T1353—2020前言 2规范性引用文件 4总体要求 5交换协议 5.2协议规则 6安全要求 6.2安全隔离要求 6.3协议安全要求 6.4内容安全要求 附录A(规范性附录)资源参数 附录B(规范性附录)格式代码定义 附录C(规范性附录)REST模型 附录D(资料性附录)消息示例 参考文献 ⅡJT/T1353—2020请注意本文件的某些内容可能涉及专利,本文件的发布机构不承担识别这些专利的责任。本标准由交通运输信息通信及导航标准化技术委员会提出并归口。本标准起草单位:浙江省交通信息中心、浙江科技学院、浙江宇视科技有限公司、杭州海康威视数字交通运输视频交换技术要求本标准规定了交通运输视频资源交换的总体要求、交换协议和安全要求。本标准适用于交通运输视频资源的交换与共享。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T7408—2005数据元和交换格式信息交换日期和时间表示法GB/T22239—2019信息安全技术网络安全等级保护基本要求GB/T32917信息安全技术WEB应用防火墙安全技术要求与测试评价方法GA/T16.4道路交通管理信息代码第4部分:机动车车辆类型代码GA/T16.7道路交通管理信息代码第7部分:机动车号牌种类代码GA/T16.8道路交通管理信息代码第8部分:机动车车身颜色代码GA/T16.31道路交通管理信息代码第31部分:交通违法行为类别代码GA/T16.105道路交通管理信息代码第105部分:道路交通能见度代码JT/T697.1—2013交通信息基础数据元第1部分:总则JT/T697.5—2013交通信息基础数据元第5部分:船舶信息基础数据元(UCS)]ISO/IEC13818-7信息技术运动图像和相关音频信息的通用编码第7部分:高级音频编码2JT/T1353—2020ing(HEVC)]下列术语和定义适用于本文件。设备和系统提供的音视频、图像、属性数据和视频内容结构化数据等信息的总称。通过网络互联实现视频资源提供方与资源请求方之间视频资源交互的过程。视频交换系统中通过网络按一定规则实现视频资源交换的逻辑体。视频交换系统中具有集中接收和转发视频资源的逻辑体。以视频资源、视频平台、用户终端等作为归集对象的逻以视频交换单元、资源中心等作为归集对象的逻辑域。在视频交换协议实现过程中针对视频资源主动发出视频资源查询、订阅等服务请求的逻辑体。在视频交换协议实现过程中针对视频资源的查询、订阅等服务请求进行响应的逻辑体。下列缩略语适用于本文件。3JT/T1353—20204总体要求交通运输视频资源交换应用场景包括但不限于:a)综合交通监管视频资源交换[图1a)]:适用于铁路、公路、水路、城市道路、城市客运(含公共汽电车、城市轨道交通等)及重点监管车辆等多种视频应用,其特征是根据需要在交通基层监管部门进行交换,满足逐级上联、分层交换与分层使用的要求;b)多业主交通枢纽视频资源交换[图1b)]:适用于铁路、公路、水路、航空等多种运输方式转运枢纽与多业主道路互通枢纽的视频资源交换,其特征是同一交通枢纽处,分属不同业主方的视频资源进行对等交换,满足局部区域视频交互共享的要求;c)跨区域分段运输视频资源交换[图1c)]:适用于跨区域分段物流运输的接续视频资源交换,其特征是各段视频资源按顺序两两交换,满足跨区域视频资源交互共享的要求;d)运载工具间视频资源交换[图1d)]:适用于交通运载工具之间的视频资源交换,其特征是运载工具组队时视频资源在小范围内交互共享,满足运载工具间协同感知的要求。4JT/T1353—2020图1交通运输视频资源交换应用场景资源属性包含基础属性(见附录A的A.1)、媒体属性(见A.2)和结构化属性(见A.3)。视频交换域内交互的视频编码格式应符合ITU-TRec.H.264或ITU-TRec.H.265的要求,视频格式代码见表B.1。视频交换域内交互的音频编码格式应符合ITU-TRec.G.711、ITU-TRec.G.729、ISO/IEC13818-7的要求,音视频图像质量要求如下:a)视频图像质量主观评价不应低于GB50198—2011规定的评分分级4;b)图像峰值信噪比不应小于35dB。结构化数据是对视频图像内容进行结构化分析产生的结果数据及附加信息。交通运输结构化数据包含交通运载工具数据(见A.7和A.8)、交通事件数据(见A.9)、交通流量数据(见A.10)、货运物流数据(见A.11)、客流数据(见A.12)、交通运行环境数据(见A.13)等。4.3视频交换域视频交换域包含交换各方的视频交换单元、视频资源中心和数字传输网络。各视频交换单元应能通过传输网络实现视频资源域间的对等互联,满足交通运输行业内部跨层级、跨行业视频资源的交换需求和交通运输行业外视频资源的交换需求。视频交换域结构见图2。4.3.2视频交换单元视频交换单元具有媒体流转码与分发、结构化数据共享与交互信令授权认证等逻辑组件,应能将本视频资源域的视频资源属性、媒体流、结构化数据共享给其他视频交换单元,也能接收其他视频交换单元的共享资源。视频交换单元的逻辑结构见图3。5JT/T1353—2020图2视频交换域结构图3视频交换单元的逻辑结构功能要求视频交换单元的功能要求如下:a)应支持多交换单元互联;b)应具有授权管理功能;c)应能按照A.4的能力参数进行配置,并具有软硬件负荷监测和状态查询等功能;d)当交换单元设备变更后,交换单元编码应保持不变;e)宜具有UTC时间转换功能;f)应支持按照5.1规定的传输协议和数据封装格式进行数据双向交换;g)应支持将不符合4.2.2规定的媒体流进行转码;h)宜支持对媒体流进行分发。6JT/T1353—2020性能要求视频交换单元性能应满足:a)支持接入视频资源数量不少于4路;c)媒体流并发处理总码流不小于16Mb/s。4.3.3视频资源中心视频资源中心应具有媒体流分发、结构化数据共享、交互信令授权认证、资源调度管理等逻辑组件,能接收视频交换单元的视频资源和交换请求,集中处理服务响应。视频资源中心的逻辑结构见图4。图4视频资源中心逻辑结构功能要求视频资源中心除传输协议、数据封装格式、媒体流转码及能力参数配置等功能与视频交换单元一致,还具有如下功能:a)支持视频资源的分发;b)具有授权管理功能;c)获取其他资源中心的能力与运行状态信息;d)获取视频交换单元的能力与运行状态信息;e)具有系统参数配置管理、软硬件负荷监测和状态查询等功能。性能要求资源中心应满足如下实际视频交换的需求:a)支持不少于64个视频交换单元的管理;b)媒体分发服务的并发分发总码流不小于512Mb/s。交换路径是视频资源域内交换视频资源的路径。视频交换单元应能从视频交换单元或资源中心获取视频资源。交换路径包括以下两种:a)静态交换路径:根据预先设定的规则获取视频资源的固定路径;b)动态交换路径:在预先设定多条交换路径基础上,根据网络与视频质量状态,按照预定策略自动调整获取视频资源的路径。7JT/T1353—2020资源请求方应向资源提供方请求资源权限,资源提供方审批授权后,将所拥有的视频交换单元地址与账户信息提供给资源请求方。资源请求方按授权信息进行交换单元参数配置。双方应按照第5章的规定进行资源交换。4.4.3视频交换基础网络传输性能视频交换基础网络传输性能应满足以下要求:a)网络时延上限值为400ms;b)时延抖动上限值为50ms;5交换协议交通运输视频资源交换协议结构见图5。图5交换协议结构交通运输视频资源属性、结构化数据、交互信令应采用基于HTTP/HTTPS的REST方式进行传输,REST模型见附录C。媒体流应采用IETFRFC3550的RT传输与控制,音频随视频流同步传输,RTP的负载应符合IETFRFC3984和IETFRFC7798规定的格式。交通运输视频交换协议的消息体应采用JSON格式进行描述。协议中的字符应采用符合ISO/IEC8JT/T1353—2020URI格式定义:/根/操作类型/操作对象。其中:a)根:固定为VRS;b)操作类型:表示URI针对操作对象实现的具体操作,见表1;c)操作对象:表示URI需要访问操作的对象,资源对象见表2,视频结构化对象见表3。示例:查询资源列表的URI为:/VRS/Query/ResList。操作名称操作含义查询订阅取消订阅推送撤销对象名称对象含义交换单元信息资源节点列表资源节点信息实时视频流云台控制历史视频记录历史播放链接心跳信息系统事件表3视频结构化对象对象名称对象含义车辆信息(运载工具)船舶信息(运载工具)火车信息(运载工具)飞机信息(运载工具)9JT/T1353—2020表3(续)对象名称对象含义交通事件信息交通流量信息集装箱信息(货运物流)客流信息交通能见度信息(交通运行环境)资源列表资源按照URI定义格式应实现的接口形成列表,包括URI格式、说明和约束条件,资源列表见表4。URI格式说明约束条件视频资源信息查询R资源列表获取R资源详细信息查询R资源推送O取消资源共享O调用实时视频流R实时视频流调用拆除R历史视频记录查询R历史视频播放链接查询R系统事件上报O云台控制O心跳保活O车辆结构化信息订阅O取消车辆结构化信息订阅O船舶结构化信息订阅O取消船舶结构化信息订阅O火车结构化信息订阅O取消火车结构化信息订阅O飞机结构化信息订阅O取消飞机结构化信息订阅O车流量结构化信息订阅O取消车流量结构化信息订阅O集装箱结构化信息订阅O取消集装箱结构化信息订阅OJT/T1353—2020表4(续)URI格式说明约束条件交通事件结构化信息订阅O取消交通事件结构化信息订阅O客流量结构化信息订阅O取消客流量结构化信息订阅O道路交通能见度结构化信息订阅O取消道路交通能见度结构化信息订阅O返回消息说明述见表5,消息示例参见附录D。表5返回消息字段描述返回值字段字段格式字段描述返回值,0表示正常,其他表示失败,返回值见B.7具体错误描述,OK为正常,其他错误码均带有详细的错误信息,长度不超过256字节假如存在返回的数据,则通过Result字段携带,具体格式见接口定义;假如不存在返回数据,则不存在Result字段5.2.3通用交互流程式见5.2.2.3。通用交互流程见图6,返回值见B.7。图6通用交互流程JT/T1353—2020资源请求方应通过资源提供方的授权认证才能获取相应的服务,每次请求消息中均应携带认证信息。当无认证信息或认证失败时,返回401错误;当认证通过时,请求会被响应。三种授权认证情况的流程见图7。图7三种授权认证情况的流程资源请求方每次请求服务时,HTTP请求消息的头域均应包含Authorization字段,定义如下:其中:d)Nonce:16字节长度的随机数,用16进制字符串表示;为防止攻击者发送一个目的主机已接收过的数据包欺骗系统,认证过程宜实现:a)资源提供方验证资源请求方发送的timestamp字段,当收到的tim值超过设置上限值,则认为请求非法,认证不通过;上限值建议5min;b)在时限范围内,资源提供方应保存Nonce值,当再次收到同样的Nonce值时,认证不通过。5.3.2视频资源信息查询获取视频交换单元与视频资源中心的能力集和当前状态,信息查询流程见5.2.3的通用交互流程。JT/T1353—2020接口说明视频交换单元或视频资源中心信息查询接口说明见表6。表6视频资源中心信息查询接口说明项目描述接口名称请求方式请求参数无返回参数消息示例参见D.1通过此接口实现从视频交换单元或视频资源中心获取已授权的资源列表。通用交互流程见接口说明资源列表获取接口说明见表7。表7资源列表获取接口说明项目描述接口名称请求方式请求参数无返回参数ResourceList,资源列表为视频资源基础属性的集合,视频资源基础属性见A.1消息示例参见D.25.3.4资源详细信息查询交换单元在获取到视频资源列表后,根据列表中的视频资源编码查询具体信息。交互流程见接口说明资源详细信息查询接口说明见表8。表8资源详细信息查询接口说明项目描述接口名称请求方式请求参数JT/T1353—2020表8(续)项目描述返回参数ResInfo,资源的详细信息,包含“视频资源基础属性”“视频资源媒体属性”和消息示例交换单元将所拥有的视频资源主动推送至指定的资源中心。交互流程见5.2.3。接口说明资源推送交互接口说明见表9。表9资源推送交互接口说明项目描述接口名称请求方式请求参数ResourceList,资源列表为视频资源基础属性的集合,视频资源基础属性见A.1返回参数无消息示例参见D.4视频交换单元通知资源中心取消已共享的视频资源权限。交互流程见5.2.3。接口说明取消资源共享交互接口说明见表10。表10取消资源共享交互接口说明项目描述接口名称请求方式DELETE请求参数返回参数无消息示例参见D.55.3.7调用实时视频流资源请求方向资源提供方请求指定视频资源的实时视频流。调用流程见图8。JT/T1353—2020图8实时视频流调用流程信令流程描述如下:a)资源请求方向资源提供方发送调用实时视频流请求;b)资源提供方根据资源请求方的请求和权限,返回响应消息;c)在请求成功的情况下,资源提供方向资源请求方发送实时视频流。接口说明实时视频流调用接口说明见表11。表11实时视频流调用接口说明项目描述接口名称请求方式请求参数返回参数消息示例参见D.65.3.8实时视频流调用拆除结束当前正在进行的实时视频流调用。交互流程见5.2.3。信令流程描述如下:a)资源请求方向资源提供方发送实时视频流调用拆除请求;b)资源提供方根据资源请求方的请求和权限,返回响应结果;c)在请求成功的情况下,资源提供方停止向资源请求方发送实时视频流。接口说明实时视频流调用拆除接口说明见表12。JT/T1353—2020表12实时视频流调用拆除接口说明项目描述接口名称请求方式DELETE请求参数返回参数无消息示例参见D.75.3.9历史视频记录查询根据视频资源编码和时间段查询历史视频记录,返回对应视频资源在指定时间段内的历史视频记接口说明历史视频记录查询接口说明见表13。表13历史视频记录查询接口说明项目描述接口名称请求方式请求参数返回参数消息示例参见D.85.3.10历史视频播放链接查询根据5.3.9的返回结果查询历史视频播放链接,返回对应历史视频记录的RTSP链接。通用交互历史视频播放链接查询接口说明见表14。表14历史视频播放链接查询接口说明项目描述接口名称请求方式请求参数返回参数RTSP_URL消息示例参见D.9JT/T1353—2020订阅指定视频资源的结构化信息或系统事件信息。信息订阅流程见图9。图9信息订阅流程信息订阅接口说明见表15。表15信息订阅接口说明项目描述接口名称请求方式请求参数返回参数无消息示例参见D.10,其中StructInfo为代表结构化信息,其定义见表3取消订阅指定视频资源的结构化信息或系统事件信息,若之前未订阅,则返回成功。通用交互流程取消结构化信息订阅接口说明见表16。JT/T1353—2020表16取消结构化信息订阅接口说明项目描述接口名称请求方式DELETE请求参数返回参数无消息示例参见D.11,其中StructInfo为具体结构化信息,具体见表3实现视频资源的云台控制,云台控制主要包括资源的云台、镜头等控制,要求如下:b)镜头控制宜具备镜头变倍、聚焦和光圈调整功能;c)应支持雨刷和辅助灯光等外设控制。通用交互流程见5.2.3。云台控制接口说明见表17。表17云台控制接口说明项目描述接口名称请求方式请求参数返回参数无消息示例由资源请求方向资源提供方发起心跳请求,默认间隔为30s。资源提供方连续3个周期未收到请求消息,则判断为资源请求方已离线;资源请求方连续3个周期未收到请求响应消息,则判断资源提供方已离线。心跳保活接口说明见表18。表18心跳保活接口说明项目描述接口名称请求方式JT/T1353—2020表18(续)项目描述请求参数无返回参数无消息示例由资源请求方向资源提供方订阅资源提供方的系统事件,资源提供方根据订阅需求,把设备和系统类告警推送给资源请求方。订阅系统事件接口说明见表19。表19订阅系统事件接口说明项目描述接口名称请求方式请求参数返回参数无消息示例取消之前订阅的系统事件,假如之前未订阅,则直接返回成功。取消系统事件订阅接口说明见表20。表20取消系统事件订阅接口说明项目描述接口名称请求方式DELETE请求参数返回参数无消息示例6安全要求交通运输视频交换网络(系统)应达到GB/T22239—2019规定的二级及以上网络安全等级保护JT/T1353—2020要求。6.2安全隔离要求交通运输视频交换网络(系统)应在行业内部交换接入、外部交换接入等专用网络边界处部署防火墙设备。防火墙设备应满足所属网络安全等级中安全功能要求所涉及的基础安全技术要求、安全功能技术要求和安全保证技术要求,具体应符合GB/T32917的要求。交通运输视频交换网络(系统)应在行业内部与外部交换中针对社会公众等公共网络边界处部署视频网闸设备。视频网闸设备应满足所属网络安全等级中安全功能要求所涉及的基础安全技术要求、安全功能技术要求和安全保证技术要求。6.3协议安全要求交通运输视频交换网络(系统)应能实现系统控制信令和视频流的安全管理,要求如下:a)支持视频信令格式检查及内容过滤,能识别视频控制信令、视频传输协议,阻断未注册的协议和数据格式;b)支持系统控制信令完全解析及内容白名单级别过滤控制;c)支持媒体信息流编码格式识别,防止通过媒体传输通道传输恶意数据;d)支持视频数据和控制信令的双向/单向传输模式,并能对视频数据与控制信令严格区分,分别处理后进行传输;e)交通运输视频交换宜支持视频数据实时检测,有效阻断夹杂恶意代码的视频数据。6.4内容安全要求交通运输视频交换网络(系统)应采用数字摘要、数字时间戳,宜采用数字水印、视频加扰等信息安全防护技术。JT/T1353—2020(规范性附录)资源参数A.1视频资源基础属性表A.1视频资源基础属性字段字段类型约束条件字段说明R视频资源编码,交换单元编码标识VXida+IDbR视频资源名称O视频资源所处位置的纬度,应采用2000国家大地坐标系O视频资源所处位置的经度,应采用2000国家大地坐标系O视频资源所处位置的海拔R视频资源类型代码,详见B.12R视频资源状态,详见B.13O视频资源所属交通行业的类别,见JT/T697.1—2013的表2cR视频资源描述O水平角度O垂直角度O放大倍数R资源有效期,超过有效期资源将不可用,需要重新推送,格—Part1:为接入视频资源的视频交换单元的MAC地址,用16位16进制表示。—Part2:为视频交换单元生成VXid时的从1970年开始的秒数,用8位16进制表示。—Part3:为视频交换单元生成VXid时的微秒数,用3位16进制表示。bID为视频资源域内的视频资源唯一编号。—“|”为层级分隔符,西文半角形式表示。—层级排序按从左至右顺序,依次为从高到低,aaa、bbb、ccc为层级目录,aaa为最高层层级描述,ccc为最低层层级描述。—描述信息可为多条,中间以逗号分隔。A.2视频资源媒体属性视频资源的媒体属性,即具有的媒体传输样式集合,包括视频编码格式、音频编码格式、媒体分装格JT/T1353—2020表A.2资源媒体属性字段字段类型约束条件字段说明R视频资源支持的视频编码格式范围,详见B.1R视频资源支持的音频编码格式,详见B.2R视频资源支持的视频码率范围,详见B.3R视频资源支持的码流封装格式,详见B.4R视频资源支持的视频发流模式,详见B.5R整数数组,每个整数表示资源支持的帧率模式R视频资源支持的视频分辨率,详见B.6A.3视频资源结构化属性视频资源结构化属性是视频资源具备的视频结构化内容,见表A.3。表A.3视频资源结构化属性字段字段类型约束条件字段说明O是否支持车辆识别,false表示不支持,true表示支持O是否支持飞机识别,false表示不支持,true表示支持O是否支持火车识别,false表示不支持,true表示支持O是否支持船舶识别,false表示不支持,true表示支持O是否支持交通事件识别,false表示不支持,true表示支持O是否支持交通流量检测,false表示不支持,true表示支持O是否支持集装箱信息识别,false表示不支持,true表示支持O是否支持客流量检测,false表示不支持,true表示支持O是否支持交通能见度识别,false表示不支持,true表示支持A.4视频交换单元能力参数视频交换单元的能力参数包括其支持的视音频编码格式、当前负载情况、最大转码分发路数等,视频资源中心能力参数与视频交换单元内容一致,采用统一字段描述,见表A.4。JT/T1353—2020表A.4视频交换单元能力参数字段字段类型约束条件字段说明VXidR视频交换单元编码标识R支持的视频解码格式,详见B.1R支持的音频解码格式,详见B.2R支持的视频编码格式,详见B.1R支持的音频编码格式,详见B.2RR交换单元最大支持的视频转码路数R当前的视频转码路数R交换单元最大能支持的视频分发路数R当前的视频分发路数R交换单元最大能支持的结构化信息转发路数R当前的结构化信息转发路数R最大接收带宽R最大发送带宽RRR交换单元状态,详见B.8O视频交换单元所属行业O视频交换单元名称O视频交换单元描述信息R视频交换单元所属时区A.5请求媒体参数请求媒体参数,即资源请求方要求资源提供方发送的媒体流参数,包含视频编码格式、音频编码格字段字段类型约束条件字段说明R视频资源编码O码流编码类型,详见B.1JT/T1353—2020表A.5(续)字段字段类型约束条件字段说明O音频编码格式,详见B.2O码流封装格式,详见B.4R收流端IP地址R收流端端口R发流模式,详见B.5O要求的视频分辨率,详见B.6A.6响应媒体参数响应媒体参数,即资源提供方即将响应提供的流媒体参数信息,包括视频编码格式、音频编码格式、表A.6响应媒体参数返回值字段字段类型约束条件字段说明R视频资源编码R视频编码格式,详见B.1R音频编码格式,详见B.2O码率,详见B.3O码流封装类型,详见B.4R发流端IP地址R发流端端口R码流传输模式,详见B.5O视频资源支持的视频分辨率,详见B.6A.7车辆结构化字段说明视频资源中与车辆相关的结构化字段说明,见表A.7。表A.7车辆结构化属性字段名称字段类型约束条件字段说明R号牌号码O号牌颜色代码,详见GA/T16.7O车辆类型代码,详见GA/T16.4O车身颜色代码,详见GA/T16.8O车长,单位为厘米(cm)JT/T1353—2020表A.7(续)字段名称字段类型约束条件字段说明O车宽,单位为厘米(cm)O车高,单位为厘米(cm)R抓拍的车辆图片,为若干http图片链接RO车辆状态,0表示正常,其余表示交通违法状态,见O车辆行驶速度,单位为千米每小时(km/h)A.8船舶结构化字段说明视频资源中与船舶相关的结构化字段说明,见表A.8。表A.8船舶结构化属性字段名称字段类型约束条件字段说明RO船舶名称O船舶呼号R船舶类型,参考AIS标准协议说明O船舶尺寸,单位为米(m)O船舶目的地O船舶实时经度O船舶实时纬度O船舶高度,单位为米(m)O船舶宽度,单位为米(m)O0-正常,1-超速,2-逆行,3-超高,4-逆行O抓拍点位置OO船速,单位为节(kn)O船舶航行方向RO船舶抓拍图片列表A.9交通事件结构化字段说明视频资源中与交通事件相关的字段说明,见表A.9。JT/T1353—2020字段名称字段类型约束条件字段说明R路口编号O事件发生车道号R交通事件时间R交通事件类型,见表B.9O事件图片URLA.10车流量统计结果字段说明视频资源中与车流量统计结果相关的字段说明,见表A.10。表A.10车流量统计结果字段名称字段类型约束条件字段说明R路口编号O车道号RR统计时间,单位为秒(s)O平均车速,单位为千米每小时(km/h)O车头时距,单位为秒(s)O车头间距,单位为米(m)O车道占有率,百分比计算,浮点数×1000O时间占有率,百分比计算,浮点数×1000O小型车数量,无此数据,则无此字段O中型车数量,无此数据,则无此字段O重型车数量,无此数据,则无此字段A.11集装箱结构化字段说明视频资源中与集装箱相关的结构化字段说明,见表A.11。表A.11集装箱结构化属性字段名称字段类型约束条件字段说明R集装箱号RO桥吊号O装卸车道号JT/T1353—2020表A.11(续)字段名称字段类型约束条件字段说明R装卸集装箱的车辆号牌O装卸集装箱的车辆号,一般为数字A.12客流量结构化字段说明视频资源中客流量相关结构化字段说明,见表A.12。表A.12客流量结构化属性字段名称字段类型约束条件字段说明R视频资源编码R进入人数,如果无进入人数检测时该字段时填-1R离开人数,如果无离开人数检测时该字段时填-1RRA.13道路交通能见度结构化字段说明视频资源中道路交通能见度的结构化字段说明,见表A.13。表A.13道路交通能见度结构化属性字段名称字段类型约束条件字段说明R视频资源编码R道路交通能见度,见GA/T16.105RJT/T1353—2020(规范性附录)格式代码定义B.1视频格式视频编码格式代码见表B.1。表B.1视频编码格式代码视频编码字段类型代码01B.2音频格式音频编码格式代码见表B.2。表B.2音频编码格式代码音频编码字段类型代码0123B.3码率格式码率格式代码见表B.3。码率字段类型代码0123456动态码率9B.4码流封装格式码流封装格式代码见表B.4。JT/T1353—2020表B.4码流封装格式代码码流封装字段类型代码ES(无封装)0B.5码流传输模式码流传输模式代码见表B.5。表B.5码流传输模式代码传输模式字段类型代码TCP传输,资源提供方作为服务端0TCP传输,资源提供方作为客户端12自适应传输方式9B.6视频分辨率格式视频分辨率格式代码见表B.6。表B.6视频分辨率格式代码分辨率字段类型代码水平像素×垂直像素B.7返回值格式返回值格式代码见表B.7。表B.7返回值格式代码错误码字段类型代码成功0不支持的操作1没有权限2资源不足34……未定义的错误B.8交换单元状态交换单元状态代码见表B.8。JT/T1353—2020表B.8交换单元状态代码状态字段类型代码正常0视频转发故障1结构化信息转发故障2视频和结构化信息转发故障3服务器内部错误,请联系服务提供方获取详细信息4B.9交通事件类型格式交通事件类型格式代码见表B.9。表B.9交通事件类型格式代码事件类型字段类型代码设备告警事件(0-999为具体的设备告警)0视频丢失1设备故障2……其他设备告警事件故障停车(1000-1999为具体的故障停车事件)……其他故障停车事件货物散落(2000-2999为具体的货物散落事件)……其他货物散落事件……道路维修(3000-3999为具体的道路维修事件)……其他道路维修事件车辆行为(4000-4999为具体的道路维修事件)车辆逆行车道变更超速行驶慢速行驶车辆停止……JT/T1353—2020表B.9(续)事件类型字段类型代码其他交通阻塞事件交通事故事件(6000-6999为具体的交通事故事件)……其他交通事故事件船舶事件(7000-7999为具体的船舶事件)船舶火灾船舶遇险遭遇海盗……其他船舶事件其他交通阻塞事件交通事故事件(6000-6999为具体的交通事故事件)B.10云台控制指令格式云台控制指令代码见表B.10。表B.10云台控制指令代码指令类型字段类型代码焦距变大(倍率变大)焦距变小(倍率变小)焦点前调焦点后调光圈扩大IRIS_OPEN光圈缩小IRIS_CLOSE上仰下俯左转PAN_LEFT右转上仰和左转UP_LEFT上仰和右转下俯和左转下俯和右转设置预置点SET_PRESETJT/T1353—2020表B.10(续)指令类型字段类型代码清除预置点CLE_PRESET转到预置点水平角度垂直角度VERTI_ANGLE启动雨刷START_WIPER停止雨刷启动辅助照明关闭辅助照明LIGHT_OFF开启加热关闭加热HEAT_OFFB.11系统事件类型格式系统事件类型格式代码见表B.11。表B.11系统事件类型格式代码事件类型字段类型代码设备告警事件(0-999为具体的设备告警)0视频丢失1设备故障2……其他设备告警事件B.12设备类型格式设备类型格式代码见表B.12。表B.12设备类型格式代码设备类型字段类型代码固定视角视频采集设备0可变视角视频采集设备1B.13设备状态设备状态代码见表B.13。JT/T1353—2020设备状态字段类型代码在线0离线1故障2JT/T1353—2020(规范性附录)REST模型C.1概述REST是通过采用统一方式将所有信息抽象为资源创建服务的方法,特点有:a)任何能够被命名的信息都能作为资源;b)使用资源标识符来标识组件之间交互所涉及的特定资源;c)组件通过使用一个资源表述来捕获资源的当前或预期状态,并在组件之间传递该表述的方式在一个资源上执行动作,其中一个表述就是一个字节序列,以及描述这些字节序列的表述元数据。C.2方法REST服务通过HTTP的方法动词来实现,方法动词见表C.1。操作创建资源(Create)读取资源(Retrieve)DELETE删除资源(Delete)C.3接口访问形式HTTPURL格式的一般形式为:其中:b)Hostname:表示主机名称,IP地址或域名;c)Port:表示端口号;d)URI:表示资源URI;C.4响应状态码REST请求会收到服务端的响应,服务端的响应状态码见表C.2。C.5REST响应状态代码表JT/T1353—2020表C.2REST响应状态码HTTP状态码REST含义DEL“OK”(成功)-请求已经成功。头部(Header)说明:无。消息体(Body)说明:在消息体中返回所请求的资源×דCreated”(创建成功)-请求已经创建了一项新的资源。消息体(Body)说明:响应消息体返回一个描述新创建资源的实体דNoContent”(无内容)-请求已经成功,但没有返头部(Header)说明:无。消息体(Body)说明:不允许有消息体××移动。头部(Header)说明:Location头部字段包含资源新位置的URI。消息体(Body)说明:消息体可以包含资源的新位置דFound”(找到)-所请求资源应该通过该位置访问,但实际上该资源位于另一个位置。这是设置别名的典型用法。头部(Header)说明:Location头部字段包含资源的URI。消息体(Body)说明:消息体可以包含资源的新位置דBadRequest”(坏请求)-请求消息构建不对,这通常用于创建或更新一个资源时,其数据是不完整或不正确的。头部(Header)说明:通过HTTP状态头部发送的原因说明(Rea-消息体(Body)说明:响应消息体可以包含更多的除头部“原因说明”以外的隐含错误信息××דUnauthorized”(未授权的)-请求需要用户认证后才能访问该资源。如果请求包含无效认证数据,则发送该响应消息。少一种认证机制。通过HTTP状态头部发送的原因说明(Reason-Phrase)可包含错误信息。消息体(Body)说明:响应消息体可以包含更多的除头部“原因说明”以外的隐含错误信息×××דForbidden”(禁止)-该请求是不允许的,因为服务器拒绝处理该请求。出现这种情况的通常原因是视频资源不支持所请求的功能。头部(Header)说明:通过HTTP状态头部发送的原因说明(Rea-消息体(Body)说明:响应消息体可以包含更多的除头部“原因说明”以外的隐含错误信息××××JT/T1353—2020表C.2(续)HTTP状态码REST含义DEL头部(Header)说明:无。消息体(Body)说明:无××××对该资源不支持,因为{API协议}规范不允许该方法。如果视频资源不支持该功能,但是有效的{API协议}操作,则应返回403响应码。头部(Header)说明:Allow头部字段列出针对该资源所支持的消息体(Body)说明:无×××דConflict”(冲突)-所执行的操作与内部状态或正在执行的过程冲突。这是一种过渡状态,延后一定时间可以重试该操作。头部(Header)说明:无。消息体(Body)说明:无××דInternalServerError”(内部服务器错误)-发生了内部服务器错误。头部(Header)说明:无。消息体(Body)说明:无××××REST服务不可用。这通常是因为客户请求太多引起的。头部(Header)说明:Retry-After头部字段建议客户什么时间再尝试重新发送请求。消息体(Body)说明:无××××JT/T1353—2020(资料性附录)消息示例D.1视频资源信息查询消息示例{}}视频资源信息查询返回字段说明见表D.1。表D.1视频资源信息查询返回字段说明返回值字段字段类型字段说明返回值(0表示正常),详见B.7具体错误描述,OK为正常,其他错误码均带有详细的错误信息返回的数据资源列表,为资源节点的集合,资源节点结构详见A.4JT/T1353—2020D.2资源列表获取消息示例D.2.2返回结果示例{},{}]}D.2.3返回字段说明资源列表返回字段说明见表D.2。表D.2资源列表返回字段说明返回值字段字段类型字段说明返回值(0表示正常),详见B.7具体错误描述,OK为正常,其他错误码均带有详细的错误信息返回的数据视频资源列表,为视频资源节点的集合,视频资源节点参数定义详见A.1,为简化的视频资源基础属性D.3资源详细信息获取消息示例JT/T1353—2020资源详细信息请求参数描述见表D.3。表D.3资源详细信息请求参数描述请求值字段约束条件字段类型字段说明R视频资源编码D.3.3返回结果示例{},},"BitRate":[2,4,8,16],JT/T1353—2020}}}D.3.4返回字段说明资源详细信息返回字段说明见表D.4。表D.4资源详细信息返回字段说明返回值字段字段类型字段说明返回值(0表示正常),详见B.7具体错误描述,OK为正常,其他错误码均带有详细的错误信息返回的数据视频资源的基础信息,详见A.1视频资源支持的智能分析能力集,详见A.3视频资源支持的媒体能力集,详见A.2D.4资源推送消息示例资源推送请求参数描述见表D.5。表D.5资源推送请求参数描述请求值字段约束条件字段类型字段说明R资源列表为资源节点的集合,资源节点结构详见A.1D.4.3返回结果示例{}D.4.4返回字段说明资源推送返回字段说明见表D.6。JT/T1353—2020表D.6资源推送返回字段说明返回值字段字段类型字段说明返回值(0表示正常),详见B.7具体错误描述,OK为正常,其他错误码均带有详细的错误信息D.5取消资源共享消息示例取消资源共享请求参数描述见表D.7。表D.7取消资源共享请求参数描述请求值字段约束条件字段类型字段说明R视频资源编码列表,为ResID的数组D.5.3返回结果示例{}D.5.4返回字段说明取消资源共享返回字段说明见表D.8。表D.8取消资源共享返回字段说明返回值字段字段类型字段说明返回值(0表示正常),详见B.7具体错误描述,OK为正常,其他错误码均带有详细的错误信息D.6调用实时视频流消息示例JT/T1353—2020调用实时视频流请求参数描述见表D.9。表D.9调用实时视频流请求参数描述请求值字段约束条件字段类型字段说明R视频资源编码R码流编码类型,详见B.1R音频编码格式,详见B.2R码流封装格式,详见B.4R收流端IP地址R收流端端口R发流模式,详见B.5R视频资源支持的视频分辨率,详见B.6D.6.3返回结果示例{}}D.6.4返回字段说明调用实时视频流返回字段说明见表D.10。JT/T1353—2020表D.10调用实时视频流返回字段说明返回值字段字段类型字段说明返回值(0表示正常),详见B.7具体错误描述,OK为正常,其他错误码均带有详细的错误信息返回值包含资源提供方的发流IP地址、端口和媒体流信息,见A.6D.7实时视频流调用拆除消息示例实时视频流调用拆除请求参数描述见表D.11。表D.11实时视频流调用拆除请求参数描述请求值字段约束条件字段类型字段说明R视频资源编码列表,为ResID的数组D.7.3返回结果示例{}D.7.4返回字段说明实时视频流调用拆除返回字段说明见表D.12。表D.12实时视频流调用拆除返回字段说明返回值字段字段类型字段说明返回值(0表示正常),详见B.7具体错误描述,OK为正常,其他错误码均带有详细的错误信息D.8历史视频记录查询消息示例_历史视频记录查询请求参数描述见表D.13。JT/T1353—2020表D.13历史视频记录查询请求参数描述请求值字段约束条件字段类型字段说明R视频资源编码R查询录像起始时间R查询录像结束时间D.8.3返回结果示例{}]}D.8.4返回字段说明历史视频记录查询返回字段说明见表D.14。表D.14历史视频记录查询返回字段说明返回值字段字段类型字段说明返回值(0表示正常),详见B.7具体错误描述,OK为正常,其他错误码均带有详细的错误信息返回的数据视频资源编码录像段列表本段录像的起始时间本段录像的结束时间D.9历史视频播放链接查询消息示例JT/T1353—2020历史视频播放链接查询请求参数描述见表D.15。表D.15历史视频播放链接查询请求参数描述请求值字段约束条件字段类型字段说明R视频资源编码R查询录像起始时间R查询录像结束时间D.9.3返回结果示例{}]}}D.9.4返回字段说明历史视频播放链接查询返回字段说明见表D.16。表D.16历史视频播放链接查询返回字段说明返回值字段字段类型字段说明返回值(0表示正常),详见B.7具体错误描述,OK为正常,其他错误码均带有详细的错误信息返回的数据视频资源编码录像段列表本段录像的起始时间本段录像的结束时间本段录像的下载链接JT/T1353—2020资源请求方根据录像查询结果中RTSP链接进行录像回放,录像回放按照IETFRFC2326的RTSPb)DESCRIBE方法:DESCRIBEc)SETUP方法:d)PLAY方法:JT/T1353—2020D.10信息订阅消息示例以车辆数据订阅为例:JT/T1353—20