diff --git a/zh-cn/application-dev/notification/common-event.md b/zh-cn/application-dev/notification/common-event.md index 42319fb13e2dc2ca39e02b9e6789b6515f60223a..33af34aac4c374cfe452f20c8a40b6c3acd7b4b2 100644 --- a/zh-cn/application-dev/notification/common-event.md +++ b/zh-cn/application-dev/notification/common-event.md @@ -18,9 +18,9 @@ OpenHarmony通过CES（Common Event Service，公共事件服务）为应用程 ### 接口说明 | 接口名 | 接口描述 | | ---------------------------------------------------------------------------------------------- | ----------- | -| commonEvent.createSubscriber(subscribeInfo: CommonEventSubscribeInfo, callback: AsyncCallback) | 创建订阅者对象(callback) | -| commonEvent.createSubscriber(subscribeInfo: CommonEventSubscribeInfo) | 创建订阅者对象(promise) | -| commonEvent.subscribe(subscriber: CommonEventSubscriber, callback: AsyncCallback) | 订阅公共事件 | +| createSubscriber(subscribeInfo: CommonEventSubscribeInfo, callback: AsyncCallback) | 创建订阅者对象(callback) | +| createSubscriber(subscribeInfo: CommonEventSubscribeInfo) | 创建订阅者对象(promise) | +| subscribe(subscriber: CommonEventSubscriber, callback: AsyncCallback) | 订阅公共事件 | ### 开发步骤 1. 导入CommonEvent模块。 @@ -82,8 +82,8 @@ if (this.subscriber != null) { ### 接口说明 | 接口名 | 接口描述 | | ---------------------------------- | ------ | -| commonEvent.publish(event: string, callback: AsyncCallback) | 发布公共事件 | -| commonEvent.publish(event: string, options: CommonEventPublishData, callback: AsyncCallback) | 指定发布信息并发布公共事件 | +| publish(event: string, callback: AsyncCallback) | 发布公共事件 | +| publish(event: string, options: CommonEventPublishData, callback: AsyncCallback) | 指定发布信息并发布公共事件 | ### 开发步骤 #### 发布公共事件开发步骤 @@ -144,7 +144,7 @@ commonEvent.publish("event", options, (err) => { ### 接口说明 | 接口名 | 接口描述 | | ---------------------------------- | ------ | -| commonEvent.unsubscribe(subscriber: CommonEventSubscriber, callback?: AsyncCallback) | 取消订阅公共事件 | +| unsubscribe(subscriber: CommonEventSubscriber, callback?: AsyncCallback) | 取消订阅公共事件 | ### 开发步骤 1. 导入CommonEvent模块。 diff --git a/zh-cn/application-dev/notification/notification-brief.md b/zh-cn/application-dev/notification/notification-brief.md index d0d8d659a6b140218474b7b737bc2ac31de17c81..9eaa31851c87ed6d9f35a1f32a37a797eef45f38 100644 --- a/zh-cn/application-dev/notification/notification-brief.md +++ b/zh-cn/application-dev/notification/notification-brief.md @@ -1,24 +1,21 @@ # 公共事件与通知开发概述 -​ 公共事件与通知提供了应用程序向系统其他应用程序发布消息、接收来自系统或其他应用特定消息的能力，这些消息可以是新闻推送、广告通知或者预警信息。 +公共事件与通知提供了应用程序向系统其他应用程序发布消息、接收来自系统或其他应用特定消息的能力，这些消息可以是新闻推送、广告通知或者预警信息。 -​ CES（Common Event Service, 即公共事件服务）为应用程序提供发布、订阅及退订公共事件的能力。公共事件根据事件发送方不同可分为系统公共事件和自定义公共事件。 +CES（Common Event Service, 即公共事件服务）为应用程序提供发布、订阅及退订公共事件的能力。公共事件根据事件发送方不同可分为系统公共事件和自定义公共事件。 ![ces](figures/ces.png) - 系统公共事件：系统将收集到的事件信息，根据系统策略发送给订阅该事件的用户程序。 公共事件包括：终端设备用户可感知的亮灭屏事件，以及系统关键服务发布的系统事件（例如：USB插拔，网络连接，系统升级）等。 - - 自定义公共事件：由应用自身定义的期望特定订阅者可以接收到的公共事件，这些公共事件往往与应用自身的业务逻辑相关。 - ANS（Advanced Notification Service，即通知增强服务）为应用程序提供发布通知的能力。这些通知常见的使用场景如下： +ANS（Advanced Notification Service，即通知增强服务）为应用程序提供发布通知的能力。这些通知常见的使用场景如下： - - 显示接收到的短消息、即时通讯消息等； - - - 显示应用的推送消息，如广告、版本更新、新闻通知等； - - - 显示当前正在进行的事件，如播放音乐、导航信息、下载进度等。 +- 显示接收到的短消息、即时通讯消息等； +- 显示应用的推送消息，如广告、版本更新、新闻通知等； +- 显示当前正在进行的事件，如播放音乐、导航信息、下载进度等。 -​ 通知消息将显示在系统下拉菜单栏，用户可对通知消息进行删除操作，或点击通知触发进一步的操作。 +通知消息将显示在系统下拉菜单栏，用户可对通知消息进行删除操作，或点击通知触发进一步的操作。 ![ans](figures/ans.png) diff --git a/zh-cn/application-dev/reference/apis/js-apis-eventhub.md b/zh-cn/application-dev/reference/apis/js-apis-eventhub.md index 2a2ff2060ab6415a6e82d60944c73bb5673220cb..02420af54b470196cc8ca4ddac266174aaa808a2 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-eventhub.md +++ b/zh-cn/application-dev/reference/apis/js-apis-eventhub.md @@ -9,10 +9,10 @@ EventHub模块提供了事件中心，提供订阅、取消订阅、触发事件 ## 使用说明 -​在使用eventHub的功能前，需要通过Ability实例的成员变量context获取。 +在使用eventHub的功能前，需要通过Ability实例的成员变量context获取。 ```js -import Ability from '@ohos.application.Ability' +import Ability from '@ohos.application.Ability'; export default class MainAbility extends Ability { func1(){ console.log("func1 is called"); @@ -34,15 +34,15 @@ on(event: string, callback: Function): void; **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | event | string | 是 | 事件名称。 | - | callback | Function | 是 | 事件回调，事件触发后运行。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| event | string | 是 | 事件名称。 | +| callback | Function | 是 | 事件回调，事件触发后运行。 | **示例：** ```js - import Ability from '@ohos.application.Ability' + import Ability from '@ohos.application.Ability'; export default class MainAbility extends Ability { onForeground() { @@ -72,15 +72,15 @@ off(event: string, callback?: Function): void; **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | event | string | 是 | 事件名称。 | - | callback | Function | 否 | 事件回调。如果不传callback，则取消订阅该事件下所有callback。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| event | string | 是 | 事件名称。 | +| callback | Function | 否 | 事件回调。如果不传callback，则取消订阅该事件下所有callback。 | **示例：** ```js - import Ability from '@ohos.application.Ability' + import Ability from '@ohos.application.Ability'; export default class MainAbility extends Ability { onForeground() { @@ -110,15 +110,15 @@ emit(event: string, ...args: Object[]): void; **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------- | -------- | -------- | - | event | string | 是 | 事件名称。 | - | ...args | Object[] | 是 | 可变参数，事件触发时，传递给回调函数的参数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------- | -------- | -------- | +| event | string | 是 | 事件名称。 | +| ...args | Object[] | 是 | 可变参数，事件触发时，传递给回调函数的参数。 | **示例：** ```js - import Ability from '@ohos.application.Ability' + import Ability from '@ohos.application.Ability'; export default class MainAbility extends Ability { onForeground() {