海康云眸·连锁 API
    海康云眸·连锁 API
    • 产品介绍
    • 能力概览
    • 错误码表
    • 常见问题
    • 快速入门
      • 生成授权凭证
      • 接口调用说明
      • 生成access_token
        POST
    • 开发指南
      • 接口说明
      • 消息通道
    • 视频服务能力
      • 视频设备配置指南
      • 视频对接指南
      • 直播服务
      • 微信小程序接入视频服务
      • 视频集成方案
        • web视频控件
        • UIKIT
        • 标准流预览
        • 移动端SDK
          • Android
          • 错误码对照表
          • iOS
      • 直播服务
        • 开通直播间
        • 通过通道ID获取直播间地址
        • 关闭设备加密
      • 微信小程序接入视频服务
        • 1.开发指南
        • 2.小程序开发
        • 3.接口说明
          • 获取直播/回放RTMP地址
      • 取流认证
        GET
    • 设备数据
      • 修改通道名称
        POST
      • 通过门店ID查询设备通道列表
        GET
      • 通过门店编号查询设备通道列表
        GET
      • 查询所有设备通道列表
        GET
      • 通过设备序列号查询通道列表
        GET
      • 通过设备序列号查询设备录像存储记录
        GET
    • 设备能力
      • 云台控制
        • 开始云台控制
        • 停止云台控制
        • 根据通道Id查询预置点列表
        • 新增预置点
        • 调用预置点
        • 删除预置点
      • 设备抓图
        • 设备抓图
      • 修改报警能力开关
        • 修改报警能力开关
      • IO管理
        • 获取设备IO端口状态
        • 获取设备指定输出口信息
        • 配置设备指定输出口信息
        • IO输出
      • 探测器
        • 查询网关下探测器列表
        • 网关关联子设备
        • 网关解绑子设备
        • 修改子设备名称
        • 设置传感器状态
      • 云存储
        • 开通云存储
    • 门店数据
      • 获取门店列表
      • 门店布撤防状态查询
    • 客流统计
      • 通过门店ID查询客流数据
      • 通过门店编号查询客流数据
      • 查询客流数据
    • 区域热度
      • 查询区域热度配置
      • 查询驻足人次分布
      • 生成热度图
      • 获取热度图
      • 获取区域关注度配置
      • 区域关注度配置
    • POS单
      • POS单信息录入
    • 巡查服务
      • 查询自动抓图的图片数据
    • 开门事件
      • 开门事件
    • 消息通道
      • 创建消费者
      • 消费消息
      • 接口定义
      • 提交偏移量
    • 消息类型定义
      • 设备报警消息
    • 智能分析AI能力
      • 查询模型列表
      • 查询算法模型的训练版本
      • 获取算法训练版本详情
      • 图片回传
    • 身份认证
      POST
    • 获取门店区域组织节点全量列表
      GET

    常见问题

    接口调用#

    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.添加了3个设备,查询设备通道列表接口只返回了1个#

    A:客流设备的通道是不返回的

    视频集成#

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

    问题原因1:租户未添加设备
    解决办法1:先进入系统管理->设备管理页面添加设备
    问题原因2:租户未配置账号关联关系
    解决办法2:联系海康技术支持配置账号关联关系

    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
    img

    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-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分钟内没有消费会自动删除

    【海康云眸】API开发者 微信交流群

    用微信扫右侧二维码,加入【海康云眸】API开发者 交流群,互助沟通

    扫码加入交流群
    上一页
    错误码表
    下一页
    生成授权凭证
    Built with