闹钟与提醒
通过 @tuya-miniapp/cloud-api 的 echolink 模块管理智能音箱设备的闹钟和提醒。
接入前提
- 使用包含下列接口的
@tuya-miniapp/cloud-api版本;各接口的最低版本见对应接口页。 - 用户已登录,且具有目标设备的访问权限。
- 小程序已获授权使用“智能音箱闹钟与提醒能力”(Smart Speaker Clock and Reminder Capability)。
接口列表
调用流程
- 调用
getEcholinkClockList查询闹钟,或调用getEcholinkAlarmList查询提醒。列表记录位于返回对象的data字段。 - 调用
addEcholinkClock添加闹钟。该接口返回布尔值;添加后重新查询列表获取闹钟 ID。 - 使用列表返回的
timeId修改、删除或启停闹钟;删除提醒同样使用提醒列表中的timeId。 - 修改闹钟会同时启用该闹钟。需要停用时,再调用
enableEcholinkClock并传入enable: false。
调用说明
- 这 7 个接口均通过 Highway 使用 POST 请求,SDK 将参数放入请求体(body);两个列表接口也使用 POST。
- 创建、修改、删除及启停操作返回布尔值,业务结果可能为
false,调用方需要检查返回值。 - 本能力提供提醒列表查询和删除接口;闹钟和提醒是两类不同的记录,请使用各自对应的接口。