海康威视SDK对接常见问题解决文档

目录前言：.......................................................................................................................................................2一、对接前文档准备...................................................................................................................3对接常用的各类插件、开发包：海康盘地址打包下载......................................................4基础术语普及：................................................................................................................................4必备条件：.........................................................................................................................................8二、常见对接工作：.................................................................................................................101、开发对接前准备工作：.........................................................................................................102、在线调试.....................................................................................................................................103、必须知道的几个问题：.........................................................................................................11三、常见问题解答......................................................................................................................133.1平台接口调不通，返回报错。..........................................................................................133.2视频常见问题..........................................................................................................................153.2实时获取平台人员刷卡刷脸事情、车辆出入，单兵GPS位置事件等................223.3门禁对接常见问题与功能...................................................................................................323.4人员、组织、区域相关........................................................................................................343.5人脸评分接口常见问题........................................................................................................393.6获取4G移动设备GPS信息...............................................................................................413.7停车场常见问题......................................................................................................................423.8合作方无法发送https请求或需重写认证.....................................................................423.9其它问题...................................................................................................................................43四、修订记录...............................................................................................................................45前言：目前我们对接的平台主要为综合安防、智能应用平台，统称为新体系，通过平台自身的

报告：2023年一季度通过加密货币黑客窃取的金额低于2022年的任何其他季度:金色财经报道，根据 Chainalysis 今年早些时候的一份报告，2022 年是历史上加密货币黑客攻击最多的一年，估计有 38 亿美元被盗，主要来自 DeFi 协议和与朝鲜有关的攻击者。

然而，这一数字在 2023 年第一季度似乎已大幅减少。根据 TRM Labs 5 月 21 日的一份报告，2023 年第一季度通过加密货币黑客窃取的金额低于 2022 年的任何其他季度。值得注意的是，与去年同期相比，黑客的平均规模下降了近 65%。从 2022 年同一季度的近 3000 万美元增至 1050 万美元。[2023/5/22 15:18:00]

密级级别：外部公开海康威视版权所有3开放能力进行对接，为第三方通过我方平台获取相关数据，并非我方进行开发，这点请明确，平台接口修改会产生定制工作，如有接口定制需求，请走定制评估流程。API网关组件对外提供各种完善的数据接口，数据接口返回格式统一为JSON数据格式，对接统一为RESTFUL接口，通过http/https协议对接。我方提供调用权限、服务地址、插件、对接技术支持，对接前，关于以下内容请各位悉知，如有文档中暂无解决办法的，请按照SDK支持流程中联系对应的人，感谢支持。以下是对接中的专业词汇解释，如有需要可点击查看了解：JSON格式：点此查看详细信息与示例RESTFUL接口：点此查看详细信息与示例HTTP与HTTPS协议：点此查看详细信息与示例注：本文档会随着各个地区对接问题的解决进行常见问题的汇总并保持更新对接须知：请第一时间将平台版本截图发到群里，群名可以加上平台版本。平台版本确认见基础术语普及->平台版本的确认章节。一、对接前文档准备ISC：OpenApi对接在线文档IoT：OpenApi对接在线文档

密级级别：外部公开海康威视版权所有10二、常见对接工作：1、开发对接前准备工作：开发资源包与文档下载：如下链接：https://open.hikvision.com/download/5c67f1e2f05948198c909700?type=10需先注册账号，对外开放的，正常注册就行。2、在线调试请参照上面几张图，进入api管理，使用在线调试工具进行各个接口的调试与查询，如需要对接视频取流预览回放，就搜预览/回放，会查出对应的在线接口文档，可以直接进行在线调试获取取流地址或者回放地址，其中模拟数据仅用来参考数据格式，并未产生实际的调用请求。如下图，参数说明可以点击接口名称查看：

雄安首笔科技创新券以数字人民币形式完成兑付:金色财经报道，雄安新区首笔科技创新券以数字人民币形式完成兑付，结合区块链智能合约技术实现“秒兑付”。采用数字人民币+区块链智能合约形式发放科创券为新区首创，已纳入新区科技企业库和“专精特新”企业培育库企业分别可领取5万元和15万元科创券。[2022/12/16 21:48:11]

密级级别：外部公开海康威视版权所有135.对接调用demo三、常见问题解答3.1平台接口调不通，返回报错。排查步骤：1、使用平台在线调试功能，调试是否能够调通接口。调试方法参见本文档中：二、常见对接工作->2、在线调试如果在线调试能够调通，那么证明平台接口没有问题，需要检查一下对接的代码。1)Host地址配置正确，appkey和secret生效并且有权限。2)是否存在内外网问题？如果是，请将技术同事检查一下集群代理配置是否正确，在外网是否能够访问到平台。如果还是有问题：请参照以下demo进行调用GetCameraRes.java

密级级别：外部公开海康威视版权所有153.2视频常见问题1、预览接口获取到的取流地址播放不了请先用vlc播放器尝试是否可以正常播放，且如果vlc的版本是否3.5.9的版本。请换一个版本。1)请检查该监控点在平台上是否可以取流回放(不是双击播放，是右键点击监控点，选择非直连预览)。如果平台无法播放视频，让技术同事帮忙排除设备是否有问题，是否在线。2）确认平台是否有内外网，如果有内外网，则让技术同事确认一下平台的端口映射有问题。如无问题，检查新增的外网appkey和Secret是否配置正确。正确的配置如下图(domainId必须选择外网的网域ID)：3)前二步确认没有问题，检查一下取流协议参数：协议是RTSP：是否传了以下字段"expand":"streamform=rtp"

密级级别：外部公开海康威视版权所有18"cameraIndexCode":"311b1237d72843a68dabf4a61c62a662","streamType":0,"protocol":"rtmp","transmode":1}4)rtsp协议可以预览，rtmp协议无法预览ISC1.2.0版本需要打mgc的补丁包，《mgc_hf_20191018_PN302944_V5.7.0_十月份问题缺陷补丁合集.zip》另：为保证数据的安全性，取流URL设有有效时间，有效时间为5分钟。其它问题导致无法播放，请先认真看下取流接口说明，看是否存在取流接口说明描述的问题。5)rtsp协议可以预览，hls协议无法预览首先前端相机的视频格式要求为H264，音频格式是AAC。VLC3.0.10版本的无法播放，用VLC2.2.4版本的可以正常预览。2、回放接口取的流url无法播放1)先按上述预览接口无法播放，排查相关问题。2)协议是HLS的无法播放。则请确认以下前提。HLS取流回放需要云存储支持：HLS协议3)rtmp协议无法回放ISC1.2.0版本除了需要mgc的补丁包之外，还需要打vnsc的补丁包，《vnsc_hf_20190225_171443_V1.8.0_修复回放url中时间格式缺少毫秒问题.zip》

密级级别：外部公开海康威视版权所有19不打补丁的话，第三方获取到url后，按照这种格式把时间段拼接在后边播放。如下示例：rtmp://10.19.132.75:1935/vod/openUrl/ER9woMg?beginTime=20191213T100000&endTime=20191213T100500&playBackMode=1&fileSize=1024000原因：用短url直接取流的话，vnsc会把时间段解析成非国际化时间，mgc取流的时候会有问题。rtmp协议只支持H.264AAC编码格式，支持用VLC预览回放，不支持用hpsclient预览回放。4）rtsp协议无法回放请检查以下回放流格式回放流格式如下：rtsp://10.194.98.217:554/openUrl/jum5GDK?beginTime=20170615T000000&endTime=20200618T000000&playBackMode=1&streamform=rtprtmp回放取流入场示例：{"cameraIndexCode":"1e97a3604f6e4128b3022e033571fbe0","recordLocation":"1","protocol":"rtmp","transmode":1,"beginTime":"2020-01-08T00:00:00.000+08:00","endTime":"2020-01-09T00:00:00.000+08:00"}3、小结ISC平台提供都是标准的RTSP、RTMP、HLS取流协议，只需要先获取平台的监控点编号，在调用预览、回放取流接口即可。获取监控点视频，包括取流预览、取流回放。取流预览目前没有什么限制，需要注意的是前端相机的视频格式需要为H264格式，音频为ACC。取流协议简介：

柏林Subway开设比特币支付试点提供10%的折扣:金色财经报道，餐厅专营店Subway正在德国首都柏林的三家Subway试行比特币支付。在过去的几个月里，柏林Subway特许经营店的老板Daniel Hinze记录了超过120笔比特币交易。Hinze鼓励用比特币支付，对所有用BTC支付的footlongs, meatball marinaras和sucookies提供10%的折扣。（cointelegraph）[2022/11/10 12:41:10]

密级级别：外部公开海康威视版权所有20HLS流：HLS协议的流也可能在客户那边的要求视频编码为m3u8，最大的特点是HLS的流很方便的在浏览器端直接播放，客户也可能需要将其应用到手机端的播放，因此，一般涉及到网页播放、手机播放、微信公众号播放的需求，基本都是需要HLS协议支持，但是ＨＬＳ协议流有一定限制。取流协议RTSP流：RTSP常用与客户端或者播放器插件，播放器插件可以从以下地址查找：播放器插件下载：包括WEB端插件、CBillions项目组/serviceSupport/patch/component/detail/PN302944ISC1.3.0平台，按时间顺序安装mgc补丁。然后运管中找到mgc的服务参数，打开即可。ISC1.4.100平台，再运管中找到mgc服务参数打开即可。如下图：

密级级别：外部公开海康威视版权所有22问题：调用获取监控点在线状态，online返回值为null解决方法:平台的巡检计划没有开启,把平台的视频巡检计划打开即可。问题：获取录像报"code":"0x0d200b26"错误解决方法：因为平台没有配置没配录像计划，或者平台就查不了录像。配置一下录像计划即可。3.2实时获取平台人员刷卡刷脸事情、车辆出入，单兵GPS位置事件等1、如何进行事件订阅，获取人员刷卡刷脸比对等数据按事件类型订阅事件:事件订阅参考地址：https://open.hikvision.com/docs/28e10567a3ec4b7aa107c79cbb1f9ae9

密级级别：外部公开海康威视版权所有23订阅原理：第三方与海康平台对接，根据事件类型订阅事件，传入事件类型码，事件级别，事件类型、回调函数地址，当该事件发生时，平台会向第三方的回调地址发送该事件的数据，具体数据内容请参照接口文档：事件列表：https://open.hikvision.com/docs/2c6c0ced640f403faa3a108cc9eb020c该接口用于满足应用方按事件类型码订阅事件，同一个用户重复订阅相同的事件，接口内部逻辑自动去重，确保不重复投递事件。事件订阅接口，支持订阅平台的所有业务的各种事件类型，具体参考附录D本接口要求，三方订阅的时候，要求三方指定的http/https接收事件的服务地址。后续平台产生对应的事件，会推送到此http/https服务地址。接口地址只支持IP，不支持域名。且订阅收到消息之后，要返回200OK,否则或造成消息堵塞，后续无法在继续接收到消息。事件订阅参数参照：{"eventTypes":,"eventDest":"https://ip:port/eventRcv",

密级级别：外部公开海康威视版权所有24"subType":2,"eventLvl":}回调函数写法参照：/***事件回调*@paramjsonObject回调参数*/@RequestMapping("/test")@ResponseBodypublicStringeventDest(HttpServletRequestrequest){JSONObjectjsonObject=null;StringsTest="";InputStreamis=null;try{is=request.getInputStream();StringBuildersb=newStringBuilder();byteb=newbyte;for(intn;(n=is.read(b))!=-1;){sb.append(newString(b,0,n));}sTest=sb.toString();}catch(IOExceptione){e.printStackTrace();}jsonObject=JSONObject.parseObject(sTest);try{logger.info("收到回调信息"+jsonObject.toJSONString());

澳创资本同CashCow达成战合作:据官方消息，澳创资本与CashCow达成深度合作，提升CashCow的流动性问题，提升数据安全性，同时降低预言机运行成本。[2022/10/1 22:43:30]

密级级别：外部公开海康威视版权所有283、收到订阅返回的消息中没有图片信息下列以门禁事件举例排查相关问题。1)排查平台上的门禁事件是否有图片，如果没有，让技术同事确认设备上是否有图片。如2)果设备上也有，让技术同事确认平台的图片存储服务(ASW)是否配置正确。3)再esc配置一下联动事件。进入运管中心->状态监控，搜索事件服务，展示如下图点击服务参数配置，修改事件状态为"0,1,2,4"和事件等级为"0,1,2,3"，如下图

密级级别：外部公开海康威视版权所有29说明：具体事件状态和事件等级说明参考附录。点击保存并下发按钮，弹出确认下发界面，如下图，点击下发按钮。配置生效后，能订阅到联动事件。4)如果要获取停车场的带图片事件。需要再将事件状态改成0，1，2，3，4，5同时配置完之后要取消订阅，再重新订阅。4、小结1、平台的实时数据，如门禁、访客(门禁的人证认证比对事件)、报警、人脸抓拍、停车场出入、移动设备GPS数据都可以通过事件订阅接口获取。2、事件订阅接口支持多个事件一次订阅，但事件必须要是同一种事件类型。如既要门禁事件，也要访客事件，则需要分二次调用事件订阅接口。但如果是要门禁事件中人脸比对事件、人证比对事件，则只需要订阅一次eventTypes传

密级级别：外部公开海康威视版权所有303、如果不需要再接收事件，或者需要重新订阅事件，务必先取消之前的订阅。4、为了保证事件的实时性，事件的图片上传是异步，如停车场入场事件，产生了一次事件会收到二个消息，一个是不带图片的事件，一个是带图片的事件。5、合作方收到订阅的消息之后，一定要返回200OK。因为：1）平台推送事件，等待回复的周期约为30秒2）第三方不回复，平台日志会记录发送失败，此时第三方是否实际收到报文，要看第三方自己的接收逻辑。3）所以一般建议第三方接收事件，及时回复平台，避免此类事件推送失败的情况。6、推送的门禁事件没有人员身份证，工号即对接方需要确认这个人的唯一字段。综合安防平台因为是面向各个行业的统一平台，如果人员全部是由平台手动添加的(有的地方是用身份证做人员唯一标识，有的地方用工号做唯一标识，有些政府人名加组织是唯一标识，学校是学号做唯一标

密级级别：外部公开海康威视版权所有31识，所以平台统一自动生成一个personId做唯一标识)，那么人的唯一标识就是personId，门禁事件上传的人员唯一标识就是personId。解决方案：1、如果ISC1.4.100平台建议合作方自己通过接口添加人员、组织(方法详见3.4人员、组织、区域同步相关)，将合作方自己的唯一标识传入到personId字段中。这样后续门禁上传的事件中的ExtEventPersonNo就是自定义的人员唯一标识。2、如果是其它版本平台或者只能通过平台去添加人员，那么只能先获取平台所有人员信息，然后将人员ID和合作方的唯一标识做个缓存。后续收到门禁事件之后再通过personId反查人员信息。或者用personId再调用一次接口获取人员数据

密级级别：外部公开海康威视版权所有32如果对接方无法对接事件，或必须采用数据库方式同步事件数据，则可以转发布区域做的事件同步组件。3.3门禁对接常见问题与功能1、门禁权限开通要求：1、仅ISC1.3.0及以上版本支持。2、平台人员需先开卡，如果没有卡，则可以使用平台的虚拟卡功能。按以下步骤进行调用接口即可。第一步：添加权限配置备注：也可以穿插调用查询权限配置单进度，查看添加的权限是否生效(仅ISC1.4.100提供此接口)第二步：创建下载任务_根据出入权限配置下载第三步：添加待下载的设备通道_根据出入权限配置下载(使用第二步返回的taskID)第四步：开始下载任务(使用第二步返回的taskID)

加密钱包ZenGo推出名为ClearSign的Web3防火墙功能:6月22日消息，加密钱包提供商ZenGo推出了一项名为Clear Sign的新功能，该Web3防火墙将提醒用户注意可疑的智能合约，并阻止签署会暴露私钥或助记词的交易。Clear Sign已经集成在Collab.Land上，这是一种流行的Discord机器人，许多NFT项目使用它来验证所有权。Clear Sign将在iOS和Android上可用。

ZenGo表示将在未来几周内添加其他Dapp集成。[2022/6/22 1:25:00]

密级级别：外部公开海康威视版权所有343、查询门禁设备状态，online返回为null查看巡检计划配置，将门禁状态设备检测状态设置为启用。3.4人员、组织、区域相关1、添加人员、组织、区域平台接口地址：https://open.hikvision.com/docs/8f684c68cbbc4a7bba86835e9f0659a7ISC1.4.100以下不允许自定义传入人员ID(personId)、组织ID、区域ID(regionIndexCode)

密级级别：外部公开海康威视版权所有373)拼装图片url将平台IP和固定端口6040(http)或端口6114(https),拼装到图片url即可。如以下示例：http://127.0.0.1:6040/pic?8dd285i5fe*30645743c125m3ep=t=i1p*i=d1s*i=d2b*i7da0*6a06ehttps://127.0.0.1:6114/pic?8dd285i5fe*30645743c125m3ep=t=i1p*i=d1s*i=d2b*i7da0*6a063、ISC1.4.100平台通过接口一个人员，平台展示三个相同人员。如下图解决方法：先连接irds数据库，删除多余重复的人员或者组织(出于安全角度，数据库操作仅限海康同事，不允许非海康同事进行操作)SELECT*FROMtb_orgWHEREorg_index_codeIN(SELECTa.org_index_codeFROMtb_orgaGROUPBYa.org_index_codeHAVINGCOUNT(a.org_index_code)>1);

密级级别：外部公开海康威视版权所有38SELECT*FROMtb_personWHEREperson_index_codeIN(SELECTa.person_index_codeFROMtb_personaGROUPBYa.person_index_codeHAVINGCOUNT(a.person_index_code)>1);安装以下补丁包：irds_hf_20200409202908_PN30354T_V1.3.100_解决irds1.3.100版本中管理接口问题.zipISC1.4.101相同处理方法。4、级联区域获取下级区域级联到上级区域，只能通过V2的接口获取到下级区域的信息。ISC1.3.0只支持查询区域列表v2这个接口。参数示例：{"resourceType":"region","pageNo":1,"pageSize":100}且不支持像查询区域一样给出树形结构关联关系。如下图：

密级级别：外部公开海康威视版权所有39ISC1.5.100支持通过根据区域编号获取下一级区域列表v2接口获取树形结构。3.5人脸评分接口常见问题返回：{"code":"0x1f91300f","msg":"uis.analyse.face.pic.download.fail","data":null}原因：再平台的服务器上无法访问传入的图片URL。解决方法：1、再平台的服务器上是否能够访问传入的图片URL。2、有内外网导致无法访问图片URL，可以将图片原始数据base64编码传入。

密级级别：外部公开海康威视版权所有40返回:{"code":"0x1f902302","msg":"algorithmlibraryisnotauthorized,pleasecheck","data":null}原因：人脸评分接口需要单独授权。解决方法：联系销售同事，让销售同事去申请授权即可。返回：能够调用成功，但多次调用返回0x0x1f902301分析：人脸评分接口使用是uis服务，目前该服务有性能瓶颈，一分钟最多能够调用12次左右。解决方法：1、开发新的接口，对接脸谱设备。2、提供uis服务的性能，目前已有项目做过，最高一分钟可以调用100次。可让行销或销售同事联系研发，提供方案。另：其它问题导致无法失败，请先认真看下人脸评分接口说明，看是否存在评分接口说明描述的问题。

密级级别：外部公开海康威视版权所有413.6获取4G移动设备GPS信息订阅事件：需先确认在图上监控里能看到位置信息事件中获取的经纬度需要除以36万，才是设备真实的经纬度。另：合作方获取到这个经纬度之后，如果需要这个经纬度在高德或百度地图上展示，除以36万之后，需要将原始84坐标转火星坐标(百度查转换方法)。转换之后和实际位置略有偏差，若需要减小偏差，可以查看如下设置的椭球长半轴，椭球的偏心率，圆周率常量值//圆周率PIprivatestaticfinaldoubleM_PI=Math.PI;//地球半径R乘以PIprivatestaticfinaldoublePI_R=20037508.34;//地球半径privatefinalstaticdoubleR=6378245.0;//对数常量eprivatefinalstaticdoubleE=0.00669342162296594323;

密级级别：外部公开海康威视版权所有423.7停车场常见问题调用车辆充值接口。返回：{“code”:“0X00052102”,“data”:null,“msg”:“ServiceError”}原因：平台停车场场景设置的是免费场景。调用取消包期接口返回：{"code":"0x02e13000","data":null,"msg":"pms.accountmanag.var.refund.failed"}原因：车还在停车场内，无法取消包期。Q：添加车辆无法指定车库，如果确定一辆车加入到指定的车库。A：在调用车辆充值接口，可以将车辆变成固定车，并指定车库。Q：访客的车辆是否按照预约时间进行管控。A：访客车辆入场是按照预约时间进行放行，出场是按照临时车进行处理，临时车如果设置收费，访客车辆则也需要收费。3.8合作方无法发送https请求或需重写认证ISC1.4.100以下平台支持http协议，1.4.100只支持https协议。平台设置http协议：

密级级别：外部公开海康威视版权所有43设置完成之后，即可用http协议登陆平台首页。端口也会变成http的端口。重写认证：说明：https://open.hikvision.com/docs/6a14a251f6d042319b277b26ad60aa17实例：3.9其它问题Q:单个接口获取的某些字段是空的，或者为空字符串？A:因为平台提供了一个开放性接口组件，部分字段为空，请找找该返回值里是否有某个唯一标识可以用来去调用别的接口获取到所需要的数据。ApiSignature.java

密级级别：外部公开海康威视版权所有44Q:客户问为什么数据不能一次性返回，几万条数据也需要分页？A:我们不是仅仅为了一家客户做的api接口，况且几万条数据一次返回组成的报文也是很大，请按照接口文档所介绍的，分页查询。当需要获取一些参数去测试的时候，请直接在api管理里搜“分页”，会有分页查询的接口显示，选择需要的接口进行测试，就可以获取到所需要的数据，接口调用不可能都是一个接口就能拿到所有的数据的，接口数据调用配合才能最终获取到所需要的完整的数据。这点，请客户对接方理解。如确实需要我方修改，请提交定制评估流程。Q、调用API接口，返回0X14c000161、平台版本是ISC1.3.0，重启api网关即可。2、平台版本是ISC1.3.100，建议放弃治疗，升级到ISC1.4.100如果无法升级则需要打核心服务补丁和api网关补丁。3、如果是行业平台，则检查一下行业平台的api资源包是否缺少插件包：

密级级别：外部公开海康威视版权所有45如果是缺少资源包，联系行业产品同事获取这个插件包。Q：调用平台接口返回code0X0240100错误Code:0X0240100msg:paramconverterror:ConsumerparamValueisnullA：使用的appkey和appsercet没有加上tagID，增加一个tagID即可(值填frs即可，参考对内合作方的配置)。Q:调用平台接口返回code0x0240100a错误{"code":"0x0240100a","msg":"paramconverterror：ConsumerparamValueisnull!"}A：使用的appkey和appsercet没有加上tagID，增加一个tagID即可(值填frs即可，参考对内合作方的配置)。Q：如何获取平台门禁事件图片、人员、停车场事件等图片A：通过接口或者解析事件报文中的图片url，然后关闭ASW认证，再通过拼装获取完整的图片url。详见：文档中3.4章节-->2、获取人员图片四、修订记录

密级级别：外部公开海康威视版权所有46序号变更时间版本变更人维护部门变更说明12019/10/31V1.0.0邵杨辉海康威视江苏研发中心创建22020/04/25V1.0.1张兵海康威视江苏研发中心新增人脸评分接口报错问题排查32020-04-26V1.0.2许北虎海康威视江苏研发中心新增视频问题42020/05/12V1.0.3张兵海康威视江苏研发中心修改文档层级结构，按照平台模块划分问题解答52020/05/13V1.0.4张兵海康威视江苏研发中心增加门禁事件获取人员唯一标识说明62020/05/14V1.0.5许北虎海康威视江苏研发中心增加视频预览问题72020/05/15V1.0.6张兵海康威视江苏研发中心增加获取人员图片82020/05/26V1.0.7陈建祥5海康威视江苏研发中心新增解决获取门禁设备状态返回字段为空的问题92020/06/04V1.0.8张兵海康威视江苏研发中心新增调用平台接口报错和播放视频自动断开问题。102020/07/13V1.0.9张兵海康威视江苏研发中心新增ISC1.4.100同步人员错误问题。112020/08/24V1.0.10张兵海康威视江苏研发中心新增级联区域获取问题122020/09/16V1.0.11张兵海康威视江苏研发中心增加GPS采集事件经纬度说明

郑重声明：本文版权归原作者所有，转载文章仅为传播更多信息之目的，如作者信息标记有误，请第一时间联系我们修改或删除，多谢。

银河链

海康威视SDK对接常见问题解决文档

银河链