tt.addPhoneCalendar
基础库 2.52.0 开始支持本方法,低版本需做兼容处理,这是一个异步方法。
本 API 需要用户授权方可调用,详细信息可参考用户授权
向系统日历添加重复事件。
语法
tt.addPhoneCalendar(options);
参数说明
options 为 object 类型,属性如下:
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
---|---|---|---|---|---|
title | string | 是 | 日历事件标题 | 2.52.0 | |
startTime | number | 是 | 开始时间的 unix 时间戳(1970年1月1日开始所经过的秒数,单位:秒) | 2.52.0 | |
allDay | boolean | false | 否 | 是否全天事件 | 2.52.0 |
description | string | 否 | 事件说明 | 2.52.0 | |
location | string | 否 | 事件位置 | 2.52.0 | |
endTime | number | 与startTime相同 | 否 | 结束时间的 unix 时间戳 | 2.52.0 |
alarm | boolean | true | 否 | 是否提醒 | 2.52.0 |
alarmOffset | number | 0 | 否 | 提醒提前量(单位:秒) | 2.52.0 |
success | function | 否 | 接口调用成功的回调函数 | 2.52.0 | |
fail | function | 否 | 接口调用失败的回调函数 | 2.52.0 | |
complete | function | 否 | 接口调用结束的回调函数 | 2.52.0 |
回调成功
object 类型,属性如下:
属性名 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
errMsg | string | "addPhoneCalendar:ok" | 2.52.0 |
回调失败
object 类型,属性如下:
errNo | errMsg | 说明 | 最低支持版本 |
---|---|---|---|
errMsg | string | "addPhoneCalendar:fail " + 错误详情 | 2.52.0 |
扫码体验
请使用字节宿主APP扫码
代码示例
tt.addPhoneCalendar({
title: "测试非重复事件",
startTime: Date.now() / 1000,
endTime: Date.now() / 1000 + 3600,
alarm: false,
location: "测试location",
description: "测试description",
success() {
console.log("添加桌面成功");
},
fail(res) {
console.log("添加桌面失败", err.errMsg);
},
});
Bug & Tip
- Tip:该 API 必须要由用户点击触发,也就是只能在
tt.onTouchEnd
的回调里面同步调用该 API。 - Tip:本 API 需要用户授权方可调用,详细信息可参考用户授权
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助