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

  • 云直播开发指南

  • 轻应用开发指南

  • 小程序对接指南

  • 移动应用开发指南

  • 桌面应用开发指南

  • 消息推送

  • 云转存

  • 国标GB28181设备接入

  • IOT物模型

  • HTTP接口

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

      • 设备直播

      • 设备管理

      • 设备配置

      • 设备操作

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

      • 设备消息

      • 设备托管

      • 设备锁接入

    • 账户对接

    • 推送配置

    • 云存储服务

    • AI服务

    • AI智见服务

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

  • 服务支持

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

setDeviceSnap设备抓图

setDeviceSnap:设备抓图

功能详情

设备抓图,支持抓图频率1次/3s。

客户端请求时间间隔需大于等于3s。

备注:

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

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

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

请求地址

https://openapi.lechange.cn/openapi/setDeviceSnap

接口请求格式

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

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

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

传入参数说明

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

样例输入

{
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign":"1f239a40a252ef1190fc8b1e61bb8b44",
        "time":1603369597,
        "nonce":"755263ee-7301-43c9-9d65-464f0febfc80"
    },
    "id":"c8dd3f09-554b-41dc-8616-76889952e24e",
    "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/7aa3f5dd3bf1436a87ca1828aad382c3.jpg?Expires=1603974670&OSSAccessKeyId=LTAIP4igXeEjYBoG&Signature=4f7U%2Bgbu3pZXUlL36K14MxFU0IA%3D"
        }
    },
    "id":"c8dd3f09-554b-41dc-8616-76889952e24e"
}
设备操作说明
setDeviceSnapEnhanced设备抓图