接口调用

1.接口返回Http状态码401

问题原因：身份认证不通过

解决办法：

1.检查接口调用传token的方式是否正确

2.重新获取token

3.参考开发指南->接口说明->认证管理

4.如果是获取token接口返回401，则检查client_id与client_secret是否正确

2.接口返回Http状态码503、429

问题原因：接口调用频率超过限制（默认100次/分钟）

解决办法：检查是否存在后台运行的程序在调用接口、异常一直重试等情况，确认接口调用频率。

3.接口返回Http状态码404

问题原因：接口路径/请求方式错误

解决办法：参考接口文档，核对接口路径与请求方式是否正确

4.接口返回Http状态码301、302

问题原因：3XX是客户端错误，301和302为客户端请求重定向

解决办法：请求协议需为https

5.接口返回510001参数错误

问题原因：参数错误或传参方式不正确

解决办法：参考接口文档，核对接口入参与传参方式是否正确

设备管理

1.添加设备时返回”设备不在线/设备不存在”

问题原因：设备没有正常接入到云端

解决办法：

1.检查设备网络链接、配置是否正常

2.设备需要配置成萤石云接入，配置方式：

配置若有问题可咨询设备技术支持

2.添加设备时返回”设备型号不支持”

问题原因1：云眸是按照白名单的方式来接入设备的，新增的设备型号需要报备

解决办法1：联系云眸技术支持报备设备型号

问题原因2：设备没有向萤石报备该型号

解决办法2：联系设备技术支持，需要设备产品部门向萤石报备该型号

3.添加设备时返回”设备已被别人添加”

问题原因：设备已经被其他人在云眸平台其他账号下或萤石APP添加过

解决办法：先将设备在其他账号下删除，再重新添加

4.添加设备时返回”未开通XXXX服务或接入已达上限”

问题原因：用户需要下单购买对应的服务才能接入设备

解决办法：联系海康分公司销售提交申请单，下单购买对应的服务（视频、客流、人脸、门禁等）

5.添加设备返回”510207设备添加成功，通道同步失败，请手动同步刷新”

问题原因1：未报备的设备型号

解决办法1：联系云眸技术支持报备设备型号

问题原因2.同步通道超时，目前同步通道超时时间为20秒

解决办法2.确认设备网络连接是否正常，并重新调用同步设备通道接口

6.调用接口返回”设备不存在”

问题原因：设备未添加到云眸，或传参错误找不到该设备

解决办法：通过设备注册接口将设备添加到云眸，检查传参例如设备ID、设备序列号是否正确

7.调用接口返回”设备不在线”

问题原因：网络连接断开或其他原因导致设备网络连接不上

解决办法：检查设备网络连接、配置情况

8.调用接口返回”设备响应超时”

问题原因：网络连接不稳定或其他原因导致与设备交互命令响应超时,目前设备响应超时时间为15秒

解决办法：

1.检查设备网络连接、配置情况

2.与云眸技术支持确认设备固件版本是否为支持云眸的版本（涉及定制版本的请单独联系分公司销售）

9.设备查询接口/设备列表页面的设备在线状态与实际情况不符

问题原因：开放平台目前的设备在线状态是每小时定时轮询的，不是实时更新的

解决办法：后续迭代版本会根据设备/通道上下线消息及时更新设备/通道在线状态

10.接口返回无效数据

问题原因：设备/通道ID不存在，可能已被删除

解决办法：重新获取设备/通道列表，检查设备/通道ID是否正确

视频集成

1.SDK初始化或Web视频控件初始化报错”账号配置异常”、”子账号不存在”

问题原因：账号下还未添加设备

解决办法：先调用设备注册接口添加设备

2.调用获取标准流预览地址接口返回”地址未绑定”

问题原因：每个设备的标准流预览地址均需要开通

解决办法：调用开通标准流预览功能接口开通该功能

3.Web视频控件无法预览视频，报错”502012验证码错误”

问题原因：海康视频设备默认是开启加密的，使用web视频控件预览视频时需要关闭设备视频加密

解决办法：调用关闭设备视频加密接口关闭视频加密

4.视频可以正常预览，回放报错”400036验证码错误”

问题原因：NVR/IPC未关闭视频加密

解决办法：调用接口或在业务平台设备管理页面关闭视频加密

5.视频预览/回放报错”110031用户没有权限”

问题原因：该设备不属于该用户

解决办法：检查确认该设备是否属于该用户账号，如果是IPC通过NVR接入平台，则NVR必须属于该用户账号

6.视频预览报错400901

问题原因：设备不在线

解决办法：检查设备网络连接是否正常

7.Web视频控件预览错误码0

问题原因：视频控件未正确初始化

解决办法：检查接口调用情况，前端代码初始化控件是否正常

8.SDK Demo、Web视频控件Demo集成错误

问题原因：Demo仅供参考，具体接入到项目中还是需要第三方开发者自行开发的

解决办法：参考Demo的接口调用流程，开发实现自己的业务

9.SDK集成之后有文件冲突

解决办法：删除重复的冲突文件

10.SDK初始化后无法预览，但是demo是可以正常预览的

问题原因：SDK初始化信息不正确

解决办法：使用正确的账号信息初始化SDK

11.视频可以正常预览，但是无法回放，报错5405流媒体向设备发送或接受信令超时/cas响应超时

问题原因：平台上添加的是IPC，NVR没有添加到平台上

解决办法：将NVR添加到平台上

12.视频标准流预览报错视频编码类型非H264

问题原因：标准流预览要求设备视频编码类型为H264

解决办法：登录设备配置视频编码类型为H264

13.控件预览视频报错525454不支持的码流类型

问题原因：预览的视频清晰度与当前设备清晰度不匹配

解决办法：

1.在控件上操作切换视频清晰度

2.初始化视频控件时，videoLevel传0（流畅），也可以设置为-1（默认使用上次设置），流畅也存在设备不支持的情况

14.视频控件初始化时如何设置清晰度？

A：设置初始化参数videoLevel的值，0-流畅 1-均衡 2-高清 3-超清

15.webDemo中的FireTransFunction是做什么用的

A：这个是视频控件的回调接口，用来接收控件的回调事件

16.视频回放提示没有录像文件

A：普通摄像头没有存储能力，需要通过NVR（硬盘录像机）接入平台

17.标准流预览清晰度为什么很低？

A：标准流预览地址有2个，不带hd后缀的为设备子码流，清晰度较低，带hd后缀的为设备主码流，一般清晰度较高，可在设备上配置主子码流的清晰度

18.视频控件如何设置分屏数？

A：修改配置文件C:Program Files (x86)HikCloudViewPluginHikCloudViewPluginchain CloudView.ini中的的参数

[layout]

Playback=3（回放）

Preview=1 （预览）

1：一分屏 3：4分频 7：9分屏

暂不支持其他分屏数

19.视频控件如何实现轮播？

A：循环调用播放接口即可

门禁管理

1.门禁事件消息无法上报

问题原因：

1.设备没有上报门禁事件

2.设备型号未报备

解决办法：

1.确认设备版本、网络连接是否正常

2.如果是的新的设备型号接入，需要联系云眸技术支持报备

2.下发人脸接口返回512006subpicAnalysisModelingError、pictureModelingFailed建模失败或badParameters参数错误

问题原因：图片人脸质量不符合要求

解决办法：按照要求采集人脸照片

3.下发人脸接口返回”512006 unknown”

问题原因：人脸照片分辨率超过了设备支持的最大分辨率

解决办法：使用画图软件调整图片分辨率到设备支持的范围内，例如671设备支持最大分辨率为1920*1080，不同型号设备能力不一样，具体参数可咨询设备技术支持

4.删除人员接口返回512107设备型号不支持

问题原因：设备型号未报备

解决办法：联系云眸技术支持报备设备型号

5.门禁设备人脸识别成功，但是门没有联动打开

1.检查门禁设备与门之间的线路连接是否正常

2.设备门锁动作时间需要调整为1秒，如果是默认5秒的话，门在5秒之内是不会重复打开的

6.人员下发接口返回人员下发失败 comparisonTimeRangeError

问题原因：validEndTime填的太大了，例如2099年

解决办法：修改validEndTime参数（例如2029），重试下发

7.卡下发接口返回卡下发失败 searchDataBaseElementError

问题原因：设备数据库被损坏，一般是下发过程中断电导致的

解决办法：需要将设备恢复出厂设置，重新激活、重新配置

8.人员下发接口返回人员下发失败beyondARGSRangeLimit

问题原因：下发参数错误，部分设备roomNumber字段只支持2位数字，如果传了3位数字例如101就会返回这个错误

解决办法：修改下发参数，改为floorNumber+roomNumber组合，例如房间号1801则floorNumber为18，roomNumber传1

9.批量下发接口返回成功，但是查看设备上的人员信息没有记录

问题原因：批量下发接口返回成功只表示批量任务创建成功，需要调用查询任务状态接口确定任务已完成，再调用任务详情接口查询详细下发结果。

10.门禁下发的人员到了有效期会删除么？

A：不会删除，验证时会提示过期

11.注册的设备下发了人脸，当设备注销之后人脸还能识别成功

A：目前设备注销接口不会主动删除设备上的人脸信息，需要业务方自行调用接口删除

消息通道

1.消息通道拉取不到消息

问题原因：

1.消息拉取方式不正确，消费者创建之后第一次消费消息时需要建立连接（可能会耗时2-3秒），此时获取到的消息列表是空的

2.拉取消息的间隔超过30秒，消费者建立连接的有效期是30秒，拉取间隔超过30秒会导致每次拉取时都需要建立连接而实际拉到消息列表是空的

解决办法：

1.消费消息的接口多尝试调用几次

2.消费消息的间隔要在30秒以内

3.参考消息通道demo（开发指南->消息通道）

4.联系平台技术支持查看消息是否正确投递

2.消息通道消费到的消息重复

问题原因：偏移量提交不正确

解决办法：

1.如果是采用自动提交偏移量的方式，需要保证消费间隔在30秒以内（自动提交偏移量是在下一次请求是提交上一次消费的偏移量），消费到消息之后的消息处理一定要是异步处理的，否则可能会造成间隔超过30秒，产生消息重复的现象

2.如果是采用手动提交偏移量的方式，需要保证消费到消息之后正确提交偏移量（未消费到消息不可以提交偏移量，可能会造成偏移量被重置）

3.参考消息通道demo（开发指南->消息通道）

4.可根据消息的msgID去重

3.接口返回514006租户未开通消息通道

问题原因：消息通道功能需要单独开通

解决办法：联系云眸技术支持开通消息通道功能

4.接口返回514004消费者数量已达上限

问题原因：创建的消费者数量已经达到上限(5个)

解决办法：无需每次消费都创建消费者，创建一个之后循环调用消费消息接口即可，消费者5分钟内没有消费会自动删除

5.消息通道的消息最大保存多久？

A：7天

其他

1.设备ID和通道ID是不变的吗？

A：设备ID和通道ID是设备添加到平台之后生成的平台唯一标识，只有在设备删除重新添加时会改变，其他情况下不会改变

2.设备抓图接口返回20006网络异常

A：设备网络异常，需要检查设备网络。如果设备网络正常，则需要检查设备版本，较老的版本是不支持云端抓图的

3.云台控制接口返回”该设备不支持云台控制”

A：云台控制本身是设备的能力，一般只有球机、半球机有这个能力，返回该错误则需要考虑更换支持云台控制的设备

4.IOS拍摄的人脸照片调用人脸评分接口返回人脸质量差

A：正常相机拍摄或者安卓手机拍摄，图片的Orientation值（表示图片方向）一般为1或者无该信息，IOS为了保证竖着拍跟横着拍照片看起来效果一样，给竖着拍的照片增加了一个90°的旋转，其Orientation值一般为6（镜像翻转的可能为5），导致图片在编码解码后会出现旋转的现象，而人脸横着的图片是无法解析出来的。

5.收不到设备报警消息

A:如果是在设备报警类型列表中的报警消息（例如区域入侵fielddetection、电瓶车报警leftdetection），按照以下步骤进行检查
1.检查消息通道权限（登录后，从秘钥管理菜单进入）-设备报警消息是否开启
2.设备添加成功后，调用布撤防接口进行布防
如果是不在设备报警类型列表中的报警消息，则需要联系技术支持具体排查

常见问题

接口调用#

1.接口返回Http状态码401#

2.接口返回Http状态码503、429#

3.接口返回Http状态码404#

4.接口返回Http状态码301、302#

5.接口返回510001参数错误#

设备管理#

1.添加设备时返回”设备不在线/设备不存在”#

2.添加设备时返回”设备型号不支持”#

3.添加设备时返回”设备已被别人添加”#

4.添加设备时返回”未开通XXXX服务或接入已达上限”#

5.添加设备返回”510207设备添加成功，通道同步失败，请手动同步刷新”#

6.调用接口返回”设备不存在”#

7.调用接口返回”设备不在线”#

8.调用接口返回”设备响应超时”#

9.设备查询接口/设备列表页面的设备在线状态与实际情况不符#

10.接口返回无效数据#

视频集成#

1.SDK初始化或Web视频控件初始化报错”账号配置异常”、”子账号不存在”#

2.调用获取标准流预览地址接口返回”地址未绑定”#

3.Web视频控件无法预览视频，报错”502012验证码错误”#

4.视频可以正常预览，回放报错”400036验证码错误”#

5.视频预览/回放报错”110031用户没有权限”#

6.视频预览报错400901#

7.Web视频控件预览错误码0#

8.SDK Demo、Web视频控件Demo集成错误#

9.SDK集成之后有文件冲突#

10.SDK初始化后无法预览，但是demo是可以正常预览的#

11.视频可以正常预览，但是无法回放，报错5405流媒体向设备发送或接受信令超时/cas响应超时#

12.视频标准流预览报错视频编码类型非H264#

13.控件预览视频报错525454不支持的码流类型#

14.视频控件初始化时如何设置清晰度？#

15.webDemo中的FireTransFunction是做什么用的#

16.视频回放提示没有录像文件#

17.标准流预览清晰度为什么很低？#

18.视频控件如何设置分屏数？#

19.视频控件如何实现轮播？#

门禁管理#

1.门禁事件消息无法上报#

2.下发人脸接口返回512006subpicAnalysisModelingError、pictureModelingFailed建模失败或badParameters参数错误#

3.下发人脸接口返回”512006 unknown”#

4.删除人员接口返回512107设备型号不支持#

5.门禁设备人脸识别成功，但是门没有联动打开#

6.人员下发接口返回人员下发失败 comparisonTimeRangeError#

7.卡下发接口返回卡下发失败 searchDataBaseElementError#

8.人员下发接口返回人员下发失败beyondARGSRangeLimit#

9.批量下发接口返回成功，但是查看设备上的人员信息没有记录#

10.门禁下发的人员到了有效期会删除么？#

11.注册的设备下发了人脸，当设备注销之后人脸还能识别成功#

消息通道#

1.消息通道拉取不到消息#

2.消息通道消费到的消息重复#

3.接口返回514006租户未开通消息通道#

4.接口返回514004消费者数量已达上限#

5.消息通道的消息最大保存多久？#

其他#

1.设备ID和通道ID是不变的吗？#

2.设备抓图接口返回20006网络异常#

3.云台控制接口返回”该设备不支持云台控制”#

4.IOS拍摄的人脸照片调用人脸评分接口返回人脸质量差#

5.收不到设备报警消息#

接口调用

1.接口返回Http状态码401

2.接口返回Http状态码503、429

3.接口返回Http状态码404

4.接口返回Http状态码301、302

5.接口返回510001参数错误

设备管理

1.添加设备时返回”设备不在线/设备不存在”

2.添加设备时返回”设备型号不支持”

3.添加设备时返回”设备已被别人添加”

4.添加设备时返回”未开通XXXX服务或接入已达上限”

5.添加设备返回”510207设备添加成功，通道同步失败，请手动同步刷新”

6.调用接口返回”设备不存在”

7.调用接口返回”设备不在线”

8.调用接口返回”设备响应超时”

9.设备查询接口/设备列表页面的设备在线状态与实际情况不符

10.接口返回无效数据

视频集成

1.SDK初始化或Web视频控件初始化报错”账号配置异常”、”子账号不存在”

2.调用获取标准流预览地址接口返回”地址未绑定”

3.Web视频控件无法预览视频，报错”502012验证码错误”

4.视频可以正常预览，回放报错”400036验证码错误”

5.视频预览/回放报错”110031用户没有权限”

6.视频预览报错400901

7.Web视频控件预览错误码0

8.SDK Demo、Web视频控件Demo集成错误

9.SDK集成之后有文件冲突

10.SDK初始化后无法预览，但是demo是可以正常预览的

11.视频可以正常预览，但是无法回放，报错5405流媒体向设备发送或接受信令超时/cas响应超时

12.视频标准流预览报错视频编码类型非H264

13.控件预览视频报错525454不支持的码流类型

14.视频控件初始化时如何设置清晰度？

15.webDemo中的FireTransFunction是做什么用的

16.视频回放提示没有录像文件

17.标准流预览清晰度为什么很低？

18.视频控件如何设置分屏数？

19.视频控件如何实现轮播？

门禁管理

1.门禁事件消息无法上报

2.下发人脸接口返回512006subpicAnalysisModelingError、pictureModelingFailed建模失败或badParameters参数错误

3.下发人脸接口返回”512006 unknown”

4.删除人员接口返回512107设备型号不支持

5.门禁设备人脸识别成功，但是门没有联动打开

6.人员下发接口返回人员下发失败 comparisonTimeRangeError

7.卡下发接口返回卡下发失败 searchDataBaseElementError

8.人员下发接口返回人员下发失败beyondARGSRangeLimit

9.批量下发接口返回成功，但是查看设备上的人员信息没有记录

10.门禁下发的人员到了有效期会删除么？

11.注册的设备下发了人脸，当设备注销之后人脸还能识别成功

消息通道

1.消息通道拉取不到消息

2.消息通道消费到的消息重复

3.接口返回514006租户未开通消息通道

4.接口返回514004消费者数量已达上限

5.消息通道的消息最大保存多久？

其他

1.设备ID和通道ID是不变的吗？

2.设备抓图接口返回20006网络异常

3.云台控制接口返回”该设备不支持云台控制”

4.IOS拍摄的人脸照片调用人脸评分接口返回人脸质量差

5.收不到设备报警消息