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
      • Image
      • PTZ
      • Light
        • Red-blue alert light
        • Fill light
        • Indicator light
        • Infrared
        • Searchlight
        • White 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
Scope
Reader notes
Index in this folder

Light

Light

Scope

This domain covers fill light, red-blue alert light, white light, and other light properties and invokes. Siren schedules live under Detection · Siren (detection.siren), not here. JSON scalars for discrete properties may be numbers or strings—follow each page’s samples and response tables; do not copy types across subdomains.

Parameters and values are on the pages in this domain.

A sub-account needs Config. A shared device needs the basic configuration permission. The indicator light is device scope—do not send channelId. Fill light (light.fill) is device and channel scope—channelId is optional on get/set (see that subdomain). Other capabilities are channel scope; omitting channelId returns DV2007.

Reader notes

Start with Using capabilities. Call device.capability.list before you use IDs on this page. See Permission codes and Capability errors.

Index in this folder

CapabilityDescription
Red-blue alert lightSwitch, linkage, arming, countdown
Fill lightSensitivity, night distance
Indicator lightBreathing-light switch
InfraredInfrared mode
SearchlightSwitch
White lightSwitch, schedule, countdown