detection.motion.detected (Motion detection alarm)

detection.motion.detected: Motion detection alarm

detection.motion.detected · Channel scope · Message query permission Alarm

What it does

Reported when motion is detected. Compose event: multiple sources merge into msgType detection.motion.detected; outputData follows the device ({} or extendContext only on some models). Subscribe to capabilityEvent in callbackFlag. See Receive device messages, setMessageCallback, Event catalog, and Overview and common payload.

Reported fields

Fields below may appear in outputData (not on every push). Motion pushes often include thumbnails, alarm images, optional token for linked cloud recording, and AI copy/tags when enabled. See Receive device messages.

Name	Description	Type	Required	Values
`extendContext`	Extended context.	`struct`	no	contains `handleBit`
`extendContext.handleBit`	Processing mask. Range 0–999, step 1.	`int`	no	`0`–`999`, step `1`

Example

Typical empty business payload:

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

Some models include 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": "A man in black clothing rode past the store",
 "securityRiskLevel": 1,
 "aiTag": ["person", "vehicle"]
}

Minimum permission

The administrator does not need an extra permission on a device they bound. A shared device needs the alarm-message permission. A bound sub-user does not. A sub-account needs Alarm. list/search filters out events you are not allowed to see.Motion detection。