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
      • Recording
      • Audio
      • Media
      • Network
      • Power
      • Privacy
      • Call
      • Storage
      • System
      • Algorithm
      • Maintenance
      • Control
        • Infrared remote
        • Outlet and switching
          • control.outlet.countdownFailed (Countdown failed event)
          • control.outlet.countdownFinished (Countdown finished event)
          • control.outlet.overload (Power overload)
          • control.outlet.switch2Switched (Switch channel 2 changed)
          • control.outlet.switch3Switched (Switch channel 3 changed)
          • control.outlet.switched (Switch state changed)
          • control.outlet.timerFailed (Timer task failed event)
          • control.outlet.timerFinished (Timer task finished event)
          • control.outlet.childLock (Get child lock property)
          • control.outlet.enabled (Get switch / relay state property)
          • control.outlet.externalSwitchType (Get external switch type property)
          • control.outlet.masterEnabled (Read master switch)
          • control.outlet.multiControl (Get multi-channel switch property)
          • control.outlet.operationMode (Get switch operation mode property)
          • control.outlet.overchargeProtection (Read overcharge protection)
          • control.outlet.powerSaving (Get auto power-saving property)
          • control.outlet.pulseDuration (Read pulse duration)
          • control.outlet.restartState (Get multi-channel restart state property)
          • control.outlet.switch2Enabled (Read switch channel 2)
          • control.outlet.switch3Enabled (Read switch channel 3)
          • control.outlet.switch4Enabled (Read switch channel 4)
          • control.outlet.switch5Enabled (Read switch channel 5)
          • control.outlet.switch6Enabled (Read switch channel 6)
          • control.outlet.switchCount (Get switch count property)
          • control.outlet.countdownGet (Get countdown)
          • control.outlet.countdownSet (Set countdown)
          • control.outlet.taskList (Task list)
          • control.outlet.timerGet (Get timer)
          • control.outlet.timerList (Timer delay list)
          • control.outlet.timerSet (Set timer)
          • control.outlet.childLock (Set child lock property)
          • control.outlet.enabled (Set switch / relay state property)
          • control.outlet.externalSwitchType (Set external switch type property)
          • control.outlet.masterEnabled (Set master switch property)
          • control.outlet.multiControl (Set multi-channel switch property)
          • control.outlet.operationMode (Set switch operation mode property)
          • control.outlet.overchargeProtection (Set overcharge protection property)
          • control.outlet.powerSaving (Set auto power-saving property)
          • control.outlet.pulseDuration (Set pulse duration property)
          • control.outlet.restartState (Set multi-channel restart state property)
          • control.outlet.switch2Enabled (Set switch channel 2)
          • control.outlet.switch3Enabled (Set switch channel 3)
          • control.outlet.switch4Enabled (Set switch channel 4)
          • control.outlet.switch5Enabled (Set switch channel 5)
          • control.outlet.switch6Enabled (Set switch channel 6)
          • control.outlet.switchCount (Set switch count property)
        • Travel motor
        • Lock actuator
    • 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

control.outlet.timerFinished (Timer task finished event)

control.outlet.timerFinished: Timer task finished event

control.outlet.timerFinished · device scope · message query permission Alarm

What it does

Reported when a local timer from Set timer completes. Optional Get timer. See Receive device messages, Event catalog, and Overview and common payload.

Reported fields

chn / order mapping to Set timer / Get timer tasks varies by model.

NameDescriptionTypeRequiredValues
chnChannel indexintno0–255
orderTimer task indexintno1–255
actionRelay action after timerintno0 off; 1 on

Example

{
 "msgType": "control.outlet.timerFinished",
 "deviceId": "TESTIPC000012345",
 "productId": "56WGTET2",
 "outputData": {
 "chn": 0,
 "order": 1,
 "action": 0
 },
 "time": 1673406989,
 "localTime": "20230111T111629",
 "alarmId": "116257862023505xxxx"
}

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 and search filter out events you are not allowed to see. Outlet and switching.

control.outlet.timerFailed (Timer task failed event)
control.outlet.childLock (Get child lock property)