普通小游戏开发
开放能力(必读)
社交转发裂变
数据分析
视频拍摄器
API
多端支持

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 需要用户授权方可调用,详细信息可参考用户授权
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助