Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
ca1a9d53
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
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看板
未验证
提交
ca1a9d53
编写于
12月 13, 2022
作者:
O
openharmony_ci
提交者:
Gitee
12月 13, 2022
浏览文件
操作
浏览文件
下载
差异文件
!12409 事件通知开发指南链接修改(monthly)
Merge pull request !12409 from FangJinliang/monthly_20221018
上级
6e7e03dd
620a4e3f
变更
6
隐藏空白更改
内联
并排
Showing
6 changed file
with
15 addition
and
15 deletion
+15
-15
zh-cn/application-dev/application-models/common-event-overview.md
...plication-dev/application-models/common-event-overview.md
+1
-1
zh-cn/application-dev/application-models/common-event-publish.md
...pplication-dev/application-models/common-event-publish.md
+2
-2
zh-cn/application-dev/application-models/common-event-subscription.md
...ation-dev/application-models/common-event-subscription.md
+4
-4
zh-cn/application-dev/notification/notification-enable.md
zh-cn/application-dev/notification/notification-enable.md
+4
-4
zh-cn/application-dev/notification/notification-subscription.md
...application-dev/notification/notification-subscription.md
+2
-2
zh-cn/application-dev/notification/progress-bar-notification.md
...application-dev/notification/progress-bar-notification.md
+2
-2
未找到文件。
zh-cn/application-dev/application-models/common-event-overview.md
浏览文件 @
ca1a9d53
...
...
@@ -7,7 +7,7 @@ OpenHarmony通过CES(Common Event Service,公共事件服务)为应用程
公共事件从系统角度可分为:系统公共事件和自定义公共事件。
-
系统公共事件:CES内部定义的公共事件,只有系统应用和系统服务才能发布,例如HAP安装,更新,卸载等公共事件。目前支持的系统公共事件详见
[
系统公共事件列表
](
../reference/apis/js-apis-commonEvent.md#support
)
。
-
系统公共事件:CES内部定义的公共事件,只有系统应用和系统服务才能发布,例如HAP安装,更新,卸载等公共事件。目前支持的系统公共事件详见
[
系统公共事件列表
](
../reference/apis/js-apis-commonEvent
Manager
.md#support
)
。
-
自定义公共事件:应用自定义一些公共事件用来实现跨进程的事件通信能力。
...
...
zh-cn/application-dev/application-models/common-event-publish.md
浏览文件 @
ca1a9d53
...
...
@@ -16,7 +16,7 @@
| 接口名 | 接口描述 |
| -------- | -------- |
| publish(event:
string,
callback:
AsyncCallback) | 发布公共事件。 |
| publish(event:
string,
options:
[CommonEventPublishData](../reference/apis/js-apis-commonEvent.md#commoneventpublishdata),
callback:
AsyncCallback) | 指定发布信息并发布公共事件。 |
| publish(event:
string,
options:
[CommonEventPublishData](../reference/apis/js-apis-commonEvent
Manager
.md#commoneventpublishdata),
callback:
AsyncCallback) | 指定发布信息并发布公共事件。 |
## 发布不携带信息的公共事件
...
...
@@ -45,7 +45,7 @@
## 发布携带信息的公共事件
携带信息的公共事件,可以发布为无序公共事件、有序公共事件和粘性事件,可以通过参数
[
CommonEventPublishData
](
../reference/apis/js-apis-commonEvent.md#commoneventpublishdata
)
的isOrdered、isSticky的字段进行设置。
携带信息的公共事件,可以发布为无序公共事件、有序公共事件和粘性事件,可以通过参数
[
CommonEventPublishData
](
../reference/apis/js-apis-commonEvent
Manager
.md#commoneventpublishdata
)
的isOrdered、isSticky的字段进行设置。
1.
导入CommonEvent模块。
...
...
zh-cn/application-dev/application-models/common-event-subscription.md
浏览文件 @
ca1a9d53
...
...
@@ -3,7 +3,7 @@
## 场景介绍
当需要订阅某个公共事件,获取该公共事件传递的参数时,需要创建一个订阅者对象,用于作为订阅公共事件的载体,订阅公共事件并获取公共事件传递而来的参数。订阅部分系统公共事件需要先
[
申请权限
](
../security/accesstoken-guidelines.md
)
,订阅这些事件所需要的权限请见
[
公共事件权限列表
](
../reference/apis/js-apis-commonEvent.md#support
)
。
当需要订阅某个公共事件,获取该公共事件传递的参数时,需要创建一个订阅者对象,用于作为订阅公共事件的载体,订阅公共事件并获取公共事件传递而来的参数。订阅部分系统公共事件需要先
[
申请权限
](
../security/accesstoken-guidelines.md
)
,订阅这些事件所需要的权限请见
[
公共事件权限列表
](
../reference/apis/js-apis-commonEvent
Manager
.md#support
)
。
## 接口说明
...
...
@@ -12,7 +12,7 @@
| 接口名 | 接口描述 |
| -------- | -------- |
| createSubscriber(subscribeInfo:
[CommonEventSubscribeInfo](../reference/apis/js-apis-commonEvent
.md#commoneventsubscribeinfo),
callback:
AsyncCallback
<
[CommonEventData](../reference/apis/js-apis-commonEvent
.md#commoneventdata)
>
):
void | 创建订阅者对象(callback) |
| createSubscriber(subscribeInfo:
[CommonEventSubscribeInfo](../reference/apis/js-apis-commonEvent
Manager.md#commoneventsubscribeinfo),
callback:
AsyncCallback
<
[CommonEventData](../reference/apis/js-apis-commonEventManager
.md#commoneventdata)
>
):
void | 创建订阅者对象(callback) |
| createSubscriber(subscribeInfo:
CommonEventSubscribeInfo):
Promise
<
CommonEventSubscriber
>
| 创建订阅者对象(promise) |
| subscribe(subscriber:
CommonEventSubscriber,
callback:
AsyncCallback):
void | 订阅公共事件 |
...
...
@@ -25,7 +25,7 @@
import
commonEvent
from
'
@ohos.commonEventManager
'
;
```
2.
创建订阅者信息,详细的订阅者信息数据类型及包含的参数请见
[
CommonEventSubscribeInfo
](
../reference/apis/js-apis-commonEvent.md#commoneventsubscribeinfo
)
文档介绍。
2.
创建订阅者信息,详细的订阅者信息数据类型及包含的参数请见
[
CommonEventSubscribeInfo
](
../reference/apis/js-apis-commonEvent
Manager
.md#commoneventsubscribeinfo
)
文档介绍。
```
ts
// 用于保存创建成功的订阅者对象,后续使用其完成订阅及退订的动作
...
...
@@ -51,7 +51,7 @@
})
```
4.
创建订阅回调函数,订阅回调函数会在接收到事件时触发。订阅回调函数返回的data内包含了公共事件的名称、发布者携带的数据等信息,公共事件数据的详细参数和数据类型请见
[
CommonEventData
](
../reference/apis/js-apis-commonEvent.md#commoneventdata
)
文档介绍。
4.
创建订阅回调函数,订阅回调函数会在接收到事件时触发。订阅回调函数返回的data内包含了公共事件的名称、发布者携带的数据等信息,公共事件数据的详细参数和数据类型请见
[
CommonEventData
](
../reference/apis/js-apis-commonEvent
Manager
.md#commoneventdata
)
文档介绍。
```
ts
// 订阅公共事件回调
...
...
zh-cn/application-dev/notification/notification-enable.md
浏览文件 @
ca1a9d53
# 使能通知开关
应用需要开启通知开关才能发送通知。开发者可以在通知发布前调用
[
requestEnableNotification()
](
../reference/apis/js-apis-notification
.md#notificationrequestenablenotification8
)
方法,弹窗让用户选择是否开启使能开关,仅弹窗一次,后续调用该接口不再弹窗。
应用需要开启通知开关才能发送通知。开发者可以在通知发布前调用
[
requestEnableNotification()
](
../reference/apis/js-apis-notification
Manager.md#notificationrequestenablenotification
)
方法,弹窗让用户选择是否开启使能开关,仅弹窗一次,后续调用该接口不再弹窗。
**图1**
使能通知开关示意图

...
...
@@ -9,7 +9,7 @@
-
点击“允许”后,则表示允许应用发送通知。
-
点击“取消”后,再次调用
[
requestEnableNotification()
](
../reference/apis/js-apis-notification
.md#notificationrequestenablenotification8
)
方法,则不再弹窗。此时如需要手动使能通知开关,操作步骤如下所示。
-
点击“取消”后,再次调用
[
requestEnableNotification()
](
../reference/apis/js-apis-notification
Manager.md#notificationrequestenablenotification
)
方法,则不再弹窗。此时如需要手动使能通知开关,操作步骤如下所示。
| ①从设备左上方下拉,进入通知界面 | ②点击右上角“设置”图标,进入通知界面,找到需要打开通知开关的应用 | ③打开“允许通知”开关 |
| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
...
...
@@ -18,14 +18,14 @@
## 接口说明
详细接口见
[
接口文档
](
../reference/apis/js-apis-notification
.md#notificationrequestenablenotification8
)
。
详细接口见
[
接口文档
](
../reference/apis/js-apis-notification
Manager.md#notificationrequestenablenotification
)
。
**表1**
通知开关接口功能介绍
|
**接口名**
|
**描述**
|
| -------- | -------- |
| isNotificationEnabled(bundle:
BundleOption,
callback:
AsyncCallback
<
boolean
>
):
void | 查询通知开关。
<br/>
**说明:**
<br/>
仅支持系统应用调用。 |
|
enableNotification
(bundle:
BundleOption,
enable:
boolean,
callback:
AsyncCallback
<
void
>
):
void | 设置通知开关。例如在“设置
>
应用和服务
>
应用管理”,进入对应应用信息的“通知管理”中设置通知开关状态。
<br/>
**说明:**
<br/>
仅支持系统应用调用。 |
|
setNotificationEnable
(bundle:
BundleOption,
enable:
boolean,
callback:
AsyncCallback
<
void
>
):
void | 设置通知开关。例如在“设置
>
应用和服务
>
应用管理”,进入对应应用信息的“通知管理”中设置通知开关状态。
<br/>
**说明:**
<br/>
仅支持系统应用调用。 |
| requestEnableNotification(callback:
AsyncCallback
<
void
>
):
void | 请求发送通知的许可,第一次调用弹窗供用户选择允许或禁止。 |
...
...
zh-cn/application-dev/notification/notification-subscription.md
浏览文件 @
ca1a9d53
...
...
@@ -9,7 +9,7 @@
## 接口说明
通知订阅主要接口如下。详细接口介绍请参见
[
API参考
](
../reference/apis/js-apis-notification
.md#notification%E6%A8%A1%E5%9D%97
)
。
通知订阅主要接口如下。详细接口介绍请参见
[
API参考
](
../reference/apis/js-apis-notification
Subscribe.md
)
。
**表1**
通知订阅接口介绍
...
...
@@ -35,7 +35,7 @@
## 开发步骤
1.
申请
`ohos.permission.NOTIFICATION_CONTROLLER`
权限,配置方式请参阅
[
访问控制授权申请指导
](
../security/accesstoken-guidelines.md
#stage%E6%A8%A1%E5%9E%8B
)
。
1.
申请
`ohos.permission.NOTIFICATION_CONTROLLER`
权限,配置方式请参阅
[
访问控制授权申请指导
](
../security/accesstoken-guidelines.md
)
。
2.
导入通知订阅模块。
...
...
zh-cn/application-dev/notification/progress-bar-notification.md
浏览文件 @
ca1a9d53
...
...
@@ -3,14 +3,14 @@
进度条通知也是常见的通知类型,主要应用于文件下载、事务处理进度显示。OpenHarmony提供了进度条模板,发布通知应用设置好进度条模板的属性值,如模板名、模板数据,通过通知子系统发送到通知栏显示。
目前系统模板仅支持进度条模板,通知模板
[
NotificationTemplate
](
../reference/apis/js-apis-notification
.md#notificationtemplate8
)
中的data参数为用户自定义数据,用于显示与模块相关的数据,效果示意如下图所示。
目前系统模板仅支持进度条模板,通知模板
[
NotificationTemplate
](
../reference/apis/js-apis-notification
Manager.md#notificationtemplate
)
中的data参数为用户自定义数据,用于显示与模块相关的数据,效果示意如下图所示。

## 接口说明
[
isSupportTemplate()
](
../reference/apis/js-apis-notification
.md#notificationissupporttemplate8
)
是查询模板是否支持接口,目前仅支持进度条模板。
[
isSupportTemplate()
](
../reference/apis/js-apis-notification
Manager.md#notificationissupporttemplate
)
是查询模板是否支持接口,目前仅支持进度条模板。
| | |
| -------- | -------- |
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录