---
title: 通用-定时
summary: 云定时与本地定时的区别、使用场景及开发方法，含定时增删改查接口说明。
---

## 通用-定时

### 功能介绍
- 定时分类：
  - 云定时
    - 使用范围：带网关或wifi设备使用
    - 应用场景：有网关下使用，整体体验较好，定时执行后可以有 App 通知提醒用户。
      - 优缺点：
        - 优点：
          - App 提醒功能
          - 允许远程操作定时
        - 缺点：
          - 如果断网，定时无法执行
  - 本地定时
    - 使用范围：无网关的设备，一般用于sigmesh或单点蓝牙设备（完整DP协议说明）或Beacon设备（22.2 Beacon 完整DP协议说明）
    - 应用场景：主要是在无网关的情况下，涂鸦云定时不能正常工作，此时需要定时能力的话，就需要本地定时，在客户端设置好定时后，下发定时dp给设备，后续设置的定时逻辑在设备端脱离网关本地执行。
    - 优缺点：
      - 优点：
        - 断网后仍可执行，稳定性较高
      - 缺点：
        - 无网关的话，需要直连手机

### 如何开发
- 如果设备支持云定时
  - 方法1、 可以直接调用[小程序模块组件](https://developer.tuya.com/material/library_oHEKLjj0/component?code=LampModuleSchedule) 实现。
    - 优点：支持主题修改；
    - 缺点：需要自定传入组件参数实现
  - 方法2、 可以直接调用[定时功能页](https://developer.tuya.com/material/library_oHEKLjj0/component?code=LampScheduleFunctional)实现。
    - 优点：实现功能快速；
    - 缺点：不支持主题修改
  - 方法3、 自行实现，依赖云定时增删改查接口：
      - [添加定时](https://developer.tuya.com/cn/miniapp/develop/miniapp/api/timer/base/addTimer)
      - [更新定时](https://developer.tuya.com/cn/miniapp/develop/miniapp/api/timer/base/updateTimer)
      - [删除定时](https://developer.tuya.com/cn/miniapp/develop/miniapp/api/timer/base/removeTimer)
      - [更新状态](https://developer.tuya.com/cn/miniapp/develop/miniapp/api/timer/base/updateTimerStatus)
      - [同步定时](https://developer.tuya.com/cn/miniapp/develop/miniapp/api/timer/base/syncTimerTask)

### 注意事项
暂无

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