语音闹钟

更新时间:2023-01-09 09:24:57

语音服务中可以通过对话触发闹钟/提醒等定时任务,闹钟服务模块对所有闹钟的资源进行了统一管理,包括更新通知、列表获取、删除等,下面将对各个接口的使用进行描述。

语音闹钟初始化

函数原型 OPERATE_RET tuya_iot_clock_init(TY_IOT_CLOCK_CBS_S *cb)
函数描述 初始化闹钟服务
参数说明 cb,闹钟更新回调
返回值 OPERATE_RET,0:成功; 其他:失败,详见错误码
详细描述 在 home_init_ex 中已集成,用户无需手动调用。只需在 home_init_ex 时将更新回调 cbs.clock_cbs.update_cb 配置即可(若该回调为 NULL,则不会启用语音闹钟功能)。

语音闹钟更新

函数原型 OPERATE_RET tuya_iot_clock_async()
函数描述 更新闹钟资源
参数说明 VOID
返回值 OPERATE_RET,0:成功; 其他:失败,详见错误码
详细描述 用户主动更新语音闹钟数据。

获取语音闹钟列表

函数原型 OPERATE_RET tuya_iot_clock_get_list(OUT TY_IOT_CLOCK_BRIEF_INFO_S **clock_list, OUT UINT_T *clock_num)
函数描述 获取语音闹钟列表
参数说明 clock_list,闹钟列表
clock_num,闹钟数量
返回值 OPERATE_RET,0:成功; 其他:失败,详见错误码
详细描述 用户获取语音闹钟列表,调用后需要调用 tuya_iot_clock_free_list,释放申请的资源。

释放语音闹钟列表

函数原型 OPERATE_RET tuya_iot_clock_free_list(IN TY_IOT_CLOCK_BRIEF_INFO_S *clock_list)
函数描述 释放语音闹钟列表资源
参数说明 clock_list,闹钟列表
返回值 OPERATE_RET,0:成功; 其他:失败,详见错误码
详细描述 用户释放语音闹钟列表资源

删除语音闹钟

函数原型 OPERATE_RET tuya_iot_clock_delete(IN TY_IOT_CLOCK_TYPE_E type, IN UINT64_T timerid)
函数描述 删除指定的语音闹钟
参数说明 type,闹钟/提醒,参照 TY_IOT_CLOCK_TYPE_E
timerid,闹钟唯一标识
返回值 OPERATE_RET,0:成功; 其他:失败,详见错误码
详细描述 用户释放指定语音闹钟资源