Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
5199b112
D
Docs
项目概览
OpenHarmony
/
Docs
12 个月 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
5199b112
编写于
1月 25, 2022
作者:
S
s00567680
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
add reminderAgent api doc
Signed-off-by:
N
s00567680
<
shirui721@huawei.com
>
上级
d87b30f7
变更
2
显示空白变更内容
内联
并排
Showing
2 changed file
with
497 addition
and
1 deletion
+497
-1
zh-cn/application-dev/reference/apis/Readme-CN.md
zh-cn/application-dev/reference/apis/Readme-CN.md
+3
-1
zh-cn/application-dev/reference/apis/js-apis-reminderAgent.md
...n/application-dev/reference/apis/js-apis-reminderAgent.md
+494
-0
未找到文件。
zh-cn/application-dev/reference/apis/Readme-CN.md
浏览文件 @
5199b112
...
@@ -6,9 +6,11 @@
...
@@ -6,9 +6,11 @@
-
[
DataAbilityHelper模块
](
js-apis-dataAbilityHelper.md
)
-
[
DataAbilityHelper模块
](
js-apis-dataAbilityHelper.md
)
-
[
DataUriUtils模块
](
js-apis-DataUriUtils.md
)
-
[
DataUriUtils模块
](
js-apis-DataUriUtils.md
)
-
[
Bundle模块
](
js-apis-Bundle.md
)
-
[
Bundle模块
](
js-apis-Bundle.md
)
-
[
Context模块
](
js-apis-Context.md
)
-
事件与通知
-
[
CommonEvent模块
](
js-apis-commonEvent.md
)
-
[
CommonEvent模块
](
js-apis-commonEvent.md
)
-
[
Notification模块
](
js-apis-notification.md
)
-
[
Notification模块
](
js-apis-notification.md
)
-
[
Context模块
](
js-apis-Contex
t.md
)
-
[
后台代理提醒
](
js-apis-reminderAgen
t.md
)
-
资源管理
-
资源管理
-
[
资源管理
](
js-apis-resource-manager.md
)
-
[
资源管理
](
js-apis-resource-manager.md
)
-
[
国际化-Intl
](
js-apis-intl.md
)
-
[
国际化-Intl
](
js-apis-intl.md
)
...
...
zh-cn/application-dev/reference/apis/js-apis-reminderAgent.md
0 → 100644
浏览文件 @
5199b112
# 后台代理提醒
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
import reminderAgent from'@ohos.reminderAgent';
```
## 权限
ohos.permission.PUBLISH_AGENT_REMINDER
## reminderAgent.publishReminder
publishReminder(reminderReq: ReminderRequest, callback: AsyncCallback
<
number
>
): void
发布一个后台代理提醒,使用callback方式实现异步调用。
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| reminderReq |
[
ReminderRequest
](
#reminderrequest
)
| 是 | 需要发布的提醒实例。 |
| callback | AsyncCallback
<
number
>
| 是 | 异步回调,返回当前发布的提醒的reminderId。 |
-
示例:
```
export default { data: {timer: {
reminderType: reminderAgent.ReminderType.REMINDER_TYPE_TIMER,
triggerTimeInSeconds: 3
}
},
startTimer() {
reminderAgent.publishReminder(timer, (err, reminderId) => { console.log("reminderId = " + reminderId);
});
}
}
```
## reminderAgent.publishReminder
publishReminder(reminderReq: ReminderRequest): Promise
<
number
>
发布一个后台代理提醒,使用Promise方式实现异步调用。
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| reminderReq |
[
ReminderRequest
](
#reminderrequest
)
| 是 | 需要发布的提醒实例。 |
-
返回值:
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
number
>
| 返回提醒的reminderId。 |
-
示例
```
export default { data: {timer: {
reminderType: reminderAgent.ReminderType.REMINDER_TYPE_TIMER,
triggerTimeInSeconds: 3
}
},
startTimer() {
reminderAgent.publishReminder(this.timer).then((reminderId) => {
console.log("reminderId = " + reminderId);
});
}
}
```
## reminderAgent.cancelReminder
cancelReminder(reminderId: number, callback: AsyncCallback
<
void
>
): void
取消指定id的提醒,使用callback方式实现异步调用。
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| reminderId | number | 是 | 目标reminder的id号。 |
| callback | AsyncCallback
<
void
>
| 是 | 异步回调。 |
-
示例
```
export default {
cancel() { reminderAgent.cancelReminder(1, (err, data) => {
console.log("do next");
});
}
}
```
## reminderAgent.cancelReminder
cancelReminder(reminderId: number): Promise
<
void
>
取消指定id的提醒,使用Promise方式实现异步调用。
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| reminderId | number | 是 | 目标reminder的id号。 |
-
返回值
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| Promise类型异步回调。 |
-
示例
```
export default {
cancel() {
reminderAgent.cancelReminder(1).then(() => {
console.log("do next");
});
}
}
```
## reminderAgent.getValidReminders
getValidReminders(callback: AsyncCallback
<
Array
<
ReminderRequest
>>
): void
获取当前应用已设置的所有有效(未过期)的提醒,使用callback方式实现异步调用。
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
Array
<
[ReminderRequest](#reminderrequest)
>>
| 是 | 异步回调,返回当前应用已设置的所有有效(未过期)的提醒。 |
-
示例
```
reminderAgent.getValidReminders((err, reminders) => {
for (let i = 0; i < reminders.length; i++) {
console.log("getValidReminders = " + reminders[i]);
console.log("getValidReminders, reminderType = " + reminders[i].reminderType);
for (let j = 0; j < reminders[i].actionButton.length; j++) {
console.log("getValidReminders, actionButton.title = " + reminders[i].actionButton[j].title);
console.log("getValidReminders, actionButton.type = " + reminders[i].actionButton[j].type);
}
console.log("getValidReminders, wantAgent.pkgName = " + reminders[i].wantAgent.pkgName);
console.log("getValidReminders, wantAgent.abilityName = " + reminders[i].wantAgent.abilityName);
console.log("getValidReminders, maxScreenWantAgent.pkgName = " + reminders[i].maxScreenWantAgent.pkgName);
console.log("getValidReminders, maxScreenWantAgent.abilityName = " + reminders[i].maxScreenWantAgent.abilityName);
console.log("getValidReminders, ringDuration = " + reminders[i].ringDuration);
console.log("getValidReminders, snoozeTimes = " + reminders[i].snoozeTimes);
console.log("getValidReminders, timeInterval = " + reminders[i].timeInterval);
console.log("getValidReminders, title = " + reminders[i].title);
console.log("getValidReminders, content = " + reminders[i].content);
console.log("getValidReminders, expiredContent = " + reminders[i].expiredContent);
console.log("getValidReminders, snoozeContent = " + reminders[i].snoozeContent);
console.log("getValidReminders, notificationId = " + reminders[i].notificationId);
console.log("getValidReminders, slotType = " + reminders[i].slotType);
}
})
```
## reminderAgent.getValidReminders
getValidReminders(): Promise
<
Array
<
ReminderRequest
>>
获取当前应用已设置的所有有效(未过期)的提醒,使用Promise方式实现异步调用。
-
返回值
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
Array
<
[ReminderRequest](#reminderrequest)
>>
| 返回当前应用已设置的所有有效(未过期)的提醒。 |
-
示例
```
reminderAgent.getValidReminders().then((reminders) => {
for (let i = 0; i < reminders.length; i++) {
console.log("getValidReminders = " + reminders[i]);
console.log("getValidReminders, reminderType = " + reminders[i].reminderType);
for (let j = 0; j < reminders[i].actionButton.length; j++) {
console.log("getValidReminders, actionButton.title = " + reminders[i].actionButton[j].title);
console.log("getValidReminders, actionButton.type = " + reminders[i].actionButton[j].type);
}
console.log("getValidReminders, wantAgent.pkgName = " + reminders[i].wantAgent.pkgName);
console.log("getValidReminders, wantAgent.abilityName = " + reminders[i].wantAgent.abilityName);
console.log("getValidReminders, maxScreenWantAgent.pkgName = " + reminders[i].maxScreenWantAgent.pkgName);
console.log("getValidReminders, maxScreenWantAgent.abilityName = " + reminders[i].maxScreenWantAgent.abilityName);
console.log("getValidReminders, ringDuration = " + reminders[i].ringDuration);
console.log("getValidReminders, snoozeTimes = " + reminders[i].snoozeTimes);
console.log("getValidReminders, timeInterval = " + reminders[i].timeInterval);
console.log("getValidReminders, title = " + reminders[i].title);
console.log("getValidReminders, content = " + reminders[i].content);
console.log("getValidReminders, expiredContent = " + reminders[i].expiredContent);
console.log("getValidReminders, snoozeContent = " + reminders[i].snoozeContent);
console.log("getValidReminders, notificationId = " + reminders[i].notificationId);
console.log("getValidReminders, slotType = " + reminders[i].slotType);
}
})
```
## reminderAgent.cancelAllReminders
cancelAllReminders(callback: AsyncCallback
<
void
>
): void
取消当前应用所有的提醒,使用callback方式实现异步调用。
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
void
>
| 是 | 异步回调。 |
-
示例
```
reminderAgent.cancelAllReminders((err, data) =>{
console.log("do next")})
```
## reminderAgent.cancelAllReminders
cancelAllReminders(): Promise
<
void
>
取消当前应用所有的提醒,使用Promise方式实现异步调用。
-
返回值
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| Promise类型异步回调。 |
-
示例
```
reminderAgent.cancelAllReminders().then(() => {
console.log("do next")})
```
## reminderAgent.addNotificationSlot
addNotificationSlot(slot: NotificationSlot, callback: AsyncCallback
<
void
>
): void
添加一个NotificationSlot,使用callback方式实现异步调用。
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| slot |
[
ERROR:Invalid link:zh-cn_topic_0000001158696346.xml#xref1954171018915,link:zh-cn_topic_0000001180018813.xml#section1382174172015
](
zh-cn_topic_0000001180018813.xml#section1382174172015
)
| 是 | notification
slot实例。 |
| callback | AsyncCallback
<
void
>
| 是 | 异步回调。 |
-
示例
```
export default { data: { mySlot: {
type: 3,
sound: "/sdcard/music2.mp3"
} },
addSlot() {
reminderAgent.addNotificationSlot(this.mySlot, (err, data) => {
console.log("do next");
});
}
}
```
## reminderAgent.addNotificationSlot
addNotificationSlot(slot: NotificationSlot): Promise
<
void
>
添加一个NotificationSlot,使用Promise方式实现异步调用。
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| slot |
[
ERROR:Invalid link:zh-cn_topic_0000001158696346.xml#xref2049924012917,link:zh-cn_topic_0000001180018813.xml#section1382174172015
](
zh-cn_topic_0000001180018813.xml#section1382174172015
)
| 是 | notification
slot实例。 |
-
返回值
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| Promise类型异步回调。 |
-
示例
```
export default { data: { mySlot: {
type: 3,
sound: "/sdcard/music2.mp3"
} },
addSlot() {
reminderAgent.addNotificationSlot(this.mySlot).then(() => {
console.log("do next");
});
}
}
```
## reminderAgent.removeNotificationSlot
removeNotificationSlot(slotType: notification.SlotType, callback: AsyncCallback
<
void
>
): void
删除目标NotificationSlot,使用callback方式实现异步调用。
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| slotType |
[
ERROR:Invalid link:zh-cn_topic_0000001158696346.xml#xref11228182975217,link:zh-cn_topic_0000001180018813.xml#section072355105110
](
zh-cn_topic_0000001180018813.xml#section072355105110
)
| 是 | 目标notification
slot的类型。 |
| callback | AsyncCallback
<
void
>
| 是 | 异步回调。 |
-
示例
```
export default {
removeSlot() {reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION, (err, data) => {
console.log("do next");
});
}
}
```
## reminderAgent.removeNotificationSlot
removeNotificationSlot(slotType: notification.SlotType): Promise
<
void
>
删除目标NotificationSlot,使用Promise方式实现异步调用。
-
参数
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| slotType |
[
ERROR:Invalid link:zh-cn_topic_0000001158696346.xml#xref1120863519109,link:zh-cn_topic_0000001180018813.xml#section072355105110
](
zh-cn_topic_0000001180018813.xml#section072355105110
)
| 是 | 目标notification
slot的类型。 |
-
返回值
| 类型 | 说明 |
| -------- | -------- |
| Promise
<
void
>
| Promise类型异步回调。 |
-
示例
```
export default {
removeSlot() { reminderAgent.removeNotificationSlot(notification.SlotType.CONTENT_INFORMATION).then(() => {
console.log("do next");
});
}
}
```
## ActionButtonType
按钮的类型。
| 名称 | 默认值 | 说明 |
| -------- | -------- | -------- |
| ACTION_BUTTON_TYPE_CLOSE | 0 | 表示关闭提醒的按钮。 |
| ACTION_BUTTON_TYPE_SNOOZE | 1 | 表示延迟提醒的按钮。 |
## ReminderType
提醒的类型。
| 名称 | 默认值 | 说明 |
| -------- | -------- | -------- |
| REMINDER_TYPE_TIMER | 0 | 表示提醒类型:倒计时。 |
| REMINDER_TYPE_CALENDAR | 1 | 表示提醒类型:日历。 |
| REMINDER_TYPE_ALARM | 2 | 表示提醒类型:闹钟。 |
## ActionButton
用于设置弹出的提醒通知信息上显示的按钮类型和标题。
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| title | string | 是 | 按钮显示的标题。 |
| type |
[
ActionButtonType
](
#actionbuttontype
)
| 是 | 按钮的类型。 |
## WantAgent
点击提醒通知后跳转的目标ability信息。
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| pkgName | string | 是 | 指明点击提醒通知栏后跳转的目标hap包名。 |
| abilityName | string | 是 | 指明点击提醒通知栏后跳转的目标ability名称。 |
## MaxScreenWantAgent
提醒到达时自动拉起的目标ability信息。
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| pkgName | string | 是 | 指明提醒到达时自动拉起的目标hap包名(如果设备在使用中,则只弹出通知横幅框)。 |
| abilityName | string | 是 | 指明提醒到达时自动拉起的目标ability名(如果设备在使用中,则只弹出通知横幅框)。 |
## ReminderRequest
提醒实例对象,用于设置提醒类型、响铃时长等具体信息。
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| reminderType | ReminderType | 是 | 指明提醒类型。 |
| actionButton | [ActionButton?,
ActionButton?] | 否 | 弹出的提醒通知栏中显示的按钮(参数可选,支持0/1/2个按钮)。 |
| wantAgent | WantAgent | 否 | 点击通知后需要跳转的目标ability信息。 |
| maxScreenWantAgent | MaxScreenWantAgent | 否 | 提醒到达时跳转的目标包。如果设备正在使用中,则弹出一个通知框。 |
| ringDuration | number | 否 | 指明响铃时长。 |
| snoozeTimes | number | 否 | 指明延迟提醒次数。 |
| timeInterval | number | 否 | 执行延迟提醒间隔。 |
| title | string | 否 | 指明提醒标题。 |
| content | string | 否 | 指明提醒内容。 |
| expiredContent | string | 否 | 指明提醒过期后需要显示的内容。 |
| snoozeContent | string | 否 | 指明延迟提醒时需要显示的内容。 |
| notificationId | number | 否 | 指明提醒使用的通知的id号,相同id号的提醒会覆盖。 |
| slotType |
[
ERROR:Invalid link:zh-cn_topic_0000001158696346.xml#xref39047351518,link:zh-cn_topic_0000001180018813.xml#section072355105110
](
zh-cn_topic_0000001180018813.xml#section072355105110
)
| 否 | 指明提醒的slot类型。 |
## ReminderRequestCalendar
ReminderRequestCalendar extends ReminderRequest
日历实例对象,用于设置提醒的时间。
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| dateTime |
[
LocalDateTime
](
#localdatetime
)
| 是 | 指明提醒的目标时间。 |
| repeatMonths | Array
<
number
>
| 否 | 指明重复提醒的月份。 |
| repeatDays | Array
<
number
>
| 否 | 指明重复提醒的日期。 |
## ReminderRequestAlarm
ReminderRequestAlarm extends ReminderRequest
闹钟实例对象,用于设置提醒的时间。
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| hour | number | 是 | 指明提醒的目标时刻。 |
| minute | number | 是 | 指明提醒的目标分钟。 |
| daysOfWeek | Array
<
number
>
| 否 | 指明每周哪几天需要重复提醒。 |
## ReminderRequestTimer
ReminderRequestTimer extends ReminderRequest
倒计时实例对象,用于设置提醒的时间。
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| triggerTimeInSeconds | number | 是 | 指明倒计时的秒数。 |
## LocalDateTime
用于日历类提醒设置时指定时间信息。
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| year | number | 是 | 年 |
| month | number | 是 | 月 |
| day | number | 是 | 日 |
| hour | number | 是 | 时 |
| minute | number | 是 | 分 |
| second | number | 否 | 秒 |
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录