Get started
  • English
  • 简体中文
Official Site
Get started
  • English
  • 简体中文
Official Site
  • Get started
  • Concepts
  • Guides
  • Device capabilities & events
    • Browse by device type
    • Device capabilities
      • Common methods
      • Detection and alarms
        • Arming
        • Attention zone
        • People counting
        • Cry detection
        • Absence from post
        • Face recognition
        • Fall detection
        • Gesture call
        • Intrusion
        • Loitering
        • Minor detection
        • Person and vehicle mix
        • Motion detection
        • Video occlusion
        • Illegal parking
        • Person detection
          • detection.person.enabled (Read person detection switch)
          • detection.person.enabled (Set person detection switch)
          • detection.person.sensitivity (Read person sensitivity)
          • detection.person.sensitivity (Set person sensitivity)
          • detection.person.plan (Read person arming schedule)
          • detection.person.plan (Set person arming schedule)
          • detection.person.frame (Read person bounding box)
          • detection.person.frame (Set person bounding box)
          • detection.person.tracking (Read smart tracking)
          • detection.person.tracking (Set smart tracking)
          • detection.person.trackRegion (Read close-up tracking region)
          • detection.person.trackRegion (Set close-up tracking region)
          • detection.person.detected (Human detected)
        • Pet detection
        • PIR
        • License plate recognition
        • Vehicle guard
        • Siren
        • Voice SOS
        • Abnormal sound
        • Tripwire
        • Unoccupied detection
        • Vehicle
        • Door contact
        • Tamper
        • Gate accessory
        • Environment sensing
        • Target detection frame
      • Image
      • PTZ
      • Light
      • Recording
      • Audio
      • Media
      • Network
      • Power
      • Privacy
      • Call
      • Storage
      • System
      • Algorithm
      • Maintenance
      • Control
    • Events overview
    • Permission codes
    • Capability error codes
    • Alarm and capability messages
    • Capability FAQ
    • Legacy ability and push types
  • API reference
  • SDK and tools
  • Solutions
  • Platform and support
On this page
What it does
Reported fields
Example
Minimum permission
Related

detection.person.detected (Human detected)

detection.person.detected: Human detected

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

What it does

Reported when a person is detected. Compose event merges idents such as e_aiHuman into detection.person.detected. Subscribe to capabilityEvent in callbackFlag. See Receive device messages, setMessageCallback, Event catalog, and Overview and common payload.

Reported fields

This event always has outputData {}. Thumbnails and picUrlArray: Overview and common payload and Receive device messages.

Example

{
 "msgType": "detection.person.detected",
 "deviceId": "TESTIPC000012345",
 "productId": "56WGTET2",
 "channelId": "0",
 "outputData": {},
 "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"
 ]
}

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.

Related

  • Event catalog
  • Overview and common payload
  • Receive device messages
  • Person detection
detection.person.trackRegion (Set close-up tracking region)
detection.pet.enabled (Read pet detection switch)