---
title: 通用-倒计时
summary: 倒计时功能，可设置多少分钟后开关灯，含 countdown DP 协议及取消条件说明。
---

## 通用-倒计时


### 功能介绍
- 倒计时可以设置当前灯具多长时间后关闭或开启。
  - 如果当前是开启，设置时长结束后就会关闭。
  - 如果当前是关闭，设置时长结束后就会开启。
### DP 协议
| DP code    | DP 含义 | DP 类型 | 备注 |
| -------- | ------- |------- |------- |
| countdown  | 倒计时    | 数值 | 0 - 1440 |

### 如何开发

- 根据 UI 交互进行 DP 的监听上报与下发
  - [具体监听与下发示例](/cn/miniapp/solution-panel/ability#dp-上报监听)


### 注意事项
- 在哪些情况下，倒计时功能会取消（清零）？
  1、面板下发倒计时DP为0（即通过控制面板中的清除按钮将倒计时取消或者将倒计时的时间重新设置为0小时0分钟）；
	2、倒计时执行计时周期内，设备开/关状态发生改变，包括设备本地按键控制、App 面板远程控制、定时控制执行等；
	3、设备断电重新上电或者模组重启。
- 倒计时上报时间间隔是多少？不是实时上报，需要面板自行倒数时间，所以面板上一般可能会有30s的误差，设备倒计时正常。
  1. Wi-Fi+BLE：30S

### 相关物料
- 【功能页】：
  1. [倒计时功能页](https://developer.tuya.com/material/library_oHEKLjj0/component?code=LampScheduleFunctional)
- 【组件】：
  1. [倒计时组件](https://developer.tuya.com/material/library_oHEKLjj0/component?code=ComponentsTyLamp&subCode=LampModuleSchedule)
  2. [倒计时弹窗组件](https://developer.tuya.com/material/library_oHEKLjj0/component?code=CountdownActionSheet)
- 【教程】：无
- 【SDK】：无
- 【API】：无