Agent-Powered Reminder Development

Available APIs

The agent-powered reminder feature provides APIs for publishing background reminders. You can call these APIs to create scheduled reminders for countdown timers, calendar events, and alarm clocks. The APIs are encapsulated in the reminderAgentManager class.

Table 1 Major APIs in reminderAgentManager

How to Develop

1. Request the ohos.permission.PUBLISH_AGENT_REMINDER permission. For details, see Permission Application Guide.

2. Enable the notification feature.

3. Import the modules.

   import reminderAgentManager from '@ohos.reminderAgentManager';
   import NotificationManager from '@ohos.notificationManager';
   

4. Define a reminder agent. You can define the following types of reminder agents based on project requirements.

   • Countdown timer

     let targetReminderAgent: reminderAgentManager.ReminderRequestTimer = {
       reminderType: reminderAgentManager.ReminderType.REMINDER_TYPE_TIMER, // The reminder type is countdown timer.
       triggerTimeInSeconds: 10,
       actionButton: [ // Set the button type and title displayed in the reminder notification. The Close and Snooze types are supported, and the Snooze type must be used together with the snoozeTimes and timeInterval parameters.
         {
           title: 'close',
           type: reminderAgentManager.ActionButtonType.ACTION_BUTTON_TYPE_CLOSE
         }
       ],
       wantAgent: {// Information about the target UIAbility that is displayed after the reminder notification is touched.
         pkgName: 'com.example.myapplication',
         abilityName: 'EntryAbility'
       },
       maxScreenWantAgent: {// Information about the target ability that is automatically started when the specified reminder time arrives is displayed in full screen.
         pkgName: 'com.example.myapplication',
         abilityName: 'EntryAbility'
       },
       title: 'this is title', // Reminder title.
       title: 'this is title', // Reminder content.
       expiredContent: 'this reminder has expired', // Content to be displayed after the reminder expires.
       notificationId: 100, // Notification ID used by the reminder. If there are reminders with the same notification ID, the later one will overwrite the earlier one.
       slotType: NotificationManager.SlotType.SOCIAL_COMMUNICATION // Type of the slot used by the reminder.
     }
     

   • Calendar event

     let targetReminderAgent: reminderAgentManager.ReminderRequestCalendar = {
       reminderType: reminderAgentManager.ReminderType.REMINDER_TYPE_CALENDAR, // The reminder type is calendar event.
       dateTime: { // Reminder time.
         year: 2023,
         month: 7,
         day: 30,
         hour: 11,
         minute: 14,
         second: 30
       },
       repeatMonths: [1], // Month in which the reminder repeats.
       repeatDays: [1], // Date on which the reminder repeats.
       actionButton: [ // Set the button type and title displayed in the reminder notification. The Close and Snooze types are supported, and the Snooze type must be used together with the snoozeTimes and timeInterval parameters.
         {
           title: 'close',
           type: reminderAgentManager.ActionButtonType.ACTION_BUTTON_TYPE_CLOSE
         },
         {
           title: 'snooze',
           type: reminderAgentManager.ActionButtonType.ACTION_BUTTON_TYPE_SNOOZE
         },
       ],
       wantAgent: {// Information about the target UIAbility that is displayed after the reminder notification is touched.
         pkgName: 'com.example.myapplication',
         abilityName: 'EntryAbility'
       },
       maxScreenWantAgent: { // Information about the target UIAbility that is displayed after the reminder notification is touched.
         pkgName: 'com.example.myapplication',
         abilityName: 'EntryAbility'
       },
       ringDuration: 5, // Ringing duration, in seconds.
       snoozeTimes: 2, // Number of reminder snooze times.
       timeInterval: 5, // Reminder snooze interval, in seconds.
       title: 'this is title', // Reminder title.
       content:'this is content', // Reminder content.
       expiredContent: 'this reminder has expired', // Content to be displayed after the reminder expires.
       snoozeContent: 'remind later', // Content to be displayed when the reminder is snoozed.
       notificationId: 100, // Notification ID used by the reminder. If there are reminders with the same notification ID, the later one will overwrite the earlier one.
       slotType: NotificationManager.SlotType.SOCIAL_COMMUNICATION // Type of the slot used by the reminder.
     }
     

   • Alarm clock

     let targetReminderAgent: reminderAgentManager.ReminderRequestAlarm = {
       reminderType: reminderAgentManager.ReminderType.REMINDER_TYPE_ALARM, // The reminder type is alarm clock.
       hour: 23, // Hour portion of the reminder time.
       minute: 9, // Minute portion of the reminder time.
       daysOfWeek: [2], // Days of a week when the reminder repeats..
       actionButton: [ // Set the button type and title displayed in the reminder notification. The Close and Snooze types are supported, and the Snooze type must be used together with the snoozeTimes and timeInterval parameters.
         {
           title: 'close',
           type: reminderAgentManager.ActionButtonType.ACTION_BUTTON_TYPE_CLOSE
         },
         {
           title: 'snooze',
           type: reminderAgentManager.ActionButtonType.ACTION_BUTTON_TYPE_SNOOZE
         },
       ],
       wantAgent: {// Information about the target UIAbility that is displayed after the reminder notification is touched.
         pkgName: 'com.example.myapplication',
         abilityName: 'EntryAbility'
       },
       maxScreenWantAgent: { // Information about the target UIAbility that is displayed after the reminder notification is touched.
         pkgName: 'com.example.myapplication',
         abilityName: 'EntryAbility'
       },
       ringDuration: 5, // Ringing duration, in seconds.
       snoozeTimes: 2, // Number of reminder snooze times.
       timeInterval: 5, // Reminder snooze interval, in seconds.
       title: 'this is title', // Reminder title.
       content: 'this is content', // Reminder content.
       expiredContent: 'this reminder has expired', // Content to be displayed after the reminder expires.
       snoozeContent: 'remind later', // Content to be displayed when the reminder is snoozed.
       notificationId: 99, // Notification ID used by the reminder. If there are reminders with the same notification ID, the later one will overwrite the earlier one.
       slotType: NotificationManager.SlotType.SOCIAL_COMMUNICATION // Type of the slot used by the reminder.
     }
     

5. Publish the reminder agent. After the agent is published, your application can use the agent-powered reminder feature.

   try {
     reminderAgentManager.publishReminder(targetReminderAgent).then(res => {
       console.info('publishReminder promise reminderId: ' + res);
       let reminderId: number = res;
       // ...
     }).catch(err => {
       console.info('publishReminder err code: ' + err.code + ' message:' + err.message);
     })
   } catch (error) {
     console.info('publishReminder code: ' + error.code + ' message:' + error.message);
   }
   

   The following figure shows the running effect of an alarm clock.

   

6. To delete a reminder task, call reminderAgentManager.cancelReminder().

   let reminderId = 0; // The reminderId is obtained from the callback after the agent is published.
   
   try {
       reminderAgentManager.cancelReminder(reminderId).then(() => {
           console.log("cancelReminder promise");
       }).catch(err => {
           console.log("promise err code: " + err.code + ", message:" + err.message);
       });
   } catch (error) {
       console.log("cancelReminder code: " + error.code + ", message: " + error.message);
   };