开发HarmonyOS应用时，如何集成并使用系统的日历事件提醒功能？

Question

开发HarmonyOS应用时，如何集成并使用系统的日历事件提醒功能？

Answer 1

目前可以通过以下方式尝试在 HarmonyOS 中集成系统日历事件提醒功能：当前只支持跳转至系统日历 App，不能传参数到日历中指定具体日期，示例代码如下：

import common from '@ohos.app.ability.common';
const context = getContext(this)
@Entry
@Component
struct Index{
  build(){
    Button("跳转到日历").onClick(()=>{
      let context = getContext(this) as common.UIAbilityContext;
      context.startAbility({
        bundleName: 'com.huawei.hmos.calendar',
        abilityName: 'MainAbility',
      });
    })
  }
}

另外，使用 reminderAgentManager.publishReminder 发布日历提醒时，需在 module.json5 中添加 ohos.permission.PUBLISH_AGENT_REMINDER 权限，并在调用方法时请求响应权限。但可能会遇到调试代码提示 NotificationBussinessError 1700001: Notification not enable 的问题，手动在设置页面开启 Notification 后，创建提醒成功，但是在系统的日历 app 中无法看到创建的提醒，示例代码如下：

public addCalendarEvent(title:string, description:string, reminderTime:number, previousTime:number, days:Array<number>,context:Context)
{
  let atManager = abilityAccessCtrl.createAtManager();
  try {
    atManager.requestPermissionsFromUser(context, ["ohos.permission.PUBLISH_AGENT_REMINDER","ohos.permission.WRITE_CALENDAR"], (err, data)=>{
      console.info("data:" + JSON.stringify(data));
      console.info("data permissions:" + data.permissions);
      console.info("data authResults:" + data.authResults);
      let timer:reminderAgentManager.ReminderRequestCalendar = {
        reminderType: reminderAgentManager.ReminderType.REMINDER_TYPE_CALENDAR,
        title:title,
        content:description,
      }
    })
  } catch (error) {
    console.error('Error requesting permissions:', error);
  }
}

Answer 2

在开发HarmonyOS（鸿蒙操作系统）应用时，集成并使用系统的日历事件提醒功能涉及多个步骤，主要包括添加权限、导入模块、定义提醒实例、发布提醒以及处理用户交互等。
添加后台代理提醒使用权限

首先，你需要在应用的配置文件中（如module.json）添加后台代理提醒的使用权限。这是使用系统日历事件提醒功能的前提。

"module": {  
    "requestPermissions": [  
        {  
            "name": "ohos.permission.PUBLISH_AGENT_REMINDER"  
        }  
    ]  
}

导入后台代理提醒模块

在你的HarmonyOS应用中，需要导入reminderAgentManager模块，以便使用其提供的提醒功能。

import reminderAgent from '@ohos.reminderAgentManager';

定义提醒实例

使用ReminderRequest类定义日历事件提醒的实例。这包括设置提醒的类型（如日历提醒）、时间、重复规则、标题、通知内容等。

let reminder = {  
    reminderType: reminderAgent.ReminderType.CALENDAR, // 设置为日历提醒  
    title: "会议提醒",  
    description: "下午2点有会议",  
    startDate: new Date(2024, 8, 21, 14, 0), // 注意月份是从0开始的  
    endDate: new Date(2024, 8, 21, 15, 0),  
    repeatType: reminderAgent.RepeatType.DAILY, // 可以设置为不重复、每天、每周等  
    ...  
};

注意：这里的reminderType、repeatType等需要根据reminderAgentManager模块提供的实际API进行调整，因为上述代码中的枚举值仅为示例。

reminderAgent.publishReminder(reminder, (err, reminderId) => {  
    if (err) {  
        console.error('发布提醒失败:', err);  
    } else {  
        console.log('提醒发布成功，提醒ID:', reminderId);  
    }  
});

发布提醒

使用reminderAgent.publishReminder方法发布定义的提醒实例。发布成功后，系统会在指定时间向用户发送提醒通知。