Notification模塊

說明： 本模塊首批接口從API version 7開始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。

導入模塊

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

import Notification from '@ohos.notification';

Notification.publish

publish(request: NotificationRequest, callback: AsyncCallback): void

發布通知（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
request	是	否	[NotificationRequest]	是	設置要發布通知內容的NotificationRequest對象。
callback	是	否	AsyncCallback	是	被指定的回調方法。

示例：

//publish回調
function publishCallback(err) {
	console.info("========================== >publishCallback======================= >");
}
//通知Request對象
var notificationRequest = {
    id: 1,
    content: {
        contentType: Notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
        normal: {
            title: "test_title",
            text: "test_text",
            additionalText: "test_additionalText"
        }
    }
}
Notification.publish(notificationRequest, publishCallback)

Notification.publish

publish(request: NotificationRequest): Promise

發布通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

示例：

//通知Request對象
var notificationRequest = {
    notificationId: 1,
    content: {
        contentType: Notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
        normal: {
            title: "test_title",
            text: "test_text",
            additionalText: "test_additionalText"
        }
    }
}
Notification.publish(notificationRequest).then(() = > {
	console.info("========================== >publishCallback======================= >");
});

Notification.publish8+

publish(request: NotificationRequest, userId: number, callback: AsyncCallback): void

發布通知（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
request	是	否	[NotificationRequest]	是	設置要發布通知內容的NotificationRequest對象。
userId	是	否	number	是	接收通知用戶的Id。
callback	是	否	AsyncCallback	是	被指定的回調方法。

示例：

//publish回調
function publishCallback(err) {
	console.info("========================== >publishCallback======================= >");
}
// 接收通知的用戶ID
var userId = 1
//通知Request對象
var notificationRequest = {
    id: 1,
    content: {
        contentType: Notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
        normal: {
            title: "test_title",
            text: "test_text",
            additionalText: "test_additionalText"
        }
    }
}
Notification.publish(notificationRequest, userId, publishCallback);

Notification.publish8+

publish(request: NotificationRequest, userId: number): Promise

發布通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
request	是	否	[NotificationRequest]	是	設置要發布通知內容的NotificationRequest對象。
userId	是	否	number	是	接收通知用戶的Id。

示例：

var notificationRequest = {
    notificationId: 1,
    content: {
        contentType: Notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
        normal: {
            title: "test_title",
            text: "test_text",
            additionalText: "test_additionalText"
        }
    }
}

var userId = 1

Notification.publish(notificationRequest, userId).then(() = > {
	console.info("========================== >publishCallback======================= >");
});

Notification.cancel

cancel(id: number, label: string, callback: AsyncCallback): void

取消與指定id和label相匹配的已發布通知（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
id	是	否	number	是	通知ID。
label	是	否	string	是	通知標簽。
callback	是	否	AsyncCallback	是	表示被指定的回調方法。

示例：

//cancel回調
function cancelCallback(err) {
	console.info("========================== >cancelCallback======================= >");
}
Notification.cancel(0, "label", cancelCallback)

Notification.cancel

cancel(id: number, label?: string): Promise

取消與指定id相匹配的已發布通知，label可以指定也可以不指定（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
id	是	否	number	是	通知ID。
label	是	否	string	否	通知標簽。

示例：

Notification.cancel(0).then(() = > {
	console.info("========================== >cancelCallback======================= >");
});

Notification.cancel

cancel(id: number, callback: AsyncCallback): void

取消與指定id相匹配的已發布通知（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
id	是	否	number	是	通知ID。
callback	是	否	AsyncCallback	是	表示被指定的回調方法。

示例：

//cancel回調
function cancelCallback(err) {
	console.info("========================== >cancelCallback======================= >");
}
Notification.cancel(0, cancelCallback)

Notification.cancelAll

cancelAll(callback: AsyncCallback): void

取消所有已發布的通知（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
callback	是	否	AsyncCallback	是	表示被指定的回調方法。

示例：

//cancel回調
function cancelAllCallback(err) {
	console.info("========================== >cancelAllCallback======================= >");
}
Notification.cancelAll(cancelAllCallback)

Notification.cancelAll

cancelAll(): Promise

取消所有已發布的通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

示例：

Notification.cancelAll().then(() = > {
	console.info("========================== >cancelAllCallback======================= >");
});

Notification.addSlot

addSlot(slot: NotificationSlot, callback: AsyncCallback): void

創建通知通道（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
slot	是	否	[NotificationSlot]	是	要創建的通知通道對象。
callback	是	否	AsyncCallback	是	表示被指定的回調方法。

示例：

//addslot回調
function addSlotCallBack(err) {
	console.info("========================== >addSlotCallBack======================= >");
}
//通知slot對象
var notificationSlot = {
    type: Notification.SlotType.SOCIAL_COMMUNICATION
}
Notification.addSlot(notificationSlot, addSlotCallBack)

Notification.addSlot

addSlot(slot: NotificationSlot): Promise

創建通知通道（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
slot	是	否	[NotificationSlot]	是	要創建的通知通道對象。

示例：

//通知slot對象
var notificationSlot = {
    type: Notification.SlotType.SOCIAL_COMMUNICATION
}
Notification.addSlot(notificationSlot).then(() = > {
	console.info("========================== >addSlotCallback======================= >");
});

Notification.addSlot

addSlot(type: SlotType, callback: AsyncCallback): void

創建通知通道（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
type	是	否	[SlotType]	是	要創建的通知通道的類型。
callback	是	否	AsyncCallback	是	表示被指定的回調方法。

示例：

//addslot回調
function addSlotCallBack(err) {
	console.info("========================== >addSlotCallBack======================= >");
}
Notification.addSlot(Notification.SlotType.SOCIAL_COMMUNICATION, addSlotCallBack)

Notification.addSlot

addSlot(type: SlotType): Promise

創建通知通道（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
type	是	否	[SlotType]	是	要創建的通知通道的類型。

示例：

Notification.addSlot(Notification.SlotType.SOCIAL_COMMUNICATION).then(() = > {
	console.info("========================== >addSlotCallback======================= >");
});

Notification.addSlots

addSlots(slots: Array, callback: AsyncCallback): void

創建多個通知通道（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
slots	是	否	Array<[NotificationSlot]>	是	要創建的通知通道對象數組。
callback	是	否	AsyncCallback	是	表示被指定的回調方法。

示例：

//addSlots回調
function addSlotsCallBack(err) {
	console.info("========================== >addSlotsCallBack======================= >");
}
//通知slot對象
var notificationSlot = {
    type: Notification.SlotType.SOCIAL_COMMUNICATION
}
//通知slot array 對象
var notificationSlotArray = new Array();
notificationSlotArray[0] = notificationSlot;

Notification.addSlots(notificationSlotArray, addSlotsCallBack)

Notification.addSlots

addSlots(slots: Array): Promise

創建多個通知通道（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
slots	是	否	Array<[NotificationSlot]>	是	要創建的通知通道對象數組。

示例：

//通知slot對象
var notificationSlot = {
    type: Notification.SlotType.SOCIAL_COMMUNICATION
}
//通知slot array 對象
var notificationSlotArray = new Array();
notificationSlotArray[0] = notificationSlot;

Notification.addSlots(notificationSlotArray).then(() = > {
	console.info("========================== >addSlotCallback======================= >");
});

Notification.getSlot

getSlot(slotType: SlotType, callback: AsyncCallback): void

獲取一個通知通道（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
slotType	是	否	[SlotType]	是	通知渠道類型,目前分為社交通信、服務提醒、內容咨詢和其他類型。
callback	是	否	AsyncCallback<[NotificationSlot]>	是	表示被指定的回調方法。

示例：

//getSlot回調
function getSlotCallback(err,data) {
	console.info("========================== >getSlotCallback======================= >");
}
var slotType = Notification.SlotType.SOCIAL_COMMUNICATION;
Notification.getSlot(slotType, getSlotCallback)

Notification.getSlot

getSlot(slotType: SlotType): Promise

獲取一個通知通道（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
slotType	是	否	[SlotType]	是	通知渠道類型,目前分為社交通信、服務提醒、內容咨詢和其他類型。

返回值：

類型	說明
Promise	以Promise形式返回獲取一個通知通道。

示例：

var slotType = Notification.SlotType.SOCIAL_COMMUNICATION;
Notification.getSlot(slotType).then((data) = > {
	console.info("========================== >getSlotCallback======================= >");
});

Notification.getSlots

getSlots(callback: AsyncCallback>): void

獲取此應用程序的所有通知通道（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
callback	是	否	AsyncCallback<[NotificationSlot]>	是	表示被指定的回調方法。

示例：

//getSlots回調
function getSlotsCallback(err,data) {
	console.info("========================== >getSlotsCallback======================= >");
}
Notification.getSlots(getSlotsCallback)

Notification.getSlots

getSlots(): Promise>

獲取此應用程序的所有通知通道（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

返回值：

類型	說明
Promise>	以Promise形式返回獲取此應用程序的所有通知通道的結果。

示例：

Notification.getSlots().then((data) = > {
	console.info("========================== >getSlotsCallback======================= >");
});

Notification.removeSlot

removeSlot(slotType: SlotType, callback: AsyncCallback): void

根據通知通道類型刪除創建的通知通道（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
slotType	是	否	[SlotType]	是	通知渠道類型,目前分為社交通信、服務提醒、內容咨詢和其他類型。
callback	是	否	AsyncCallback	是	表示被指定的回調方法。

示例：

//removeSlot回調
function removeSlotCallback(err) {
	console.info("========================== >removeSlotCallback======================= >");
}
var slotType = Notification.SlotType.SOCIAL_COMMUNICATION;
Notification.removeSlot(slotType,removeSlotCallback)

Notification.removeSlot

removeSlot(slotType: SlotType): Promise

根據通知通道類型刪除創建的通知通道（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
slotType	是	否	[SlotType]	是	通知渠道類型,目前分為社交通信、服務提醒、內容咨詢和其他類型。

示例：

var slotType = Notification.SlotType.SOCIAL_COMMUNICATION;
Notification.removeSlot(slotType).then(() = > {
	console.info("========================== >removeSlotCallback======================= >");
});

Notification.removeAllSlots

removeAllSlots(callback: AsyncCallback): void

刪除所有通知通道（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
callback	是	否	AsyncCallback	是	表示被指定的回調方法。

示例：

function removeAllCallBack(err) {
	console.info("================ >removeAllCallBack======================= >");
}
Notification.removeAllSlots(removeAllCallBack)

Notification.removeAllSlots

removeAllSlots(): Promise

刪除所有通知通道（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

示例：

Notification.removeAllSlots().then(() = > {
	console.info("========================== >removeAllCallBack======================= >");
});

Notification.subscribe

subscribe(subscriber: NotificationSubscriber, info: NotificationSubscribeInfo, callback: AsyncCallback): void

訂閱通知并指定訂閱信息（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
subscriber	是	否	[NotificationSubscriber]	是	通知訂閱對象。
info	是	否	[NotificationSubscribeInfo]	是	訂閱信息。
callback	是	否	AsyncCallback	是	訂閱動作回調函數。

示例：

//subscribe回調
function subscribeCallback(err) {
	console.info("========================== >subscribeCallback======================= >");
}
function onConsumeCallback(data) {
	console.info("========================== >onConsumeCallback======================= >");
}
var subscriber = {
    onConsume: onConsumeCallback
}
var info = {
    bundleNames: ["bundleName1","bundleName2"]
}
Notification.subscribe(subscriber, info, subscribeCallback);

Notification.subscribe

subscribe(subscriber: NotificationSubscriber, callback: AsyncCallback): void

訂閱通知并指定訂閱信息（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
subscriber	是	否	[NotificationSubscriber]	是	通知訂閱對象。
callback	是	否	AsyncCallback	是	訂閱動作回調函數。

示例：

function subscribeCallback(err) {
	console.info("========================== >subscribeCallback======================= >");
}
function onConsumeCallback(data) {
	console.info("========================== >onConsumeCallback======================= >");
}
var subscriber = {
    onConsume: onConsumeCallback
}
Notification.subscribe(subscriber, subscribeCallback);

Notification.subscribe

subscribe(subscriber: NotificationSubscriber, info?: NotificationSubscribeInfo): Promise

訂閱通知并指定訂閱信息（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
subscriber	是	否	[NotificationSubscriber]	是	通知訂閱對象。
info	是	否	[NotificationSubscribeInfo]	否	訂閱信息。

示例：

function onConsumeCallback(data) {
	console.info("========================== >onConsumeCallback======================= >");
}
var subscriber = {
    onConsume: onConsumeCallback
};
Notification.subscribe(subscriber).then(() = > {
	console.info("========================== >subscribeCallback======================= >");
});

Notification.unsubscribe

unsubscribe(subscriber: NotificationSubscriber, callback: AsyncCallback): void

取消訂閱（callbcak形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
subscriber	是	否	[NotificationSubscriber]	是	通知訂閱對象。
callback	是	否	AsyncCallback	是	取消訂閱動作回調函數。

示例：

function unsubscribeCallback(err) {
	console.info("========================== >unsubscribeCallback======================= >");
}
function onConsumeCallback(data) {
	console.info("========================== >onConsumeCallback======================= >");
}
var subscriber = {
    onConsume: onConsumeCallback
}
Notification.unsubscribe(subscriber, unsubscribeCallback);

Notification.unsubscribe

unsubscribe(subscriber: NotificationSubscriber): Promise

取消訂閱（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
subscriber	是	否	[NotificationSubscriber]	是	通知訂閱對象。

示例：

function onConsumeCallback(data) {
	console.info("========================== >onConsumeCallback======================= >");
}
var subscriber = {
    onConsume: onConsumeCallback
};
Notification.unsubscribe(subscriber).then(() = > {
	console.info("========================== >unsubscribeCallback======================= >");
});

Notification.enableNotification

enableNotification(bundle: BundleOption, enable: boolean, callback: AsyncCallback): void

設定指定包的通知使能狀態（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
enable	是	否	boolean	是	使能狀態。
callback	是	否	AsyncCallback	是	設定通知使能回調函數。

示例：

function enableNotificationCallback(err) {
	console.info("========================== >enableNotificationCallback======================= >");
}
var bundle = {
    bundle: "bundleName1",
}
Notification.enableNotification(bundle, false, enableNotificationCallback);

Notification.enableNotification

enableNotification(bundle: BundleOption, enable: boolean): Promise

設定指定包的通知使能狀態（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
enable	是	否	boolean	是	使能狀態。

示例：

var bundle = {
    bundle: "bundleName1",
}
Notification.enableNotification(bundle, false).then(() = > {
	console.info("========================== >enableNotificationCallback======================= >");
});

Notification.isNotificationEnabled

isNotificationEnabled(bundle: BundleOption, callback: AsyncCallback): void

獲取指定包的通知使能狀態（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
callback	是	否	AsyncCallback	是	獲取通知使能狀態回調函數。

示例：

function isNotificationEnabledCallback(err, data) {
	console.info("========================== >isNotificationEnabledCallback======================= >");
}
var bundle = {
    bundle: "bundleName1",
}
Notification.isNotificationEnabled(bundle, isNotificationEnabledCallback);

Notification.isNotificationEnabled

isNotificationEnabled(bundle: BundleOption): Promise

獲取指定包的通知使能狀態（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。

返回值：

類型	說明
Promise	以Promise形式返回獲取指定包的通知使能狀態的結果。

示例：

var bundle = {
    bundle: "bundleName1",
}
Notification.isNotificationEnabled(bundle).then((data) = > {
	console.info("========================== >isNotificationEnabledCallback======================= >");
});

Notification.isNotificationEnabled

isNotificationEnabled(callback: AsyncCallback): void

獲取通知使能狀態（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
callback	是	否	AsyncCallback	是	獲取通知使能狀態回調函數。

示例：

function isNotificationEnabledCallback(err, data) {
	console.info("========================== >isNotificationEnabledCallback======================= >");
}

Notification.isNotificationEnabled(isNotificationEnabledCallback);

Notification.isNotificationEnabled

isNotificationEnabled(): Promise

獲取通知使能狀態（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。

返回值：

類型	說明
Promise	以Promise形式返回獲取通知使能狀態的結果。

示例：

Notification.isNotificationEnabled().then((data) = > {
	console.info("========================== >isNotificationEnabledCallback======================= >");
});

Notification.displayBadge

displayBadge(bundle: BundleOption, enable: boolean, callback: AsyncCallback): void

設定指定包的角標使能狀態（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
enable	是	否	boolean	是	使能狀態。
callback	是	否	AsyncCallback	是	設定角標使能回調函數。

示例：

function displayBadgeCallback(err) {
	console.info("========================== >displayBadgeCallback======================= >");
}
var bundle = {
    bundle: "bundleName1",
}
Notification.displayBadge(bundle, false, displayBadgeCallback);

Notification.displayBadge

displayBadge(bundle: BundleOption, enable: boolean): Promise

設定指定包的角標使能狀態（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
enable	是	否	boolean	是	使能狀態。

示例：

var bundle = {
    bundle: "bundleName1",
}
Notification.displayBadge(bundle, false).then(() = > {
	console.info("========================== >displayBadgeCallback======================= >");
});

Notification.isBadgeDisplayed

isBadgeDisplayed(bundle: BundleOption, callback: AsyncCallback): void

獲取指定包的角標使能狀態（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
callback	是	否	AsyncCallback	是	獲取角標使能狀態回調函數。

示例：

function isBadgeDisplayedCallback(err, data) {
	console.info("========================== >isBadgeDisplayedCallback======================= >");
}
var bundle = {
    bundle: "bundleName1",
}
Notification.isBadgeDisplayed(bundle, isBadgeDisplayedCallback);

Notification.isBadgeDisplayed

isBadgeDisplayed(bundle: BundleOption): Promise

獲取指定包的角標使能狀態（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。

返回值：

類型	說明
Promise	以Promise形式返回獲取指定包的角標使能狀態。

示例：

var bundle = {
    bundle: "bundleName1",
}
Notification.isBadgeDisplayed(bundle).then((data) = > {
	console.info("========================== >isBadgeDisplayedCallback======================= >");
});

Notification.setSlotByBundle

setSlotByBundle(bundle: BundleOption, slot: NotificationSlot, callback: AsyncCallback): void

設定指定包的通知通道狀態（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
slot	是	否	[NotificationSlot]	是	通知通道。
callback	是	否	AsyncCallback	是	設定通知通道回調函數。

示例：

function setSlotByBundleCallback(err) {
	console.info("========================== >setSlotByBundleCallback======================= >");
}
var bundle = {
    bundle: "bundleName1",
}
var notificationSlot = {
    type: Notification.SlotType.SOCIAL_COMMUNICATION
}
Notification.setSlotByBundle(bundle, notificationSlot, setSlotByBundleCallback);

Notification.setSlotByBundle

setSlotByBundle(bundle: BundleOption, slot: NotificationSlot): Promise

設定指定包的通知通道狀態（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
slot	是	否	[NotificationSlot]	是	使能狀態。

示例：

var bundle = {
    bundle: "bundleName1",
}
var notificationSlot = {
    type: Notification.SlotType.SOCIAL_COMMUNICATION
}
Notification.setSlotByBundle(bundle, notificationSlot).then(() = > {
	console.info("========================== >setSlotByBundleCallback======================= >");
});

Notification.getSlotsByBundle

getSlotsByBundle(bundle: BundleOption, callback: AsyncCallback>): void

獲取指定包的通知通道（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
callback	是	否	AsyncCallback>	是	獲取通知通道回調函數。

示例：

function getSlotsByBundleCallback(err, data) {
	console.info("========================== >getSlotsByBundleCallback======================= >");
}
var bundle = {
    bundle: "bundleName1",
}
Notification.getSlotsByBundle(bundle, getSlotsByBundleCallback);

Notification.getSlotsByBundle

getSlotsByBundle(bundle: BundleOption): Promise>

獲取指定包的通知通道（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。

返回值：

類型	說明
Promise>	以Promise形式返回獲取指定包的通知通道。

示例：

var bundle = {
    bundle: "bundleName1",
}
Notification.getSlotsByBundle(bundle).then((data) = > {
	console.info("========================== >getSlotsByBundleCallback======================= >");
});

Notification.getSlotNumByBundle

getSlotNumByBundle(bundle: BundleOption, callback: AsyncCallback): void

獲取指定包的通知通道數（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
callback	是	否	AsyncCallback	是	獲取通知通道數回調函數。

示例：

function getSlotNumByBundleCallback(err, data) {
	console.info("========================== >getSlotNumByBundleCallback======================= >");
}
var bundle = {
    bundle: "bundleName1",
}
Notification.getSlotNumByBundle(bundle, getSlotNumByBundleCallback);

Notification.getSlotNumByBundle

getSlotNumByBundle(bundle: BundleOption): Promise

獲取指定包的通知通道數（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。

返回值：

類型	說明
Promise	以Promise形式返回獲取指定包的通知通道數。

示例：

var bundle = {
    bundle: "bundleName1",
}
Notification.getSlotNumByBundle(bundle).then((data) = > {
	console.info("========================== >getSlotNumByBundleCallback======================= >");
});

Notification.remove

remove(bundle: BundleOption, notificationKey: NotificationKey, callback: AsyncCallback): void

刪除指定通知（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
notificationKey	是	否	[NotificationKey]	是	通知鍵值。
callback	是	否	AsyncCallback	是	刪除指定通知回調函數。

示例：

function removeCallback(err) {
	console.info("========================== >removeCallback======================= >");
}
var bundle = {
    bundle: "bundleName1",
}
var notificationKey = {
    id: 0,
    label: "label",
}
Notification.remove(bundle, notificationKey, removeCallback);

Notification.remove

remove(bundle: BundleOption, notificationKey: NotificationKey): Promise

刪除指定通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
notificationKey	是	否	[NotificationKey]	是	通知鍵值。

示例：

var bundle = {
    bundle: "bundleName1",
}
var notificationKey = {
    id: 0,
    label: "label",
}
Notification.remove(bundle, notificationKey).then(() = > {
	console.info("========================== >removeCallback======================= >");
});

Notification.remove

remove(hashCode: string, callback: AsyncCallback): void

刪除指定通知（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
hashCode	是	否	string	是	通知唯一ID。
callback	是	否	AsyncCallback	是	刪除指定通知回調函數。

示例：

var hashCode = 'hashCode'

function removeCallback(err) {
	console.info("========================== >removeCallback======================= >");
}

Notification.remove(hashCode, removeCallback);

Notification.remove

remove(hashCode: string): Promise

刪除指定通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
hashCode	是	否	string	是	通知唯一ID。

示例：

var hashCode = 'hashCode'

Notification.remove(hashCode).then(() = > {
	console.info("========================== >removeCallback======================= >");
});

Notification.removeAll

removeAll(bundle: BundleOption, callback: AsyncCallback): void

刪除指定包的所有通知（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
callback	是	否	AsyncCallback	是	刪除指定包的所有通知回調函數。

示例：

function removeAllCallback(err) {
	console.info("========================== >removeAllCallback======================= >");
}
var bundle = {
    bundle: "bundleName1",
}
Notification.removeAll(bundle, removeAllCallback);

Notification.removeAll

removeAll(callback: AsyncCallback): void

刪除所有通知（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
callback	是	否	AsyncCallback	是	刪除所有通知回調函數。

示例：

function removeAllCallback(err) {
	console.info("========================== >removeAllCallback======================= >");
}

Notification.removeAll(removeAllCallback);

Notification.removeAll

removeAll(bundle?: BundleOption): Promise

刪除所有通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	否	指定包信息。

示例：

Notification.removeAll().then(() = > {
	console.info("========================== >removeAllCallback======================= >");
});

Notification.removeAll8+

removeAll(userId: number, callback: AsyncCallback): void

刪除所有通知（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
userId	是	否	number	是	接收通知用戶的Id。
callback	是	否	AsyncCallback	是	刪除所有通知回調函數。

示例：

function removeAllCallback(err) {
	console.info("========================== >removeAllCallback======================= >");
}

var userId = 1

Notification.removeAll(userId, removeAllCallback);

Notification.removeAll8+

removeAll(userId: number): Promise

刪除所有通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
userId	是	否	number	是	接收通知用戶的Id。

示例：

function removeAllCallback(err) {
	console.info("========================== >removeAllCallback======================= >");
}

var userId = 1

Notification.removeAll(userId, removeAllCallback);

[](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Beta1/zh-cn/application-dev/reference/apis/js-apis-notification.md#notificationgetallactivenotifications)Notification.getAllActiveNotifications

getAllActiveNotifications(callback: AsyncCallback>): void

獲取活動通知（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
callback	是	否	AsyncCallback>	是	獲取活動通知回調函數。

示例：

function getAllActiveNotificationsCallback(err, data) {
	console.info("========================== >getAllActiveNotificationsCallback======================= >");
}

Notification.getAllActiveNotifications(getAllActiveNotificationsCallback);

Notification.getAllActiveNotifications

getAllActiveNotifications(): Promise>

獲取活動通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。removeGroupByBundle

返回值：

類型	說明
Promise>	以Promise形式返回獲取活動通知。

示例：

Notification.getAllActiveNotifications().then((data) = > {
	console.info("========================== >getAllActiveNotificationsCallback======================= >");
});

Notification.getActiveNotificationCount

getActiveNotificationCount(callback: AsyncCallback): void

獲取當前應用的活動通知數（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
callback	是	否	AsyncCallback	是	獲取活動通知數回調函數。

示例：

function getActiveNotificationCountCallback(err, data) {
	console.info("========================== >getActiveNotificationCountCallback======================= >");
}

Notification.getActiveNotificationCount(getActiveNotificationCountCallback);

Notification.getActiveNotificationCount

getActiveNotificationCount(): Promise

獲取當前應用的活動通知數（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

返回值：

類型	說明
Promise	以Promise形式返回獲取當前應用的活動通知數。

示例：

Notification.getActiveNotificationCount().then((data) = > {
	console.info("========================== >getActiveNotificationCountCallback======================= >");
});

Notification.getActiveNotifications

getActiveNotifications(callback: AsyncCallback>): void

獲取當前應用的活動通知（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
callback	是	否	AsyncCallback>	是	獲取當前應用的活動通知回調函數。

示例：

function getActiveNotificationsCallback(err, data) {
	console.info("========================== >getActiveNotificationsCallback======================= >");
}

Notification.getActiveNotifications(getActiveNotificationsCallback);

Notification.getActiveNotifications

getActiveNotifications(): Promise>

獲取當前應用的活動通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

返回值：

類型	說明
Promise>	以Promise形式返回獲取當前應用的活動通知。

示例：

Notification.getActiveNotifications().then((data) = > {
	console.info("========================== >getActiveNotificationsCallback======================= >");
});

Notification.cancelGroup8+

cancelGroup(groupName: string, callback: AsyncCallback): void

取消本應用指定組通知（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
groupName	是	否	string	是	指定通知組名稱。
callback	是	否	AsyncCallback	是	取消本應用指定組通知回調函數。

示例：

function cancelGroupCallback(err) {
   console.info("========================== >cancelGroupCallback======================= >");
}

var groupName = "GroupName";

Notification.cancelGroup(groupName, cancelGroupCallback);

Notification.cancelGroup8+

cancelGroup(groupName: string): Promise

取消本應用指定組通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

名稱	可讀	可寫	類型	必填	描述
groupName	是	否	string	是	指定通知組名稱。

示例：

var groupName = "GroupName";
Notification.cancelGroup(groupName).then(() = > {
	console.info("========================== >cancelGroupPromise======================= >");
});

Notification.removeGroupByBundle8+

removeGroupByBundle(bundle: BundleOption, groupName: string, callback: AsyncCallback): void

刪除指定應用指定組通知（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
groupName	是	否	string	是	指定通知組名稱。
callback	是	否	AsyncCallback	是	刪除本應用指定組通知回調函數。

示例：

function removeGroupByBundleCallback(err) {
   console.info("========================== >removeGroupByBundleCallback======================= >");
}

var bundleOption = {bundle: "Bundle"};
var groupName = "GroupName";

Notification.removeGroupByBundle(bundleOption, groupName, removeGroupByBundleCallback);

Notification.removeGroupByBundle8+

removeGroupByBundle(bundle: BundleOption, groupName: string): Promise

刪除指定應用指定組通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	[BundleOption]	是	指定包信息。
groupName	是	否	string	是	指定通知組名稱。

示例：

var bundleOption = {bundle: "Bundle"};
var groupName = "GroupName";
Notification.removeGroupByBundle(bundleOption, groupName).then(() = > {
	console.info("========================== >removeGroupByBundlePromise======================= >");
});

Notification.setDoNotDisturbDate8+

setDoNotDisturbDate(date: DoNotDisturbDate, callback: AsyncCallback): void

設置免打擾時間（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
date	是	否	[DoNotDisturbDate]	是	免打擾時間選項。
callback	是	否	AsyncCallback	是	設置免打擾時間回調函數。

示例：

function setDoNotDisturbDateCallback(err) {
   console.info("========================== >setDoNotDisturbDateCallback======================= >");
}

var doNotDisturbDate = {
    type: Notification.DoNotDisturbType.TYPE_ONCE,
    begin: new Date(),
    end: new Date(2021, 11, 15, 18, 0)
}

Notification.setDoNotDisturbDate(doNotDisturbDate, setDoNotDisturbDateCallback);

Notification.setDoNotDisturbDate8+

setDoNotDisturbDate(date: DoNotDisturbDate): Promise

設置免打擾時間接口（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
date	是	否	[DoNotDisturbDate]	是	免打擾時間選項。

示例：

var doNotDisturbDate = {
    type: Notification.DoNotDisturbType.TYPE_ONCE,
    begin: new Date(),
    end: new Date(2021, 11, 15, 18, 0)
}
Notification.setDoNotDisturbDate(doNotDisturbDate).then(() = > {
	console.info("========================== >setDoNotDisturbDatePromise======================= >");
});

Notification.setDoNotDisturbDate8+

setDoNotDisturbDate(date: DoNotDisturbDate, userId: number, callback: AsyncCallback): void

指定用戶設置免打擾時間（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
date	是	否	[DoNotDisturbDate]	是	免打擾時間選項。
userId	是	否	number	是	設置免打擾事件的用戶ID。
callback	是	否	AsyncCallback	是	設置免打擾時間回調函數。

示例：

function setDoNotDisturbDateCallback(err) {
   console.info("========================== >setDoNotDisturbDateCallback======================= >");
}

var doNotDisturbDate = {
    type: Notification.DoNotDisturbType.TYPE_ONCE,
    begin: new Date(),
    end: new Date(2021, 11, 15, 18, 0)
}

var userId = 1

Notification.setDoNotDisturbDate(doNotDisturbDate, userId, setDoNotDisturbDateCallback);

Notification.setDoNotDisturbDate8+

setDoNotDisturbDate(date: DoNotDisturbDate, userId: number): Promise

指定用戶設置免打擾時間接口（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
date	是	否	[DoNotDisturbDate]	是	免打擾時間選項。
userId	是	否	number	是	設置免打擾事件的用戶ID。

示例：

var doNotDisturbDate = {
    type: Notification.DoNotDisturbType.TYPE_ONCE,
    begin: new Date(),
    end: new Date(2021, 11, 15, 18, 0)
}

var userId = 1

Notification.setDoNotDisturbDate(doNotDisturbDate, userId).then(() = > {
	console.info("========================== >setDoNotDisturbDatePromise======================= >");
});

Notification.getDoNotDisturbDate8+

getDoNotDisturbDate(callback: AsyncCallback): void

查詢免打擾時間接口（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
callback	是	否	AsyncCallback<[DoNotDisturbDate]>	是	查詢免打擾時間回調函數。

示例：

function getDoNotDisturbDateCallback(err,data) {
   console.info("========================== >getDoNotDisturbDateCallback======================= >");
}

Notification.getDoNotDisturbDate(getDoNotDisturbDateCallback);

Notification.getDoNotDisturbDate8+

getDoNotDisturbDate(): Promise

查詢免打擾時間接口（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

返回值：

類型	說明
Promise<[DoNotDisturbDate]>	以Promise形式返回獲取查詢免打擾時間接口。

示例：

Notification.getDoNotDisturbDate().then((data) = > {
	console.info("========================== >getDoNotDisturbDatePromise======================= >");
});

Notification.getDoNotDisturbDate8+

getDoNotDisturbDate(userId: number, callback: AsyncCallback): void

指定用戶查詢免打擾時間接口（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
callback	是	否	AsyncCallback<[DoNotDisturbDate]>	是	查詢免打擾時間回調函數。
userId	是	否	number	是	設置免打擾事件的用戶ID。

示例：

function getDoNotDisturbDateCallback(err,data) {
   console.info("========================== >getDoNotDisturbDateCallback======================= >");
}

var userId = 1

Notification.getDoNotDisturbDate(userId, getDoNotDisturbDateCallback);

Notification.getDoNotDisturbDate8+

getDoNotDisturbDate(userId: number): Promise

指定用戶查詢免打擾時間接口（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
userId	是	否	number	是	設置免打擾事件的用戶ID。

返回值：

類型	說明
Promise<[DoNotDisturbDate]>	以Promise形式返回獲取查詢免打擾時間接口。

示例：

var userId = 1

Notification.getDoNotDisturbDate(userId).then((data) = > {
	console.info("========================== >getDoNotDisturbDatePromise======================= >");
});

Notification.supportDoNotDisturbMode8+

supportDoNotDisturbMode(callback: AsyncCallback): void

查詢是否支持勿擾模式功能（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

名稱	可讀	可寫	類型	必填	描述
callback	是	否	AsyncCallback	是	查詢是否支持勿擾模式功能回調函數。

示例：

function supportDoNotDisturbModeCallback(err,data) {
   console.info("========================== >supportDoNotDisturbModeCallback======================= >");
}

Notification.supportDoNotDisturbMode(supportDoNotDisturbModeCallback);

Notification.supportDoNotDisturbMode8+

supportDoNotDisturbMode(): Promise

查詢是否支持勿擾模式功能（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

返回值：

類型	說明
Promise	以Promise形式返回獲取是否支持勿擾模式功能的結果。

示例：

Notification.supportDoNotDisturbMode().then((data) = > {
	console.info("========================== >supportDoNotDisturbModePromise======================= >");
});

Notification.isSupportTemplate8+

isSupportTemplate(templateName: string, callback: AsyncCallback): void

查詢模板是否存在（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

參數名	類型	必填	說明
templateName	string	是	模板名稱。
callback	AsyncCallback	是	查詢模板是否存在的回調函數。

示例：

var templateName = 'process';
function isSupportTemplateCallback(err, data) {
    console.info("isSupportTemplateCallback");
}

Notification.isSupportTemplate(templateName, isSupportTemplateCallback);

Notification.isSupportTemplate8+

isSupportTemplate(templateName: string): Promise

查詢模板是否存在（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

參數名	類型	必填	說明
templateName	string	是	模板名稱。

返回值：

類型	說明
Promise	Promise方式返回模板是否存在的結果。

示例：

var templateName = 'process';

Notification.isSupportTemplate(templateName).then((data) = > {
    console.info("isSupportTemplateCallback");
});

Notification.requestEnableNotification8+

requestEnableNotification(callback: AsyncCallback): void

應用請求通知使能（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

參數名	類型	必填	說明
callback	AsyncCallback	是	應用請求通知使能的回調函數。

示例：

function requestEnableNotificationCallback() {
    console.log('------------- requestEnabledNotification --------------');
};

Notification.requestEnableNotification(requestEnableNotificationCallback);

Notification.requestEnableNotification8+

requestEnableNotification(): Promise

應用請求通知使能（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

示例：

Notification.requestEnableNotification()
    .then(() = > {
        console.info("requestEnableNotification ");
	});

Notification.enableDistributed8+

enableDistributed(enable: boolean, callback: AsyncCallback): void

設置設備是否支持分布式通知（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
enable	boolean	是	是否支持。 true 支持。 false 不支持。
callback	AsyncCallback	是	設置設備是否支持分布式通知的回調函數。

示例：

function enabledNotificationCallback() {
    console.log('----------- enableDistributed ------------');
};

var enable = true

Notification.enableDistributed(enable, enabledNotificationCallback);

Notification.enableDistributed8+

enableDistributed(enable: boolean): Promise

設置設備是否支持分布式通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
enable	boolean	是	是否支持。 true 支持。 false 不支持。

示例：

var enable = true

Notification.enableDistributed(enable)
    .then(() = > {
        console.log('-------- enableDistributed ----------');
    });

Notification.isDistributedEnabled8+

isDistributedEnabled(callback: AsyncCallback): void

獲取設備是否支持分布式通知（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

參數：

參數名	類型	必填	說明
callback	AsyncCallback	是	設備是否支持分布式通知的回調函數。

示例：

function isDistributedEnabledCallback() {
    console.log('----------- isDistributedEnabled ------------');
};

Notification.isDistributedEnabled(isDistributedEnabledCallback);

Notification.isDistributedEnabled8+

isDistributedEnabled(): Promise

獲取設備是否支持分布式通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

返回值：

類型	說明
Promise	Promise方式返回設備是否支持分布式通知的結果。 true 支持。 false 不支持。

示例：

Notification.isDistributedEnabled()
    .then((data) = > {
        console.log('-------- isDistributedEnabled ----------');
    });

Notification.enableDistributedByBundle8+

enableDistributedByBundle(bundle: BundleOption, enable: boolean, callback: AsyncCallback): void

根據應用的包設置應用程序是否支持分布式通知（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
bundle	[BundleOption]	是	應用的包。
enable	boolean	是	是否支持。
callback	AsyncCallback	是	應用程序是否支持分布式通知的回調函數。

示例：

function enableDistributedByBundleCallback() {
    console.log('----------- enableDistributedByBundle ------------');
};

var bundle = {
    bundle: "bundleName1",
}

var enable = true

Notification.enableDistributedByBundle(bundle, enable, enableDistributedByBundleCallback);

Notification.enableDistributedByBundle8+

根據bundleenableDistributedByBundle(bundle: BundleOption, enable: boolean): Promise

根據應用的包設置應用程序是否支持分布式通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
bundle	[BundleOption]	是	應用的包。
enable	boolean	是	是否支持。

示例：

var bundle = {
    bundle: "bundleName1",
}

var enable = true

Notification.enableDistributedByBundle(bundle, enable)
    .then(() = > {
        console.log('-------- enableDistributedByBundle ----------');
    });

Notification.isDistributedEnabledByBundle8+

isDistributedEnabledByBundle(bundle: BundleOption, callback: AsyncCallback): void

根據應用的包獲取應用程序是否支持分布式通知（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
bundle	[BundleOption]	是	應用的包。
callback	AsyncCallback	是	應用程序是否支持分布式通知的回調函數。

示例：

function isDistributedEnabledByBundleCallback(data) {
    console.log('----------- isDistributedEnabledByBundle ------------', data);
};

var bundle = {
    bundle: "bundleName1",
}

Notification.isDistributedEnabledByBundle(bundle, isDistributedEnabledByBundleCallback);

Notification.isDistributedEnabledByBundle8+

isDistributedEnabledByBundle(bundle: BundleOption): Promise

根據應用的包獲取應用程序是否支持分布式通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
bundle	[BundleOption]	是	應用的包。

返回值：

類型	說明
Promise	Promise方式返回應用程序是否支持分布式通知的結果。 true 支持。 false 不支持。

示例：

var bundle = {
    bundle: "bundleName1",
}

Notification.isDistributedEnabledByBundle(bundle)
    .then((data) = > {
        console.log('-------- isDistributedEnabledByBundle ----------', data);
    });

Notification.getDeviceRemindType8+

getDeviceRemindType(callback: AsyncCallback): void

獲取通知的提醒方式（Callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
callback	AsyncCallback<[DeviceRemindType]>	是	獲取通知的提醒方式的回調函數。

示例：

function getDeviceRemindTypeCallback(data) {
    console.log('----------- getDeviceRemindType ------------', data);
};

Notification.getDeviceRemindType(getDeviceRemindTypeCallback);

Notification.getDeviceRemindType8+

getDeviceRemindType(): Promise

獲取通知的提醒方式（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

返回值：

類型	說明
Promise<[DeviceRemindType]>	Promise方式返回通知的提醒方式的結果。

示例：

Notification.getDeviceRemindType()
    .then((data) = > {
        console.log('-------- getDeviceRemindType ----------', data);
    });

Notification.enableNotificationSlot9+

enableNotificationSlot(bundle: BundleOption, type: SlotType, enable: boolean, callback: AsyncCallback): void

設置是否啟用應用通道（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
bundle	[BundleOption]	是	指定的應用的包的信息。
type	[SlotType]	是	通知渠道類型,目前分為社交通信、服務提醒、內容咨詢和其他類型。
enable	boolean	是	是否啟用的標記。true為啟用；false為禁用。
callback	AsyncCallback	是	獲取啟用應用通道的回調函數。

示例：

var bundleOption = {
    bundle: 'bundle',
    uid: 1
};

var type = Notification.SlotType.SOCIAL_COMMUNICATION;

var enable = true;

function enableNotificationSlotCallback(data) {
    console.log('-------- enableNotificationSlotCallback ---------', data);
}

Notification.enableNotificationSlot(bundleOption, type, enable, enableNotificationSlotCallback);

Notification.enableNotificationSlot9+

enableNotificationSlot(bundle: BundleOption, type: SlotType, enable: boolean): Promise

設置是否啟用應用通道（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
bundle	[BundleOption]	是	指定的應用的包的信息。
type	[SlotType]	是	通知渠道類型,目前分為社交通信、服務提醒、內容咨詢和其他類型。
enable	boolean	是	是否啟用的標記。true為啟用；false為禁用。

示例：

var bundleOption = {
    bundle: 'bundle',
    uid: 1
};

var type = Notification.SlotType.SOCIAL_COMMUNICATION;

var enable = true;

Notification.enableNotificationSlot(bundleOption, type, enable)
    .then((data) = > {
        console.log('-------- enableNotificationSlotCallback success ---------', data);
    })
    .catch((err) = > {
        console.log('-------- enableNotificationSlotCallback fail ---------', err);
    });

Notification.isNotificationSlotEnabled9+

isNotificationSlotEnabled(bundle: BundleOption, type: SlotType, callback: AsyncCallback): void

獲取應用通道是否啟用的結果（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
bundle	[BundleOption]	是	指定的應用的包的信息。
type	[SlotType]	是	通知渠道類型,目前分為社交通信、服務提醒、內容咨詢和其他類型。
callback	AsyncCallback	是	獲取啟用應用通道的回調函數。

示例：

var bundleOption = {
    bundle: 'bundle',
    uid: 1
};

var type = Notification.SlotType.SOCIAL_COMMUNICATION;

function isNotificationSlotEnabledCallback(data) {
    console.log('------------ isNotificationSlotEnabledCallback ------------', data);
}

Notification.isNotificationSlotEnabled(bundleOption, type, isNotificationSlotEnabledCallback);

Notification.isNotificationSlotEnabled9+

isNotificationSlotEnabled(bundle: BundleOption, type: SlotType): Promise

獲取應用通道是否啟用的結果（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
bundle	[BundleOption]	是	指定的應用的包的信息。
type	[SlotType]	是	通知渠道類型,目前分為社交通信、服務提醒、內容咨詢和其他類型。

返回值：

類型	說明
Promise	以Promise形式返回應用通道是否啟用的結果。true為啟用；false為禁用。

示例：

var bundleOption = {
    bundle: 'bundle',
    uid: 1
};

var type = Notification.SlotType.SOCIAL_COMMUNICATION;

Notification.isNotificationSlotEnabled(bundleOption, type)
    .then((data) = > {
        console.log('------------ isNotificationSlotEnabledCallback success ------------', data);
    })
    .catch((err) = > {
        console.log('------------ isNotificationSlotEnabledCallback fail ------------', err);
    });

Notification.publishAsBundle9+

publishAsBundle(request: NotificationRequest, representativeBundle: string, userId: number, callback: AsyncCallback): void

發布代理通知（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER，ohos.permission.NOTIFICATION_AGENT_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
request	[NotificationRequest]	是	設置要發布通知內容的NotificationRequest對象。
representativeBundle	string	是	被代理應用的包名。
userId	number	是	接收通知用戶的Id。
callback	AsyncCallback	是	發布代理通知的回調方法。

示例：

//publishAsBundle回調
function publishAsBundleCallback(err) {
	console.info("========================== >publishAsBundleCallback======================= >");
}
// 被代理應用的包名
let representativeBundle = "com.example.demo"
// 接收通知的用戶ID
let userId = 100
//通知Request對象
let notificationRequest = {
    id: 1,
    content: {
        contentType: Notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
        normal: {
            title: "test_title",
            text: "test_text",
            additionalText: "test_additionalText"
        }
    }
}

Notification.publishAsBundle(notificationRequest, representativeBundle, userId, publishAsBundleCallback);

Notification.publishAsBundle9+

publishAsBundle(request: NotificationRequest, representativeBundle: string, userId: number): Promise

發布代理通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER，ohos.permission.NOTIFICATION_AGENT_CONTROLLER

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
request	[NotificationRequest]	是	設置要發布通知內容的NotificationRequest對象。
representativeBundle	string	是	被代理應用的包名。
userId	number	是	接收通知用戶的Id。

示例：

// 被代理應用的包名
let representativeBundle = "com.example.demo"
// 接收通知的用戶ID
let userId = 100
//通知Request對象
var notificationRequest = {
    id: 1,
    content: {
        contentType: Notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
        normal: {
            title: "test_title",
            text: "test_text",
            additionalText: "test_additionalText"
        }
    }
}

Notification.publishAsBundle(notificationRequest, representativeBundle, userId).then(() = > {
	console.info("========================== >publishAsBundleCallback======================= >");
});

Notification.cancelAsBundle9+

cancelAsBundle(id: number, representativeBundle: string, userId: number, callback: AsyncCallback): void

取消代理通知（callback形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER，ohos.permission.NOTIFICATION_AGENT_CONTROLLER

參數：

參數名	類型	必填	說明
id	number	是	通知ID。
representativeBundle	string	是	被代理應用的包名。
userId	number	是	接收通知用戶的Id。
callback	AsyncCallback	是	取消代理通知的回調方法。

示例：

//cancelAsBundle
function cancelAsBundleCallback(err) {
	console.info("========================== >cancelAsBundleCallback======================= >");
}
// 被代理應用的包名
let representativeBundle = "com.example.demo"
// 接收通知的用戶ID
let userId = 100

Notification.cancelAsBundle(0, representativeBundle, userId, cancelAsBundleCallback);

Notification.cancelAsBundle9+

cancelAsBundle(id: number, representativeBundle: string, userId: number): Promise

發布代理通知（Promise形式）。

系統能力 ：SystemCapability.Notification.Notification

需要權限 : ohos.permission.NOTIFICATION_CONTROLLER，ohos.permission.NOTIFICATION_AGENT_CONTROLLER

參數：

參數名	類型	必填	說明
id	number	是	通知ID。
representativeBundle	string	是	被代理應用的包名。
userId	number	是	接收通知用戶的Id。

示例：

// 被代理應用的包名
let representativeBundle = "com.example.demo"
// 接收通知的用戶ID
let userId = 100

Notification.cancelAsBundle(0, representativeBundle, userId).then(() = > {
	console.info("========================== >cancelAsBundleCallback======================= >");
});

NotificationSubscriber

onConsume

onConsume?: (data: [SubscribeCallbackData]) => void

接收通知回調函數。

系統能力 ：SystemCapability.Notification.Notification

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
data	AsyncCallback<[SubscribeCallbackData]>	是	回調返回接收到的通知信息。

示例：

function subscribeCallback(err) {
    if (err.code) {
        console.info("subscribe failed " + JSON.stringify(err));
    } else {
        console.info("subscribeCallback");
    }
};

function onConsumeCallback(data) {
    console.info('=== > onConsume in test');
    let req = data.request;
    console.info('=== > onConsume callback req.id:' + req.id);
    let wantAgent = data.wantAgent;
    wantAgent .getWant(wantAgent)
        .then((data1) = > {
            console.log('=== > getWant success want:' + JSON.stringify(data1));
        })
        .catch((err) = > {
            console.error('=== > getWant failed because' + JSON.stringify(err));
        });
    console.info('=== > onConsume callback req.wantAgent:' + JSON.stringify(req.wantAgent));
};

var subscriber = {
    onConsume: onConsumeCallback
};

Notification.subscribe(subscriber, subscribeCallback);

onCancel

onCancel?:(data: [SubscribeCallbackData]) => void

刪除通知回調函數。

系統能力 ：SystemCapability.Notification.Notification

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
data	AsyncCallback<[SubscribeCallbackData]>	是	回調返回接收到的通知信息。

示例：

function subscribeCallback(err) {
    if (err.code) {
        console.info("subscribe failed " + JSON.stringify(err));
    } else {
        console.info("subscribeCallback");
    }
};

function onCancelCallback(data) {
    console.info('=== > onCancel in test');
    let req = data.request;
    console.info('=== > onCancel callback req.id:' + req.id);
}

var subscriber = {
    onCancel: onCancelCallback
};

Notification.subscribe(subscriber, subscribeCallback);

onUpdate

onUpdate?:(data: [NotificationSortingMap]) => void

更新通知排序回調函數。

系統能力 ：SystemCapability.Notification.Notification

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
data	[NotificationSortingMap]	是	回調返回接收到的通知信息。

示例：

function subscribeCallback(err) {
    if (err.code) {
        console.info("subscribe failed " + JSON.stringify(err));
    } else {
        console.info("subscribeCallback");
    }
};

function onUpdateCallback() {
    console.info('=== > onUpdate in test');
}

var subscriber = {
    onUpdate: onUpdateCallback
};

Notification.subscribe(subscriber, subscribeCallback);

onConnect

onConnect?:() => void

注冊訂閱回調函數。

系統能力 ：SystemCapability.Notification.Notification

系統API : 此接口為系統接口，三方應用不支持調用。

示例：

function subscribeCallback(err) {
    if (err.code) {
        console.info("subscribe failed " + JSON.stringify(err));
    } else {
        console.info("subscribeCallback");
    }
};

function onConnectCallback() {
    console.info('=== > onConnect in test');
}

var subscriber = {
    onConnect: onConnectCallback
};

Notification.subscribe(subscriber, subscribeCallback);

onDisconnect

onDisconnect?:() => void

取消訂閱回調函數。

系統能力 ：SystemCapability.Notification.Notification

系統API : 此接口為系統接口，三方應用不支持調用。

示例：

function subscribeCallback(err) {
    if (err.code) {
        console.info("subscribe failed " + JSON.stringify(err));
    } else {
        console.info("subscribeCallback");
    }
};

function onDisconnectCallback() {
    console.info('=== > onDisconnect in test');
}

var subscriber = {
    onDisconnect: onDisconnectCallback
};

Notification.subscribe(subscriber, subscribeCallback);

onDestroy

onDestroy?:() => void

服務失聯回調函數。

系統能力 ：SystemCapability.Notification.Notification

系統API : 此接口為系統接口，三方應用不支持調用。

示例：

function subscribeCallback(err) {
    if (err.code) {
        console.info("subscribe failed " + JSON.stringify(err));
    } else {
        console.info("subscribeCallback");
    }
};

function onDestroyCallback() {
    console.info('=== > onDestroy in test');
}

var subscriber = {
    onDestroy: onDestroyCallback
};

Notification.subscribe(subscriber, subscribeCallback);

onDoNotDisturbDateChange8+

onDoNotDisturbDateChange?:(mode: notification.[DoNotDisturbDate]) => void

免打擾時間選項變更回調函數。

系統能力 ：SystemCapability.Notification.Notification

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
mode	notification.[DoNotDisturbDate]	是	回調返回免打擾時間選項變更。

示例：

function subscribeCallback(err) {
    if (err.code) {
        console.info("subscribe failed " + JSON.stringify(err));
    } else {
        console.info("subscribeCallback");
    }
};

function onDoNotDisturbDateChangeCallback() {
    console.info('=== > onDoNotDisturbDateChange in test');
}

var subscriber = {
    onDoNotDisturbDateChange: onDoNotDisturbDateChangeCallback
};

Notification.subscribe(subscriber, subscribeCallback);

onEnabledNotificationChanged8+

onEnabledNotificationChanged?:(callbackData: [EnabledNotificationCallbackData]) => void

監聽應用通知使能變化。

系統能力 ：SystemCapability.Notification.Notification

系統API : 此接口為系統接口，三方應用不支持調用。

參數：

參數名	類型	必填	說明
callback	AsyncCallback<[EnabledNotificationCallbackData]>	是	回調返回監聽到的應用信息。

示例：

function subscribeCallback(err) {
    if (err.code) {
        console.info("subscribe failed " + JSON.stringify(err));
    } else {
        console.info("subscribeCallback");
    }
};

function onEnabledNotificationChangedCallback(callbackData) {
    console.info("bundle: ", callbackData.bundle);
    console.info("uid: ", callbackData.uid);
    console.info("enable: ", callbackData.enable);
};

var subscriber = {
    onEnabledNotificationChanged: onEnabledNotificationChangedCallback
};

Notification.subscribe(subscriber, subscribeCallback);

SubscribeCallbackData

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

系統API : 此接口為系統接口，三方應用不支持調用。

名稱	可讀	可寫	類型	必填	描述
request	是	否	[NotificationRequest]	是	通知內容。
sortingMap	是	否	[NotificationSortingMap]	否	排序信息。
reason	是	否	number	否	刪除原因。
sound	是	否	string	否	通知聲音。
viationValues	是	否	Array	否	通知震動。

EnabledNotificationCallbackData8+

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

系統API : 此接口為系統接口，三方應用不支持調用。

名稱	可讀	可寫	類型	必填	描述
bundle	是	否	string	是	應用的包名。
uid	是	否	number	是	應用的uid。
enable	是	否	boolean	是	應用通知使能狀態。

DoNotDisturbDate8+

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

系統API : 此接口為系統接口，三方應用不支持調用。

名稱	可讀	可寫	類型	描述
type	是	否	[DoNotDisturbType]	指定免打擾設置的時間類型。
begin	是	否	Date	指定免打擾設置的起點時間。
end	是	否	Date	指定免打擾設置的終點時間。

DoNotDisturbType8+

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

系統API : 此接口為系統接口，三方應用不支持調用。

名稱	值	說明
TYPE_NONE	DoNotDisturbType	非通知勿擾類型。
TYPE_ONCE	DoNotDisturbType	以設置時間段(只看小時和分鐘)一次執行勿擾。
TYPE_DAILY	DoNotDisturbType	以設置時間段(只看小時和分鐘)每天執行勿擾。
TYPE_CLEARLY	DoNotDisturbType	以設置時間段(明確年月日時分)執行勿擾。

ContentType

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

名稱	值	說明
NOTIFICATION_CONTENT_BASIC_TEXT	ContentType	普通類型通知。
NOTIFICATION_CONTENT_LONG_TEXT	ContentType	長文本類型通知。
NOTIFICATION_CONTENT_PICTURE	ContentType	圖片類型通知。
NOTIFICATION_CONTENT_CONVERSATION	ContentType	社交類型通知。
NOTIFICATION_CONTENT_MULTILINE	ContentType	多行文本類型通知。

SlotLevel

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

名稱	值	說明
LEVEL_NONE	0	表示關閉通知功能。
LEVEL_MIN	1	表示通知功能已啟用，但狀態欄中不顯示通知圖標，且沒有橫幅或提示音。
LEVEL_LOW	2	表示通知功能已啟用，且狀態欄中顯示通知圖標，但沒有橫幅或提示音。
LEVEL_DEFAULT	3	表示通知功能已啟用，狀態欄中顯示通知圖標，沒有橫幅但有提示音。
LEVEL_HIGH	4	表示通知功能已啟用，狀態欄中顯示通知圖標，有橫幅和提示音。

BundleOption

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

名稱	可讀	可寫	類型	必填	描述
bundle	是	是	string	是	包名。
uid	是	是	number	否	用戶id。

NotificationKey

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

名稱	可讀	可寫	類型	必填	描述
id	是	是	number	是	通知ID。
label	是	是	string	否	通知標簽。

SlotType

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

名稱	值	說明
UNKNOWN_TYPE	SlotType	未知類型。
SOCIAL_COMMUNICATION	SlotType	社交類型。
SERVICE_INFORMATION	SlotType	服務類型。
CONTENT_INFORMATION	SlotType	內容類型。
OTHER_TYPES	SlotType	其他類型。

NotificationActionButton

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

名稱	可讀	可寫	類型	必填	描述
title	是	是	string	是	按鈕標題。
wantAgent	是	是	WantAgent	是	點擊按鈕時觸發的WantAgent。
extras	是	是	{ [key: string]: any }	否	按鈕擴展信息。
userInput8+	是	是	[NotificationUserInput]	否	用戶輸入對象實例。

NotificationBasicContent

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

名稱	可讀	可寫	類型	必填	描述
title	是	是	string	是	通知標題。
text	是	是	string	是	通知內容。
additionalText	是	是	string	否	通知次要內容，是對通知內容的補充。

NotificationLongTextContent

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

名稱	可讀	可寫	類型	必填	描述
title	是	是	string	是	通知標題。
text	是	是	string	是	通知內容。
additionalText	是	是	string	否	通知次要內容，是對通知內容的補充。
longText	是	是	string	是	通知的長文本。
iefText	是	是	string	是	通知概要內容，是對通知內容的總結。
expandedTitle	是	是	string	是	通知展開時的標題。

NotificationMultiLineContent

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

名稱	可讀	可寫	類型	必填	描述
title	是	是	string	是	通知標題。
text	是	是	string	是	通知內容。
additionalText	是	是	string	否	通知次要內容，是對通知內容的補充。
iefText	是	是	string	是	通知概要內容，是對通知內容的總結。
longTitle	是	是	string	是	通知展開時的標題。
lines	是	是	Array	是	通知的多行文本。

NotificationPictureContent

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

名稱	可讀	可寫	類型	必填	描述
title	是	是	string	是	通知標題。
text	是	是	string	是	通知內容。
additionalText	是	是	string	否	通知次要內容，是對通知內容的補充。
iefText	是	是	string	是	通知概要內容，是對通知內容的總結。
expandedTitle	是	是	string	是	通知展開時的標題。
picture	是	是	image.PixelMap	是	通知的圖片內容。

NotificationContent

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

名稱	可讀	可寫	類型	必填	描述
contentType	是	是	[ContentType]	是	通知內容類型。
normal	是	是	[NotificationBasicContent]	否	基本類型通知內容。
longText	是	是	[NotificationLongTextContent]	否	長文本類型通知內容。
multiLine	是	是	[NotificationMultiLineContent]	否	多行類型通知內容。
picture	是	是	[NotificationPictureContent]	否	圖片類型通知內容。

NotificationFlagStatus8+

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

系統API : 此接口為系統接口，三方應用不支持調用。

名稱	值	描述
TYPE_NONE	0	默認標志。
TYPE_OPEN	1	通知標志打開。
TYPE_CLOSE	2	通知標志關閉。

NotificationFlags8+

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

名稱	可讀	可寫	類型	必填	描述
soundEnabled	是	否	NotificationFlagStatus	否	是否啟用聲音提示。
viationEnabled	是	否	NotificationFlagStatus	否	是否啟用振動提醒功能。

NotificationRequest

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

名稱	可讀	可寫	類型	必填	描述
content	是	是	[NotificationContent]	是	通知內容。
id	是	是	number	否	通知ID。
slotType	是	是	[SlotType]	否	通道類型。
isOngoing	是	是	boolean	否	是否進行時通知。
isUnremovable	是	是	boolean	否	是否可移除。
deliveryTime	是	是	number	否	通知發送時間。
tapDismissed	是	是	boolean	否	通知是否自動清除。
autoDeletedTime	是	是	number	否	自動清除的時間。
wantAgent	是	是	WantAgent	否	點擊跳轉的WantAgent。
extraInfo	是	是	{[key: string]: any}	否	擴展參數。
color	是	是	number	否	通知背景顏色。
colorEnabled	是	是	boolean	否	通知背景顏色是否使能。
isAlertOnce	是	是	boolean	否	設置是否僅有一次此通知警報。
isStopwatch	是	是	boolean	否	是否顯示已用時間。
isCountDown	是	是	boolean	否	是否顯示倒計時時間。
isFloatingIcon	是	是	boolean	否	是否顯示狀態欄圖標。
label	是	是	string	否	通知標簽。
badgeIconStyle	是	是	number	否	通知角標類型。
showDeliveryTime	是	是	boolean	否	是否顯示分發時間。
actionButtons	是	是	Array<[NotificationActionButton]>	否	通知按鈕，最多兩個按鈕。
smallIcon	是	是	PixelMap	否	通知小圖標。
largeIcon	是	是	PixelMap	否	通知大圖標。
creatorBundleName	是	否	string	否	創建通知的包名。
creatorUid	是	否	number	否	創建通知的UID。
creatorPid	是	否	number	否	創建通知的PID。
creatorUserId8+	是	否	number	否	創建通知的UserId。
hashCode	是	否	string	否	通知唯一標識。
classification	是	是	string	否	通知分類。系統API : 此接口為系統接口，三方應用不支持調用。
groupName8+	是	是	string	否	組通知名稱。
template8+	是	是	[NotificationTemplate]	否	通知模板。
isRemoveAllowed8+	是	否	boolean	否	通知是否能被移除。系統API : 此接口為系統接口，三方應用不支持調用。
source8+	是	否	number	否	通知源。系統API : 此接口為系統接口，三方應用不支持調用。
distributedOption8+	是	是	[DistributedOptions]	否	分布式通知的選項。
deviceId8+	是	否	string	否	通知源的deviceId。系統API : 此接口為系統接口，三方應用不支持調用。
notificationFlags8+	是	否	[NotificationFlags]	否	獲取NotificationFlags。

DistributedOptions8+

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

名稱	可讀	可寫	類型	必填	描述
isDistributed	是	是	boolean	否	是否為分布式通知。
supportDisplayDevices	是	是	Array	是	可以同步通知到的設備類型。
supportOperateDevices	是	是	Array	否	可以打開通知的設備。
remindType	是	否	number	否	通知的提醒方式。系統API : 此接口為系統接口，三方應用不支持調用。

NotificationSlot

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

名稱	可讀	可寫	類型	必填	描述
type	是	是	SlotType	是	通道類型。
level	是	是	number	否	通知級別，不設置則根據通知渠道類型有默認值。
desc	是	是	string	否	通知渠道描述信息。
badgeFlag	是	是	boolean	否	是否顯示角標。
bypassDnd	是	是	boolean	否	置是否在系統中繞過免打擾模式。
lockscreenVisibility	是	是	boolean	否	在鎖定屏幕上顯示通知的模式。
viationEnabled	是	是	boolean	否	是否可振動。
sound	是	是	string	否	通知提示音。
lightEnabled	是	是	boolean	否	是否閃燈。
lightColor	是	是	number	否	通知燈顏色。
viationValues	是	是	Array	否	通知振動樣式。
enabled9+	是	否	boolean	否	此通知插槽中的啟停狀態。

NotificationSorting

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

系統API : 此接口為系統接口，三方應用不支持調用。

名稱	可讀	可寫	類型	必填	描述
slot	是	否	[NotificationSlot]	是	通知通道內容。
hashCode	是	否	string	是	通知唯一標識。
ranking	是	否	number	是	通知排序序號。

NotificationSortingMap

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

系統API : 此接口為系統接口，三方應用不支持調用。

名稱	可讀	可寫	類型	必填	描述
sortings	是	否	{[key: string]: [NotificationSorting]}	是	通知排序信息數組。
sortedHashCode	是	否	Array	是	通知唯一標識數組。

NotificationSubscribeInfo

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

系統API : 此接口為系統接口，三方應用不支持調用。

名稱	可讀	可寫	類型	必填	描述
bundleNames	是	是	Array	否	指定訂閱哪些包名的APP發來的通知。
userId	是	是	number	否	指定訂閱哪個用戶下發來的通知。

NotificationTemplate8+

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

名稱	參數類型	可讀	可寫	說明
name	string	是	是	模板名稱。
data	{[key:string]: Object}	是	是	模板數據。

NotificationUserInput8+

系統能力 ：SystemCapability.Notification.Notification

名稱	可讀	可寫	類型	必填	描述
inputKey	是	是	string	是	用戶輸入時用于標識此輸入的key。

DeviceRemindType8+

系統能力 ：SystemCapability.Notification.Notification

系統API : 此接口為系統接口，三方應用不支持調用。

名稱	值	描述
IDLE_DONOT_REMIND	0	設備未被使用，無需提醒。
IDLE_REMIND	1	提醒設備未被使用。
ACTIVE_DONOT_REMIND	2	設備正在使用，無需提醒。
ACTIVE_REMIND	3	提醒設備正在使用。

SourceType8+

系統能力 ：SystemCapability.Notification.Notification

系統API : 此接口為系統接口，三方應用不支持調用。

搜狗高速瀏覽器截圖20240326151450.png

名稱`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`	值	描述
TYPE_NORMAL	0	一般通知。
TYPE_CONTINUOUS	1	連續通知。
TYPE_TIMER	2	計劃通知。

審核編輯黃宇

聲明：本文內容及配圖由入駐作者撰寫或者入駐合作網站授權轉載。文章觀點僅代表作者本人，不代表電子發燒友網立場。文章及其配圖僅供工程師學習之用，如有內容侵權或者其他違規問題，請聯系本站處理。舉報投訴

接口

接口

+關注

關注
33

文章
9519

瀏覽量
157019
鴻蒙

鴻蒙

+關注

關注
60

文章
2963

瀏覽量
45883

搜索歷史

鴻蒙開發接口公共事件與通知：【Notification模塊】

Notification模塊

導入模塊

Notification.publish

Notification.publish

Notification.publish8+

Notification.publish8+

Notification.cancel

Notification.cancel

Notification.cancel

Notification.cancelAll

Notification.cancelAll

Notification.addSlot

Notification.addSlot

Notification.addSlot

Notification.addSlot

Notification.addSlots

Notification.addSlots

Notification.getSlot

Notification.getSlot

Notification.getSlots

Notification.getSlots

Notification.removeSlot

Notification.removeSlot

Notification.removeAllSlots

Notification.removeAllSlots

Notification.subscribe

Notification.subscribe

Notification.subscribe

Notification.unsubscribe

Notification.unsubscribe

Notification.enableNotification

Notification.enableNotification

Notification.isNotificationEnabled

Notification.isNotificationEnabled

Notification.isNotificationEnabled

Notification.isNotificationEnabled

Notification.displayBadge

Notification.displayBadge

Notification.isBadgeDisplayed

Notification.isBadgeDisplayed

Notification.setSlotByBundle

Notification.setSlotByBundle

Notification.getSlotsByBundle

Notification.getSlotsByBundle

Notification.getSlotNumByBundle

Notification.getSlotNumByBundle

Notification.remove

Notification.remove

Notification.remove

Notification.remove

Notification.removeAll

Notification.removeAll

Notification.removeAll

Notification.removeAll8+

Notification.removeAll8+

[](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Beta1/zh-cn/application-dev/reference/apis/js-apis-notification.md#notificationgetallactivenotifications)Notification.getAllActiveNotifications

Notification.getAllActiveNotifications

Notification.getActiveNotificationCount

Notification.getActiveNotificationCount

Notification.getActiveNotifications

Notification.getActiveNotifications

Notification.cancelGroup8+

Notification.cancelGroup8+

Notification.removeGroupByBundle8+

Notification.removeGroupByBundle8+

Notification.setDoNotDisturbDate8+

Notification.setDoNotDisturbDate8+

Notification.setDoNotDisturbDate8+

Notification.setDoNotDisturbDate8+

Notification.getDoNotDisturbDate8+

Notification.getDoNotDisturbDate8+

Notification.getDoNotDisturbDate8+

Notification.getDoNotDisturbDate8+

Notification.supportDoNotDisturbMode8+

Notification.supportDoNotDisturbMode8+

Notification.isSupportTemplate8+

Notification.isSupportTemplate8+

Notification.requestEnableNotification8+