乐橙云开发文档
快速入门
  • 文档综述
  • 云直播开发指南
  • 轻应用开发指南
  • 移动应用开发指南
  • 桌面应用开发指南
  • 消息推送
  • 云转存
  • 国标GB28181设备接入
  • HTTP接口
  • 服务支持
前往官网
快速入门
  • 文档综述
  • 云直播开发指南
  • 轻应用开发指南
  • 移动应用开发指南
  • 桌面应用开发指南
  • 消息推送
  • 云转存
  • 国标GB28181设备接入
  • HTTP接口
  • 服务支持
前往官网
快速入门
  • 文档综述

  • 云直播开发指南

  • 轻应用开发指南

  • 小程序对接指南

  • 移动应用开发指南

  • 桌面应用开发指南

  • 消息推送

  • 云转存

  • 国标GB28181设备接入

  • IOT物模型

  • HTTP接口

    • API隐私协议
    • 开发规范
    • Postman按接口模拟调用教程
    • accessToken:获取管理员token
    • 设备

      • 设备直播

      • 设备管理

      • 设备配置

      • 设备操作

        • 设备操作说明
        • setDeviceSnap设备抓图
        • setDeviceSnapEnhanced设备抓图
        • 云台移动控制
        • 云台定位接口
        • 获取设备云台控制接口
        • 重启设备
        • 校准设备UTC时间
        • 查询设备UTC时间
      • 设备录像

      • 设备消息

      • 设备托管

      • 设备锁接入

    • 账户对接

    • 推送配置

    • 云存储服务

    • AI服务

    • AI智见服务

    • 设备能力集
    • 设备能力开关
    • 接口调用限制说明
    • 全局返回码说明
    • 云平台能力说明
    • 旧版本协议(后续不再维护)

  • 服务支持

本页目录
功能详情
请求地址
接口请求格式
子账户token请求所需最小权限
传入参数说明
样例输入
返回data字段说明
样例输出

setDeviceSnapEnhanced设备抓图

setDeviceSnapEnhanced:设备抓图(升级版)

功能详情

设备抓图升级版,支持抓图频率1次/每秒。

客户端请求时间间隔需大于等于1s,若客户端请求时间间隔小于1s,默认返回上一次抓图图片。返回结果中,抓图访问地址(url)2小时内有效。

备注:

建议开发者根据设备性能实测接口后,来确定使用哪个设备抓图接口:

若设备性能较好(每秒都可以处理并返回抓图图片),则建议开发者调用setDeviceSnapEnhanced接口;

若设备性能较差(主要针对2017年前上市的设备),则建议开发者调用setDeviceSnap接口进行设备抓图。

请求地址

https://openapi.lechange.cn/openapi/setDeviceSnapEnhanced

接口请求格式

接口请求方式及部分鉴权参数如sign等计算方式,请参考开发规范

子账户token请求所需最小权限

"Permission":"Capture" "Resource":"cam:序列号:通道号"

传入参数说明

参数名参数类型是否必填默认值合法值参数说明
tokenString是管理员或者子账户accessToken
deviceIdString是设备序列号
channelIdString是通道号

样例输入

{
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign":"52ddffc171940f637c340da8bcf9d959",
        "time":1603369692,
        "nonce":"63e74c29-a30d-4827-b8e1-691faec14e2b"
    },
    "id":"ad9a278f-bedd-4c06-ad4a-ea0a971836d1",
    "params":{
        "deviceId":"TESTQWERXXXX",
        "channelId":"0",
        "token":"At_00000ad9e6e87f0142eb92e207aec46a"
    }
}

返回data字段说明

字段名字段类型字段说明
urlString抓图访问地址

样例输出

{
    "result":{
        "msg":"操作成功。",
        "code":"0",
        "data":{
            "url":"https://lechangecloud.oss-cn-hangzhou.aliyuncs.com/lechange/TESTQWERXXXX_img/Alarm/0/956fe604722b45fba0e098ba6eae3178.jpg?Expires=1603974760&OSSAccessKeyId=LTAIP4igXeEjYBoG&Signature=gtfNjV7MJI%2BC%2By6cciWYXiDv4LI%3D"
        }
    },
    "id":"ad9a278f-bedd-4c06-ad4a-ea0a971836d1"
}
setDeviceSnap设备抓图
云台移动控制