calendarMemo

remindersAuth

addEvent

removeEvent

updateEvent

getAllEvent

getEventById

概述

calendarMemo 使用系统日历提供的接口，向系统日历中添加，删除，更新事件（比如：生日，开会，旅行等）， 当系统时间满足条件时，会触发相应的事件并提醒用户

remindersAuth

判断是否有访问提醒事项的权限

remindersAuth({params},callback(ret, err))

params

entityType：

  • 类型：字符串
  • 描述：（可选项）判断是提醒还是日历的权限状态
  • 默认：calendar
  • 取值范围：
    • calendar：日历
    • reminder：提醒

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    status: true,    //布尔型；是否有访问该功能权限；true（有权限）||false （无权限）
    details: ''      //字符串类型；权限详情，取值范围如下：
                     //notDetermined： 用户从未选择过权限
                     //restricted：无法访问手机提醒，该状态用户无法改变
                     //denied：户拒绝该应用访问手机提醒，或是访问手机提醒服务总开关处于关闭状态
                     //authorized：用户允许该程序可以访问手机提醒
}

示例代码

var privacy = api.require('calendarMemo');
privacy.remindersAuth(function(ret, err) {
    if (ret.status) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    } else {
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

iOS 系统

可提供的 1.0.0 及更高版本

addEvent

添加事件

addEvent({params}, callback(ret))

params

title：

  • 类型：字符串
  • 描述：事件的标题

description：

  • 类型：字符串
  • 描述：事件的描述

location：

  • 类型：字符串
  • 描述：（可选）地点

startTime：

  • 类型：字符串
  • 描述：开始时间
  • 格式：2016-10-01 13:20:30

endTime:

  • 类型：字符串
  • 描述：结束时间
  • 格式：2016-10-01 13:20:30

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    eventId: id             //字符类型；创建成功后返回的事件类型
}

示例代码

    var calendarMemo = api.require('calendarMemo');
    calendarMemo.addEvent({
        title: '标题',
        description: '描述',
        startTime: '2016-10-01 13:00:00',
        endTime: '2016-10-01 14:00:00'
    }, function(ret) {});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

removeEvent

删除事件

removeEvent(callback(ret))

params

eventId:

  • 类型：字符串
  • 描述：待删除事件的id

callback(ret)

  • 类型：JSON 对象
  • 内部字段：
{
    status: true             // 布尔类型；是否删除成功
}

示例代码

    var calendarMemo = api.require('calendarMemo');
    calendarMemo.removeEvent({
        eventId: ''
    }, function(ret) {
        if (ret.status) {
            api.alert({
            msg: JSON.stringify(ret)
        })
        }
    });

updateEvent

更新事件

params

eventId:

  • 类型：字符串
  • 描述：待更新事件的id

title：

  • 类型：字符串
  • 描述：事件的标题

description：

  • 类型：字符串
  • 描述：事件的描述

location：

  • 类型：字符串
  • 描述：（可选）地点

startTime：

  • 类型：字符串
  • 描述：开始时间
  • 格式：2016-10-1 13:20:30

endTime:

  • 类型：字符串
  • 描述：结束时间
  • 格式：2016-10-1 13:20:30

callback(ret)

  • 类型：JSON 对象
  • 内部字段：
{
    status: true             // 布尔类型；是否更新成功
}

示例代码

    var calendarMemo = api.require('calendarMemo');
    calendarMemo.updateEvent({
        eventId:'',
        title:'标题1',
        description:'描述1',
        startTime:'2016-10-01 13:00:00',
        endTime  :'2016-10-01 14:00:00'
    }, function(ret){
        if(ret.status){
            api.alert({
            msg: JSON.stringify(ret)
        })
        }
    });

getAllEvent

获取所有的事件

params

startTime:

  • 类型：JSON 对象
  • 描述：（可选项）搜索的起始时间
  • 内部字段：
{
    years: '2018', //字符串类型；起始年份 ；默认：当前年份
    month: '08',  //字符串类型；起始月份 ；默认：当前月份
    day:'02'  //字符串类型；起始日；默认：当天
      
}

finishTime:

  • 类型：JSON 对象
  • 描述：（可选项）搜索的起始时间
  • 内部字段：
{
    years:'2019' , //字符串类型；终止年份 ；默认：2018
    month:'12' , //字符串类型；终止月份 ；默认：01
    day:'01'   //字符串类型；终止日 ；默认：01
      
}

callback(ret)

  • 类型：JSON 对象
  • 内部字段：
{
    result:[
        {	
            eventId:'',
            title:'',
            description:'',
            startTime:'',
            endTime:'',
            location:''
        }
    ]
}

示例代码

    var calendarMemo = api.require('calendarMemo');
    calendarMemo.getAllEvent({

        startTime:{
            years: 2018,
           month: 09,
           day:02
      
        },
        finishTime:{
            years: 2019,
           month: 12,
           day:01
      
        }
        

    },function(ret) {
        if (ret) {
            api.alert({
            msg: JSON.stringify(ret)
        })
        }
    });

getEventById

通过id获取事件

params

eventId:

  • 类型：字符串
  • 描述：待更新事件的id

callback(ret)

  • 类型：JSON 对象
  • 内部字段：
{
    event:{	
        
            eventId:'',     // 字符串; 事件ID
            title:'',       // 字符串; 事件的标题
            description:'', // 字符串; 事件的描述
            startTime:'',   // 字符串; 事件的开始时间
            endTime:'',     // 字符串; 事件的结束时间
            location:''     // 字符串; 事件的位置
            
        }
}

示例代码

    var calendarMemo = api.require('calendarMemo');
    calendarMemo.getEventById({
        eventId: ''
    }, function(ret) {
        if (ret) {
            api.alert({
            msg: JSON.stringify(ret)
        })
        }
    });
是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18