开始使用
  • English
  • 简体中文
前往官网
开始使用
  • English
  • 简体中文
前往官网
  • 开始使用
  • 核心概念
  • 开发指南
  • 设备能力与事件参考
    • 按设备类型浏览
    • 设备能力
      • 通用方法
      • 侦测与告警
        • 布撤防
        • 关注区域
        • 客流
        • 哭声
        • 离岗
        • 人脸识别
        • 跌倒
        • 手势呼叫
        • 区域入侵
        • 徘徊
        • 未成年检测
        • 人车混合
        • 动检
          • detection.motion.enabled(获取移动检测开关属性)
          • detection.motion.enabled(设置移动检测开关属性)
          • detection.motion.sensitivity(获取动检灵敏度属性)
          • detection.motion.sensitivity(设置动检灵敏度属性)
          • detection.motion.range(获取侦测范围属性)
          • detection.motion.range(设置侦测范围属性)
          • detection.motion.distance(获取检测距离属性)
          • detection.motion.distance(设置检测距离属性)
          • detection.motion.region(获取检测区域属性)
          • detection.motion.region(设置检测区域属性)
          • detection.motion.maxRange(获取检测区域最大范围属性)
          • detection.motion.plan(获取检测时间段属性)
          • detection.motion.plan(设置检测时间段属性)
          • detection.motion.tracking(获取动检跟踪属性)
          • detection.motion.tracking(设置动检跟踪属性)
          • detection.motion.metadata(获取动检报警原数据)
          • detection.motion.detected(移动检测报警)
        • 视频遮挡
        • 车辆违停
        • 人形
        • 宠物
        • PIR
        • 车牌识别
        • 车辆守卫
        • 警笛
        • 语音呼救
        • 异常音
        • 越线
        • 无人出现
        • 车辆
        • 门磁
        • 防拆
        • 门控配件
        • 环境传感
        • 目标检测框
      • 图像
      • 云台
      • 灯光
      • 录像
      • 音频
      • 媒体
      • 网络
      • 电源
      • 隐私
      • 呼叫
      • 存储
      • 系统
      • 算法
      • 设备维护
      • 控制
    • 事件总览
    • 权限码
    • 错误码
    • 告警与能力消息
    • 常见问题
    • 历史能力与推送类型
  • API 参考
  • SDK 与工具
  • 方案
  • 平台与支持
本页目录
功能详情
上报字段说明
样例
最小权限

detection.motion.detected(移动检测报警)

detection.motion.detected:移动检测报警

detection.motion.detected · 通道级 · 消息查询权限 Alarm

功能详情

标准推送以 capabilityEvent 与本页 msgType 为准;消息 list/search 亦可能命中历史 msg_type,以 device.capability.list 与消息查询为准。 事件字段见 事件专页。

动检触发时上报。compose 事件:多路 源合并为同一 msgType=detection.motion.detected,outputData 以设备实际上报为准,常见为 {} 或仅含 extendContext(部分机型)。收这条推送需要订阅 capabilityEvent。见 接收设备消息、setMessageCallback。

上报字段说明

下表为 可能 出现在 outputData 中的字段(非每条上报都带)。动检推送一般还会带缩略图、告警图,有联动云录像时还有 token;开通智见时还有文案和标签。见 接收设备消息。

参数名说明类型必填取值
extendContext扩展上下文。含 handleBit。struct否含 handleBit
extendContext.handleBit处理掩码。范围 0~999,步长 1。int否0~999,步长 1

样例

常见空业务字段:

{
 "msgType": "detection.motion.detected",
 "deviceId": "TESTIPC000012345",
 "productId": "56WGTET2",
 "channelId": "0",
 "outputData": {},
 "time": 1673406989,
 "localTime": "20230111T111629",
 "alarmId": "116257862023505xxxx"
}

部分机型含 extendContext:

{
 "msgType": "detection.motion.detected",
 "deviceId": "TESTIPC000012345",
 "productId": "56WGTET2",
 "channelId": "0",
 "outputData": {
 "extendContext": {
 "handleBit": 1
 }
 },
 "time": 1673406989,
 "localTime": "20230111T111629",
 "alarmId": "116257862023505xxxx",
 "token": "f2dc8c09eeae4b5bad6abf522c93d825",
 "thumbUrl": "https://example.imou.com/pic/thumb.jpg",
 "picUrlArray": [
 "https://example.imou.com/pic/frame1.jpg",
 "https://example.imou.com/pic/frame2.jpg"
 ],
 "labelType": "humanAlarm",
 "aiCopyWriting": "穿黑衣服的男子从门店骑车经过",
 "securityRiskLevel": 1,
 "aiTag": ["人", "车"]
}

最小权限

管理员操作自己绑定的设备不需要权限。操作被分享设备需要报警消息权限。子用户绑定不需要。子账号需要 Alarm。列表/检索按条过滤无权事件。动检。

detection.motion.metadata(获取动检报警原数据)
detection.occlusion.enabled(获取视频遮挡开关属性)