定时任务

涂鸦智能提供了基本的定时能力，支持设备定时（包括 WiFi 设备，蓝牙 Mesh 子设备，Zigbee 子设备）和群组定时。并封装了针对设备 dp 点的定时器信息的增删改查接口。APP 通过定时接口设置好定时器信息后，硬件模块会自动根据定时要求进行预订的操作。每个定时任务下可以包含多个定时器。如下图所示：

以下多个接口用到了 taskName 这个参数，具体可描述为一个分组，一个分组可以有多个定时器。每个定时属于或不属于一个分组，分组目前仅用于展示。例如一个开关可能有多个 dp 点，可以根据每个 dp 点设置一个定时分组，每个分组可以添加多个定时器，用于控制这个 dp 点各个时段的开启或关闭。

版本说明

从3.18.0版本新增一套定时接口，解决老接口存在的问题，(见旧版接口)
新版定时都在TuyaHomeSdk.getTimerInstance()中，

旧版定时接口在TuyaHomeSdk.getTimerManagerInstance() 中。

与旧版接口相比，新版接口有以下几点更新：

• 新增或更新定时器接口可以设置定时器开关状态
• 提供批量修改定时器状态接口
• 修复旧版关闭定时分组失效问题
• 提供分组定时删除功能

升级建议

旧版接口不再维护，建议升级到新版接口。升级需要将替换整套定时接口，使用旧版接口设置定时仍可以通过新版获取定时器列表获取。

增加定时任务

接口说明

每个设备或群组定时添加上限为30个

为 device 或 group 新增一个定时 timer 到指定的 task 下

void addTimer(TuyaTimerBuilder builder, final IResultCallback callback);

参数说明

TuyaTimerBuilder 及 IResultCallback 说明

示例代码

TuyaTimerBuilder builder = new TuyaTimerBuilder.Builder()
        .taskName(mTaskName)
        .devId(id)
        .deviceType(TimerDeviceTypeEnum.DEVICE)
        .actions(dps)
        .loops("1100011")
        .aliasName("Test")
        .status(1)
        .appPush(true)
        .build();
TuyaOSTimer.getTimerInstance().addTimer(builder, new IResultCallback() {
    @Override
    public void onSuccess() {
    }

    @Override
    public void onError(String errorCode, String errorMsg) {

    }
});

批量修改普通定时状态或删除定时器

接口说明

void updateTimerStatus(String devId,
                       TimerDeviceTypeEnum deviceTimerTypeEnum,
                       List<String> ids,
                       TimerUpdateEnum timerUpdateEnum,
                       final IResultCallback callback);

参数说明

示例代码

TuyaOSTimer.getTimerInstance().updateTimerStatus(mDevId,
        TimerDeviceTypeEnum.DEVICE,
        list,
        TimerUpdateEnum.DELETE,
        new IResultCallback() {
            @Override
            public void onError(String code, String error) {

            }

            @Override
            public void onSuccess() {

            }
        });

更新定时

接口说明

更新 device 或群组下指定 task 下的指定 timer 信息

void updateTimer(TuyaTimerBuilder builder, final IResultCallback callback);

参数说明

TuyaTimerBuilder 及 IResultCallback 说明

示例代码

TuyaTimerBuilder builder = new TuyaTimerBuilder.Builder()
        .timerId(Long.parseLong(alarmTimerBean.getGroupId()))
        .devId(id)
        .deviceType(TimerDeviceTypeEnum.DEVICE)
        .actions(dps)
        .loops("1111111")
        .aliasName("test")
        .status(1)
        .appPush(true)
        .build();
TuyaOSTimer.getTimerInstance().updateTimer(builder,
        new IResultCallback() {
            @Override
            public void onSuccess() {

            }

            @Override
            public void onError(String errorCode, String errorMsg) {

            }
        });

获取定时任务下所有定时

接口说明

获取 device 或群组下指定的 task 下的定时 timer

void getTimerList(String taskName, String devId,
                  TimerDeviceTypeEnum deviceTimerTypeEnum,
                  final ITuyaDataCallback<TimerTask> callback);

参数说明

回调参数 TimerTask 说明

示例代码

TuyaOSTimer.getTimerInstance().getTimerList(null, mGwId, TimerDeviceTypeEnum.DEVICE, new ITuyaDataCallback<TimerTask>() {
    @Override
    public void onSuccess(TimerTask timerTask) {

    }

    @Override
    public void onError(String errorCode, String errorMessage) {

    }
});

修改分类下所有定时任务状态或删除定时器

接口说明

void updateCategoryTimerStatus(String taskName, String devId, 
                               TimerDeviceTypeEnum deviceTimerTypeEnum,
                               TimerUpdateEnum timerUpdateEnum, 
                               IResultCallback callback);

参数说明

示例代码

TuyaOSTimer.getTimerInstance().
        updateCategoryTimerStatus(taskname, mDevId,
                TimerDeviceTypeEnum.DEVICE, TimerUpdateEnum.CLOSE,
                new IResultCallback() {
                    @Override
                    public void onSuccess() {

                    }

                    @Override
                    public void onError(String errorCode, String errorMsg) {

                    }
                });