Emitter

說明：本模塊首批接口從API version 7開始支持。

導入模塊

import emitter from '@ohos.events.emitter'

權限列表

無

開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

EventPriority

用于表示事件被投遞的優先級。

系統能力 : 以下各項對應的系統能力均為 SystemCapability.Notification.Emitter

名稱	值	說明
IMMEDIATE	0	表示事件被立即投遞。
HIGH	1	表示事件先于LOW優先級投遞。
LOW	2	表示事件優于IDLE優先級投遞，事件的默認優先級是LOW。
IDLE	3	表示在沒有其他事件的情況下，才投遞該事件。

emitter.on

on(event: [InnerEvent], callback: Callback<[EventData]>): void

持續訂閱某個事件以及接收事件的回調處理。

系統能力 : SystemCapability.Notification.Emitter

參數：

參數名	類型	必填	說明
event	[InnerEvent]	是	持續訂閱的事件
callback	Callback<[EventData]>	是	接收訂閱事件時的回調處理

示例：

var innerEvent = {
    eventId: 1
};
var callback = (eventData) = > {
    console.info('callback');
};
emitter.on(innerEvent, callback);

emitter.once

once(event: [InnerEvent], callback: Callback<[EventData]>): void

單次訂閱某個事件以及接收事件的回調處理，接收到回調處理后自動取消訂閱。

系統能力 : SystemCapability.Notification.Emitter

參數：

參數名	類型	必填	說明
event	[InnerEvent]	是	單次訂閱的事件
callback	Callback<[EventData]>	是	接收訂閱事件時的回調處理

示例：

var innerEvent = {
    eventId: 1
};
var callback = (eventData) = > {
    console.info('once callback');
};
emitter.once(innerEvent, callback);

emitter.off

off(eventId: number): void

取消訂閱某個事件。

系統能力 : SystemCapability.Notification.Emitter

參數：

參數名	類型	必填	說明
eventId	number	是	事件ID

示例：

emitter.off(1);

emitter.emit

emit(event: InnerEvent, data?: EventData): void

發送一個事件到事件隊列。

系統能力 : SystemCapability.Notification.Emitter

參數：

參數名	類型	必填	說明
event	[InnerEvent]	是	發送的事件
data	[EventData]	否	事件攜帶的數據

示例：

var eventData = {
    data: {
        "content": "c",
        "id": 1,
    }};
var innerEvent = {
    eventId: 1,
    priority: emitter.EventPriority.HIGH
};
emitter.emit(innerEvent, eventData);

InnerEvent

進程內的事件。

系統能力 : 以下各項對應的系統能力均為 SystemCapability.Notification.Emitter

名稱	參數類型	可讀	可寫	說明
eventId	number	是	是	事件的ID，由開發者定義用來辨別事件。
priority	[EventPriority]	是	是	事件被投遞的優先級。`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`