# @ohos.notification (Notification模å—)(系统应用) æœ¬æ¨¡å—æä¾›é€šçŸ¥ç®¡ç†çš„能力,包括å‘布ã€å–消å‘布通知,创建ã€èŽ·å–ã€ç§»é™¤é€šçŸ¥é€šé“,订阅ã€å–消订阅通知,获å–通知的使能状æ€ã€è§’æ ‡ä½¿èƒ½çŠ¶æ€ï¼ŒèŽ·å–通知的相关信æ¯ç‰ã€‚ > **说明:** > > 从API version 9开始,该接å£ä¸å†ç»´æŠ¤ï¼ŒæŽ¨è使用新接å£[@ohos.notificationManager](js-apis-notificationManager.md)。 > 本模å—首批接å£ä»ŽAPI version 7开始支æŒã€‚åŽç»ç‰ˆæœ¬çš„æ–°å¢žæŽ¥å£ï¼Œé‡‡ç”¨ä¸Šè§’æ ‡å•ç‹¬æ ‡è®°æŽ¥å£çš„起始版本。 > > 当å‰ç•Œé¢ä»…åŒ…å«æœ¬æ¨¡å—的系统接å£ï¼Œå…¶ä»–公开接å£å‚è§[Notification](./js-apis-notification.md)。 ## å¯¼å…¥æ¨¡å— ```ts import Notification from '@ohos.notification'; ``` ## Notification.publish<sup>8+</sup> publish(request: NotificationRequest, userId: number, callback: AsyncCallback\<void\>): void å‘布通知给指定的用户(callbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | ----------------------------------------- | ---- | ------------------------------------------- | | request | [NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest) | 是 | 用于设置è¦å‘布通知的内容和相关é…置信æ¯ã€‚ | | userId | number | 是 | 用户ID。 | | callback | AsyncCallback\<void\> | 是 | 被指定的回调方法。 | **示例:** ```ts import NotificationManager from '@ohos.notificationManager'; import Base from '@ohos.base'; // publish回调 let publishCallback = (err: Base.BusinessError) => { if (err) { console.error(`publish failed, code is ${err.code}`); } else { console.info("publish success"); } } // 用户ID let userId: number = 1; // 通知Request对象 let notificationRequest: NotificationManager.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.publish<sup>8+</sup> publish(request: NotificationRequest, userId: number): Promise\<void\> å‘布通知给指定的用户(Promiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | ----------------------------------------- | ---- | ------------------------------------------- | | request | [NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest) | 是 | 用于设置è¦å‘布通知的内容和相关é…置信æ¯ã€‚ | | userId | number | 是 | 用户ID。 | **返回值:** | 类型 | 说明 | | ------- |------------| | Promise\<void\> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```ts import NotificationManager from '@ohos.notificationManager'; import Base from '@ohos.base'; let notificationRequest: NotificationManager.NotificationRequest = { id: 1, content: { contentType: Notification.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT, normal: { title: "test_title", text: "test_text", additionalText: "test_additionalText" } } }; let userId: number = 1; Notification.publish(notificationRequest, userId).then(() => { console.info("publish success"); }).catch((err: Base.BusinessError) => { console.error(`publish failed, code is ${err}`); }); ``` ## Notification.addSlot addSlot(slot: NotificationSlot, callback: AsyncCallback\<void\>): void 创建通知通é“(callbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------- | ---- | -------------------- | | slot | [NotificationSlot](./js-apis-notification.md#notificationslot) | 是 | è¦åˆ›å»ºçš„通知通é“对象。 | | callback | AsyncCallback\<void\> | 是 | 表示被指定的回调方法。 | **示例:** ```ts import NotificationManager from '@ohos.notificationManager'; import Base from '@ohos.base'; // addslot回调 let addSlotCallBack = (err: Base.BusinessError) => { if (err) { console.info("addSlot failed " + JSON.stringify(err)); } else { console.info("addSlot success"); } } // 通知slot对象 let notificationSlot: NotificationManager.NotificationSlot = { type: Notification.SlotType.SOCIAL_COMMUNICATION }; Notification.addSlot(notificationSlot, addSlotCallBack); ``` ## Notification.addSlot addSlot(slot: NotificationSlot): Promise\<void\> 创建通知通é“(Promiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ---- | ---------------- | ---- | -------------------- | | slot | [NotificationSlot](./js-apis-notification.md#notificationslot) | 是 | è¦åˆ›å»ºçš„通知通é“对象。 | **返回值:** | 类型 | 说明 | | ------- |------------| | Promise\<void\> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```ts import NotificationManager from '@ohos.notificationManager'; import Base from '@ohos.base'; // 通知slot对象 let notificationSlot: NotificationManager.NotificationSlot = { type: Notification.SlotType.SOCIAL_COMMUNICATION }; Notification.addSlot(notificationSlot).then(() => { console.info("addSlot success"); }).catch((err: Base.BusinessError) => { console.error(`addSlot failed, code is ${err}`); }); ``` ## Notification.addSlots addSlots(slots: Array\<NotificationSlot\>, callback: AsyncCallback\<void\>): void 创建多个通知通é“(callbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | ------------------------- | ---- | ------------------------ | | slots | Array\<[NotificationSlot](./js-apis-notification.md#notificationslot)\> | 是 | è¦åˆ›å»ºçš„通知通é“对象数组。 | | callback | AsyncCallback\<void\> | 是 | 表示被指定的回调方法。 | **示例:** ```ts import NotificationManager from '@ohos.notificationManager'; import Base from '@ohos.base'; // addSlots回调 let addSlotsCallBack = (err: Base.BusinessError) => { if (err) { console.info("addSlots failed " + JSON.stringify(err)); } else { console.info("addSlots success"); } } // 通知slot对象 let notificationSlot: NotificationManager.NotificationSlot = { type: Notification.SlotType.SOCIAL_COMMUNICATION }; // 通知slot array 对象 let notificationSlotArray: NotificationManager.NotificationSlot[] = new Array(); notificationSlotArray[0] = notificationSlot; Notification.addSlots(notificationSlotArray, addSlotsCallBack); ``` ## Notification.addSlots addSlots(slots: Array\<NotificationSlot\>): Promise\<void\> 创建多个通知通é“(Promiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ----- | ------------------------- | ---- | ------------------------ | | slots | Array\<[NotificationSlot](./js-apis-notification.md#notificationslot)\> | 是 | è¦åˆ›å»ºçš„通知通é“对象数组。 | **返回值:** | 类型 | 说明 | | ------- |------------| | Promise\<void\> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```ts import NotificationManager from '@ohos.notificationManager'; import Base from '@ohos.base'; // 通知slot对象 let notificationSlot: NotificationManager.NotificationSlot = { type: Notification.SlotType.SOCIAL_COMMUNICATION }; // 通知slot array 对象 let notificationSlotArray: NotificationManager.NotificationSlot[] = new Array(); notificationSlotArray[0] = notificationSlot; Notification.addSlots(notificationSlotArray).then(() => { console.info("addSlots success"); }).catch((err: Base.BusinessError) => { console.error(`addSlot failed, code is ${err}`); }); ``` ## Notification.subscribe subscribe(subscriber: NotificationSubscriber, info: NotificationSubscribeInfo, callback: AsyncCallback\<void\>): void 订阅通知并指定订阅信æ¯ï¼ˆcallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ---------- | ------------------------- | ---- | ---------------- | | subscriber | [NotificationSubscriber](js-apis-inner-notification-notificationSubscriber-sys.md#notificationsubscriber) | 是 | 通知订阅对象。 | | info | [NotificationSubscribeInfo](js-apis-inner-notification-notificationSubscribeInfo-sys.md#notificationsubscribeinfo) | 是 | 通知订阅信æ¯ã€‚ | | callback | AsyncCallback\<void\> | 是 | 订阅动作回调函数。 | **示例:** ```ts import Base from '@ohos.base'; import NotificationSubscribe from '@ohos.notificationSubscribe'; // subscribe回调 let subscribeCallback = (err: Base.BusinessError) => { if (err) { console.info("subscribe failed " + JSON.stringify(err)); } else { console.info("subscribe success"); } } let onConsumeCallback = (data: NotificationSubscribe.SubscribeCallbackData) => { console.info("Consume callback: " + JSON.stringify(data)); } let subscriber: NotificationSubscribe.NotificationSubscriber = { onConsume: onConsumeCallback }; let info: NotificationSubscribe.NotificationSubscribeInfo = { bundleNames: ["bundleName1", "bundleName2"] }; Notification.subscribe(subscriber, info, subscribeCallback); ``` ## Notification.subscribe subscribe(subscriber: NotificationSubscriber, callback: AsyncCallback\<void\>): void 订阅当å‰ç”¨æˆ·ä¸‹æ‰€æœ‰åº”用的通知(callbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ---------- | ---------------------- | ---- | ---------------- | | subscriber | [NotificationSubscriber](js-apis-inner-notification-notificationSubscriber-sys.md#notificationsubscriber) | 是 | 通知订阅对象。 | | callback | AsyncCallback\<void\> | 是 | 订阅动作回调函数。 | **示例:** ```ts import Base from '@ohos.base'; import NotificationSubscribe from '@ohos.notificationSubscribe'; let subscribeCallback = (err: Base.BusinessError) => { if (err) { console.info("subscribe failed " + JSON.stringify(err)); } else { console.info("subscribe success"); } } function onConsumeCallback(data: NotificationSubscribe.SubscribeCallbackData) { console.info("Consume callback: " + JSON.stringify(data)); } let subscriber: NotificationSubscribe.NotificationSubscriber = { onConsume: onConsumeCallback }; Notification.subscribe(subscriber, subscribeCallback); ``` ## Notification.subscribe subscribe(subscriber: NotificationSubscriber, info?: NotificationSubscribeInfo): Promise\<void\> 订阅通知并指定订阅信æ¯ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ---------- | ------------------------- | ---- | ------------ | | subscriber | [NotificationSubscriber](js-apis-inner-notification-notificationSubscriber-sys.md#notificationsubscriber) | 是 | 通知订阅对象。 | | info | [NotificationSubscribeInfo](js-apis-inner-notification-notificationSubscribeInfo-sys.md#notificationsubscribeinfo) | å¦ | 通知订阅信æ¯ï¼Œé»˜è®¤ä¸ºç©ºã€‚ | **返回值:** | 类型 | 说明 | | ------- |------------| | Promise\<void\> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```ts import Base from '@ohos.base'; import NotificationSubscribe from '@ohos.notificationSubscribe'; function onConsumeCallback(data: NotificationSubscribe.SubscribeCallbackData) { console.info("Consume callback: " + JSON.stringify(data)); } let subscriber: NotificationSubscribe.NotificationSubscriber = { onConsume: onConsumeCallback }; Notification.subscribe(subscriber).then(() => { console.info("subscribe success"); }).catch((err: Base.BusinessError) => { console.error(`subscribe failed, code is ${err}`); }); ``` ## Notification.unsubscribe unsubscribe(subscriber: NotificationSubscriber, callback: AsyncCallback\<void\>): void å–æ¶ˆè®¢é˜…(callbcakå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ---------- | ---------------------- | ---- | -------------------- | | subscriber | [NotificationSubscriber](js-apis-inner-notification-notificationSubscriber-sys.md#notificationsubscriber) | 是 | 通知订阅对象。 | | callback | AsyncCallback\<void\> | 是 | å–æ¶ˆè®¢é˜…动作回调函数。 | **示例:** ```ts import Base from '@ohos.base'; import NotificationSubscribe from '@ohos.notificationSubscribe'; let unsubscribeCallback = (err: Base.BusinessError) => { if (err) { console.info("unsubscribe failed " + JSON.stringify(err)); } else { console.info("unsubscribe success"); } } let onDisconnectCallback = () => { console.info("subscribe disconnect"); } let subscriber: NotificationSubscribe.NotificationSubscriber = { onDisconnect: onDisconnectCallback }; Notification.unsubscribe(subscriber, unsubscribeCallback); ``` ## Notification.unsubscribe unsubscribe(subscriber: NotificationSubscriber): Promise\<void\> å–æ¶ˆè®¢é˜…(Promiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ---------- | ---------------------- | ---- | ------------ | | subscriber | [NotificationSubscriber](js-apis-inner-notification-notificationSubscriber-sys.md#notificationsubscriber) | 是 | 通知订阅对象。 | **返回值:** | 类型 | 说明 | | ------- |------------| | Promise\<void\> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```ts import Base from '@ohos.base'; import NotificationSubscribe from '@ohos.notificationSubscribe'; function onDisconnectCallback() { console.info("subscribe disconnect"); } let subscriber: NotificationSubscribe.NotificationSubscriber = { onDisconnect: onDisconnectCallback }; Notification.unsubscribe(subscriber).then(() => { console.info("unsubscribe success"); }).catch((err: Base.BusinessError) => { console.error(`unsubscribe failed, code is ${err}`); }); ``` ## Notification.enableNotification enableNotification(bundle: BundleOption, enable: boolean, callback: AsyncCallback\<void\>): void 设定指定应用的通知使能状æ€ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------- | ---- | -------------------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | | enable | boolean | 是 | 使能状æ€ã€‚ | | callback | AsyncCallback\<void\> | 是 | 设定通知使能回调函数。 | **示例:** ```ts import Base from '@ohos.base'; let enableNotificationCallback = (err: Base.BusinessError) => { if (err) { console.info("enableNotification failed " + JSON.stringify(err)); } else { console.info("enableNotification success"); } } let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.enableNotification(bundle, false, enableNotificationCallback); ``` ## Notification.enableNotification enableNotification(bundle: BundleOption, enable: boolean): Promise\<void\> 设定指定应用的通知使能状æ€ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ------ | ------------ | ---- | ---------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | | enable | boolean | 是 | 使能状æ€ã€‚ | **返回值:** | 类型 | 说明 | | ------- |------------| | Promise\<void\> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```ts import Base from '@ohos.base'; let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.enableNotification(bundle, false).then(() => { console.info("enableNotification success"); }).catch((err: Base.BusinessError) => { console.error(`enableNotification failed, code is ${err}`); }); ``` ## Notification.isNotificationEnabled isNotificationEnabled(bundle: BundleOption, callback: AsyncCallback\<boolean\>): void èŽ·å–æŒ‡å®šåº”用的通知使能状æ€ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **系统API**ï¼šæ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------- | ---- | ------------------------ | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | | callback | AsyncCallback\<void\> | 是 | 获å–通知使能状æ€å›žè°ƒå‡½æ•°ã€‚ | **示例:** ```ts import Base from '@ohos.base'; let isNotificationEnabledCallback = (err: Base.BusinessError, data: boolean) => { if (err) { console.info("isNotificationEnabled failed " + JSON.stringify(err)); } else { console.info("isNotificationEnabled success"); } } let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.isNotificationEnabled(bundle, isNotificationEnabledCallback); ``` ## Notification.isNotificationEnabled isNotificationEnabled(bundle: BundleOption): Promise\<boolean\> èŽ·å–æŒ‡å®šåº”用的通知使能状æ€ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ------ | ------------ | ---- | ---------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | **返回值:** | 类型 | 说明 | | ------------------ | --------------------------------------------------- | | Promise\<boolean\> | 以Promiseå½¢å¼è¿”å›žèŽ·å–æŒ‡å®šåº”用的通知使能状æ€çš„结果。 | **示例:** ```ts import Base from '@ohos.base'; let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.isNotificationEnabled(bundle).then((data) => { console.info("isNotificationEnabled success, data: " + JSON.stringify(data)); }).catch((err: Base.BusinessError) => { console.error(`isNotificationEnabled failed, code is ${err}`); }); ``` ## Notification.isNotificationEnabled isNotificationEnabled(callback: AsyncCallback\<boolean\>): void 获å–通知使能状æ€ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------- | ---- | ------------------------ | | callback | AsyncCallback\<void\> | 是 | 获å–通知使能状æ€å›žè°ƒå‡½æ•°ã€‚ | **示例:** ```ts import Base from '@ohos.base'; let isNotificationEnabledCallback = (err: Base.BusinessError, data: boolean) => { if (err) { console.info("isNotificationEnabled failed " + JSON.stringify(err)); } else { console.info("isNotificationEnabled success"); } } Notification.isNotificationEnabled(isNotificationEnabledCallback); ``` ## Notification.isNotificationEnabled isNotificationEnabled(): Promise\<boolean\> 获å–通知使能状æ€ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ------ | ------------ | ---- | ---------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | **返回值:** | 类型 | 说明 | | ----------------------------------------------------------- | ------------------------------------------------------------ | | Promise\<boolean\> | 以Promiseå½¢å¼è¿”回获å–通知使能状æ€çš„结果。 | **示例:** ```ts import Base from '@ohos.base'; Notification.isNotificationEnabled().then((data: boolean) => { console.info("isNotificationEnabled success, data: " + JSON.stringify(data)); }).catch((err: Base.BusinessError) => { console.error(`isNotificationEnabled failed, code is ${err}`); }); ``` ## Notification.displayBadge displayBadge(bundle: BundleOption, enable: boolean, callback: AsyncCallback\<void\>): void è®¾å®šæŒ‡å®šåº”ç”¨çš„è§’æ ‡ä½¿èƒ½çŠ¶æ€ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------- | ---- | -------------------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | | enable | boolean | 是 | 使能状æ€ã€‚ | | callback | AsyncCallback\<void\> | 是 | è®¾å®šè§’æ ‡ä½¿èƒ½å›žè°ƒå‡½æ•°ã€‚ | **示例:** ```ts import Base from '@ohos.base'; let displayBadgeCallback = (err: Base.BusinessError) => { if (err) { console.info("displayBadge failed " + JSON.stringify(err)); } else { console.info("displayBadge success"); } } let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.displayBadge(bundle, false, displayBadgeCallback); ``` ## Notification.displayBadge displayBadge(bundle: BundleOption, enable: boolean): Promise\<void\> è®¾å®šæŒ‡å®šåº”ç”¨çš„è§’æ ‡ä½¿èƒ½çŠ¶æ€ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ------ | ------------ | ---- | ---------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | | enable | boolean | 是 | 使能状æ€ã€‚ | **返回值:** | 类型 | 说明 | | ------- |------------| | Promise\<void\> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```ts import Base from '@ohos.base'; let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.displayBadge(bundle, false).then(() => { console.info("displayBadge success"); }).catch((err: Base.BusinessError) => { console.error(`displayBadge failed, code is ${err}`); }); ``` ## Notification.isBadgeDisplayed isBadgeDisplayed(bundle: BundleOption, callback: AsyncCallback\<boolean\>): void èŽ·å–æŒ‡å®šåº”ç”¨çš„è§’æ ‡ä½¿èƒ½çŠ¶æ€ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------- | ---- | ------------------------ | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | | callback | AsyncCallback\<void\> | 是 | 获å–è§’æ ‡ä½¿èƒ½çŠ¶æ€å›žè°ƒå‡½æ•°ã€‚ | **示例:** ```ts import Base from '@ohos.base'; let isBadgeDisplayedCallback = (err: Base.BusinessError, data: boolean) => { if (err) { console.info("isBadgeDisplayed failed " + JSON.stringify(err)); } else { console.info("isBadgeDisplayed success"); } } let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.isBadgeDisplayed(bundle, isBadgeDisplayedCallback); ``` ## Notification.isBadgeDisplayed isBadgeDisplayed(bundle: BundleOption): Promise\<boolean\> èŽ·å–æŒ‡å®šåº”ç”¨çš„è§’æ ‡ä½¿èƒ½çŠ¶æ€ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ------ | ------------ | ---- | ---------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | **返回值:** | 类型 | 说明 | | ----------------------------------------------------------- | ------------------------------------------------------------ | | Promise\<boolean\> | 以Promiseå½¢å¼è¿”å›žèŽ·å–æŒ‡å®šåº”ç”¨çš„è§’æ ‡ä½¿èƒ½çŠ¶æ€ã€‚ | **示例:** ```ts import Base from '@ohos.base'; let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.isBadgeDisplayed(bundle).then((data) => { console.info("isBadgeDisplayed success, data: " + JSON.stringify(data)); }).catch((err: Base.BusinessError) => { console.error(`isBadgeDisplayed failed, code is ${err}`); }); ``` ## Notification.setSlotByBundle setSlotByBundle(bundle: BundleOption, slot: NotificationSlot, callback: AsyncCallback\<void\>): void 设定指定应用的通知通é“(Callbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------- | ---- | -------------------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | | slot | [NotificationSlot](./js-apis-notification.md#notificationslot) | 是 | 通知通é“。 | | callback | AsyncCallback\<void\> | 是 | 设定通知通é“回调函数。 | **示例:** ```ts import Base from '@ohos.base'; import NotificationManager from '@ohos.notificationManager'; let setSlotByBundleCallback = (err: Base.BusinessError) => { if (err) { console.info("setSlotByBundle failed " + JSON.stringify(err)); } else { console.info("setSlotByBundle success"); } } let bundle: Notification.BundleOption = { bundle: "bundleName1", }; let notificationSlot: NotificationManager.NotificationSlot = { type: Notification.SlotType.SOCIAL_COMMUNICATION }; Notification.setSlotByBundle(bundle, notificationSlot, setSlotByBundleCallback); ``` ## Notification.setSlotByBundle setSlotByBundle(bundle: BundleOption, slot: NotificationSlot): Promise\<void\> 设定指定应用的通知通é“(Promiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ------ | ------------ | ---- | ---------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | | slot | [NotificationSlot](./js-apis-notification.md#notificationslot) | 是 | 通知通é“。 | **返回值:** | 类型 | 说明 | | ------- |------------| | Promise\<void\> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```ts import Base from '@ohos.base'; import NotificationManager from '@ohos.notificationManager'; let bundle: Notification.BundleOption = { bundle: "bundleName1", }; let notificationSlot: NotificationManager.NotificationSlot = { type: Notification.SlotType.SOCIAL_COMMUNICATION }; Notification.setSlotByBundle(bundle, notificationSlot).then(() => { console.info("setSlotByBundle success"); }).catch((err: Base.BusinessError) => { console.error(`setSlotByBundle failed, code is ${err}`); }); ``` ## Notification.getSlotsByBundle getSlotsByBundle(bundle: BundleOption, callback: AsyncCallback\<Array\<NotificationSlot>>): void èŽ·å–æŒ‡å®šåº”用的所有通知通é“(Callbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | ---------------------------------------- | ---- | -------------------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | | callback | AsyncCallback\<Array\<[NotificationSlot](./js-apis-notification.md#notificationslot)>> | 是 | 获å–通知通é“回调函数。 | **示例:** ```ts import Base from '@ohos.base'; import NotificationManager from '@ohos.notificationManager'; let getSlotsByBundleCallback = (err: Base.BusinessError, data: NotificationManager.NotificationSlot[]) => { if (err) { console.info("getSlotsByBundle failed " + JSON.stringify(err)); } else { console.info("getSlotsByBundle success"); } } let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.getSlotsByBundle(bundle, getSlotsByBundleCallback); ``` ## Notification.getSlotsByBundle getSlotsByBundle(bundle: BundleOption): Promise\<Array\<NotificationSlot>> èŽ·å–æŒ‡å®šåº”用的所有通知通é“(Promiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ------ | ------------ | ---- | ---------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | **返回值:** | 类型 | 说明 | | ----------------------------------------------------------- | ------------------------------------------------------------ | | Promise\<Array\<[NotificationSlot](./js-apis-notification.md#notificationslot)>> | 以Promiseå½¢å¼è¿”å›žèŽ·å–æŒ‡å®šåº”用的通知通é“。 | **示例:** ```ts import Base from '@ohos.base'; import NotificationManager from '@ohos.notificationManager'; let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.getSlotsByBundle(bundle).then((data: NotificationManager.NotificationSlot[]) => { console.info("getSlotsByBundle success, data: " + JSON.stringify(data)); }).catch((err: Base.BusinessError) => { console.error(`getSlotsByBundle failed, code is ${err}`); }); ``` ## Notification.getSlotNumByBundle getSlotNumByBundle(bundle: BundleOption, callback: AsyncCallback\<number\>): void èŽ·å–æŒ‡å®šåº”ç”¨çš„é€šçŸ¥é€šé“æ•°é‡ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | ------------------------- | ---- | ---------------------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | | callback | AsyncCallback\<number\> | 是 | 获å–é€šçŸ¥é€šé“æ•°é‡å›žè°ƒå‡½æ•°ã€‚ | **示例:** ```ts import Base from '@ohos.base'; import NotificationManager from '@ohos.notificationManager'; let getSlotNumByBundleCallback = (err: Base.BusinessError, data: number) => { if (err) { console.info("getSlotNumByBundle failed " + JSON.stringify(err)); } else { console.info("getSlotNumByBundle success"); } } let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.getSlotNumByBundle(bundle, getSlotNumByBundleCallback); ``` ## Notification.getSlotNumByBundle getSlotNumByBundle(bundle: BundleOption): Promise\<number\> èŽ·å–æŒ‡å®šåº”ç”¨çš„é€šçŸ¥é€šé“æ•°é‡ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ------ | ------------ | ---- | ---------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | **返回值:** | 类型 | 说明 | | ----------------------------------------------------------- | ------------------------------------------------------------ | | Promise\<number\> | 以Promiseå½¢å¼è¿”å›žèŽ·å–æŒ‡å®šåº”ç”¨çš„é€šçŸ¥é€šé“æ•°é‡ã€‚ | **示例:** ```ts import Base from '@ohos.base'; import NotificationManager from '@ohos.notificationManager'; let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.getSlotNumByBundle(bundle).then((data: number) => { console.info("getSlotNumByBundle success, data: " + JSON.stringify(data)); }).catch((err: Base.BusinessError) => { console.error(`getSlotNumByBundle failed, code is ${err}`); }); ``` ## Notification.remove remove(bundle: BundleOption, notificationKey: NotificationKey, reason: RemoveReason, callback: AsyncCallback\<void\>): void åˆ é™¤æŒ‡å®šé€šçŸ¥ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | --------------- | ----------------------------------| ---- | -------------------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | | notificationKey | [NotificationKey](./js-apis-notification.md#notificationkeydeprecated) | 是 | 通知键值。 | | reason | [RemoveReason](#removereason-deprecated) | 是 | é€šçŸ¥åˆ é™¤åŽŸå› ã€‚ | | callback | AsyncCallback\<void\> | 是 | åˆ é™¤æŒ‡å®šé€šçŸ¥å›žè°ƒå‡½æ•°ã€‚ | **示例:** ```ts import Base from '@ohos.base'; let removeCallback = (err: Base.BusinessError) => { if (err) { console.info("remove failed " + JSON.stringify(err)); } else { console.info("remove success"); } } let bundle: Notification.BundleOption = { bundle: "bundleName1", }; let notificationKey: Notification.NotificationKey = { id: 0, label: "label", }; let reason: Notification.RemoveReason = Notification.RemoveReason.CLICK_REASON_REMOVE; Notification.remove(bundle, notificationKey, reason, removeCallback); ``` ## Notification.remove remove(bundle: BundleOption, notificationKey: NotificationKey, reason: RemoveReason): Promise\<void\> åˆ é™¤æŒ‡å®šé€šçŸ¥ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | --------------- | --------------- | ---- | ---------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | | notificationKey | [NotificationKey](./js-apis-notification.md#notificationkeydeprecated) | 是 | 通知键值。 | | reason | [RemoveReason](#removereason-deprecated) | 是 | é€šçŸ¥åˆ é™¤åŽŸå› ã€‚ | **返回值:** | 类型 | 说明 | | ------- |------------| | Promise\<void\> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```ts import Base from '@ohos.base'; let bundle: Notification.BundleOption = { bundle: "bundleName1", }; let notificationKey: Notification.NotificationKey = { id: 0, label: "label", }; let reason: Notification.RemoveReason = Notification.RemoveReason.CLICK_REASON_REMOVE; Notification.remove(bundle, notificationKey, reason).then(() => { console.info("remove success"); }).catch((err: Base.BusinessError) => { console.error(`remove failed, code is ${err}`); }); ``` ## Notification.remove remove(hashCode: string, reason: RemoveReason, callback: AsyncCallback\<void\>): void åˆ é™¤æŒ‡å®šé€šçŸ¥ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------- | ---- | -------------------- | | hashCode | string | 是 | 通知唯一ID。å¯ä»¥é€šè¿‡[onConsume](js-apis-inner-notification-notificationSubscriber-sys.md#onconsume)回调的入å‚[SubscribeCallbackData](#subscribecallbackdata)获å–其内部[NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest)对象ä¸çš„hashCode。 | | reason | [RemoveReason](#removereason-deprecated) | 是 | é€šçŸ¥åˆ é™¤åŽŸå› ã€‚ | | callback | AsyncCallback\<void\> | 是 | åˆ é™¤æŒ‡å®šé€šçŸ¥å›žè°ƒå‡½æ•°ã€‚ | **示例:** ```ts import Base from '@ohos.base'; let hashCode: string = 'hashCode'; let removeCallback = (err: Base.BusinessError) => { if (err) { console.info("remove failed " + JSON.stringify(err)); } else { console.info("remove success"); } } let reason: Notification.RemoveReason = Notification.RemoveReason.CANCEL_REASON_REMOVE; Notification.remove(hashCode, reason, removeCallback); ``` ## Notification.remove remove(hashCode: string, reason: RemoveReason): Promise\<void\> åˆ é™¤æŒ‡å®šé€šçŸ¥ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | ---------- | ---- | ---------- | | hashCode | string | 是 | 通知唯一ID。 | | reason | [RemoveReason](#removereason-deprecated) | 是 | é€šçŸ¥åˆ é™¤åŽŸå› ã€‚ | **返回值:** | 类型 | 说明 | | ------- |------------| | Promise\<void\> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```ts import Base from '@ohos.base'; let hashCode: string = 'hashCode'; let reason: Notification.RemoveReason = Notification.RemoveReason.CLICK_REASON_REMOVE; Notification.remove(hashCode, reason).then(() => { console.info("remove success"); }).catch((err: Base.BusinessError) => { console.error(`remove failed, code is ${err}`); }); ``` ## Notification.removeAll removeAll(bundle: BundleOption, callback: AsyncCallback\<void\>): void åˆ é™¤æŒ‡å®šåº”ç”¨çš„æ‰€æœ‰é€šçŸ¥ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **系统API**ï¼šæ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------- | ---- | ---------------------------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 指定应用的包信æ¯ã€‚ | | callback | AsyncCallback\<void\> | 是 | åˆ é™¤æŒ‡å®šåº”ç”¨çš„æ‰€æœ‰é€šçŸ¥å›žè°ƒå‡½æ•°ã€‚ | **示例:** ```ts import Base from '@ohos.base'; let removeAllCallback = (err: Base.BusinessError) => { if (err) { console.info("removeAll failed " + JSON.stringify(err)); } else { console.info("removeAll success"); } } let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.removeAll(bundle, removeAllCallback); ``` ## Notification.removeAll removeAll(callback: AsyncCallback\<void\>): void åˆ é™¤æ‰€æœ‰é€šçŸ¥ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------- | ---- | -------------------- | | callback | AsyncCallback\<void\> | 是 | åˆ é™¤æ‰€æœ‰é€šçŸ¥å›žè°ƒå‡½æ•°ã€‚ | **示例:** ```ts import Base from '@ohos.base'; let removeAllCallback = (err: Base.BusinessError) => { if (err) { console.info("removeAll failed " + JSON.stringify(err)); } else { console.info("removeAll success"); } } Notification.removeAll(removeAllCallback); ``` ## Notification.removeAll removeAll(bundle?: BundleOption): Promise\<void\> åˆ é™¤æŒ‡å®šåº”ç”¨çš„æ‰€æœ‰é€šçŸ¥ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ------ | ------------ | ---- | ---------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | å¦ | 指定应用的包信æ¯ã€‚é»˜è®¤ä¸ºç©ºï¼Œè¡¨ç¤ºåˆ é™¤æ‰€æœ‰é€šçŸ¥ã€‚ | **返回值:** | 类型 | 说明 | | ------- |------------| | Promise\<void\> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```ts import Base from '@ohos.base'; // 䏿Œ‡å®šåº”ç”¨æ—¶ï¼Œåˆ é™¤æ‰€æœ‰é€šçŸ¥ Notification.removeAll().then(() => { console.info("removeAll success"); }).catch((err: Base.BusinessError) => { console.error(`removeAll failed, code is ${err}`); }); ``` ## Notification.removeAll<sup>8+</sup> removeAll(userId: number, callback: AsyncCallback\<void>): void åˆ é™¤æŒ‡å®šç”¨æˆ·ä¸‹çš„æ‰€æœ‰é€šçŸ¥ï¼ˆcallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ------ | ------------ | ---- | ---------- | | userId | number | 是 | 用户ID。 | | callback | AsyncCallback\<void\> | 是 | åˆ é™¤æŒ‡å®šç”¨æˆ·æ‰€æœ‰é€šçŸ¥å›žè°ƒå‡½æ•°ã€‚ | **示例:** ```ts import Base from '@ohos.base'; function removeAllCallback(err: Base.BusinessError) { if (err) { console.info("removeAll failed " + JSON.stringify(err)); } else { console.info("removeAll success"); } } let userId: number = 1; Notification.removeAll(userId, removeAllCallback); ``` ## Notification.removeAll<sup>8+</sup> removeAll(userId: number): Promise\<void> åˆ é™¤æŒ‡å®šç”¨æˆ·ä¸‹çš„æ‰€æœ‰é€šçŸ¥ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ------ | ------------ | ---- | ---------- | | userId | number | 是 | 用户ID。 | **示例:** ```ts import Base from '@ohos.base'; let userId: number = 1; Notification.removeAll(userId).then(() => { console.info("removeAll success"); }).catch((err: Base.BusinessError) => { console.error(`removeAll failed, code is ${err}`); }); ``` ## Notification.getAllActiveNotifications getAllActiveNotifications(callback: AsyncCallback\<Array\<NotificationRequest>>): void 获å–当剿œªåˆ 除的所有通知(Callbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | ------------------------------------------------------------ | ---- | -------------------- | | callback | AsyncCallback\<Array\<[NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest)>> | 是 | èŽ·å–æ´»åŠ¨é€šçŸ¥å›žè°ƒå‡½æ•°ã€‚ | **示例:** ```ts import Base from '@ohos.base'; import NotificationManager from '@ohos.notificationManager'; function getAllActiveNotificationsCallback(err: Base.BusinessError, data: NotificationManager.NotificationRequest[]) { if (err) { console.info("getAllActiveNotifications failed " + JSON.stringify(err)); } else { console.info("getAllActiveNotifications success"); } } Notification.getAllActiveNotifications(getAllActiveNotificationsCallback); ``` ## Notification.getAllActiveNotifications getAllActiveNotifications(): Promise\<Array\<[NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest)>> 获å–当剿œªåˆ 除的所有通知(Promiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **返回值:** | 类型 | 说明 | | ----------------------------------------------------------- | ------------------------------------------------------------ | | Promise\<Array\<[NotificationRequest](js-apis-inner-notification-notificationRequest.md#notificationrequest)>> | 以Promiseå½¢å¼è¿”å›žèŽ·å–æ´»åŠ¨é€šçŸ¥ã€‚ | **示例:** ```ts import Base from '@ohos.base'; import NotificationManager from '@ohos.notificationManager'; Notification.getAllActiveNotifications().then((data: NotificationManager.NotificationRequest[]) => { console.info("getAllActiveNotifications success, data: " + JSON.stringify(data)); }).catch((err: Base.BusinessError) => { console.error(`getAllActiveNotifications failed, code is ${err}`); }); ``` ## Notification.removeGroupByBundle<sup>8+</sup> removeGroupByBundle(bundle: BundleOption, groupName: string, callback: AsyncCallback\<void\>): void åˆ é™¤æŒ‡å®šåº”ç”¨çš„æŒ‡å®šç»„ä¸‹çš„é€šçŸ¥ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | --------- | --------------------- | ---- | ---------------------------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 应用的包信æ¯ã€‚ | | groupName | string | 是 | 通知组å称。 | | callback | AsyncCallback\<void\> | 是 | åˆ é™¤æŒ‡å®šåº”ç”¨æŒ‡å®šç»„ä¸‹é€šçŸ¥çš„å›žè°ƒå‡½æ•°ã€‚ | **示例:** ```ts import Base from '@ohos.base'; let removeGroupByBundleCallback = (err: Base.BusinessError) => { if (err) { console.info("removeGroupByBundle failed " + JSON.stringify(err)); } else { console.info("removeGroupByBundle success"); } } let bundleOption: Notification.BundleOption = {bundle: "Bundle"}; let groupName: string = "GroupName"; Notification.removeGroupByBundle(bundleOption, groupName, removeGroupByBundleCallback); ``` ## Notification.removeGroupByBundle<sup>8+</sup> removeGroupByBundle(bundle: BundleOption, groupName: string): Promise\<void\> åˆ é™¤æŒ‡å®šåº”ç”¨çš„æŒ‡å®šç»„ä¸‹çš„é€šçŸ¥ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | --------- | ------------ | ---- | -------------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 应用的包信æ¯ã€‚ | | groupName | string | 是 | 通知组å称。 | **返回值:** | 类型 | 说明 | | ------- |------------| | Promise\<void\> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```ts import Base from '@ohos.base'; let bundleOption: Notification.BundleOption = {bundle: "Bundle"}; let groupName: string = "GroupName"; Notification.removeGroupByBundle(bundleOption, groupName).then(() => { console.info("removeGroupByBundle success"); }).catch((err: Base.BusinessError) => { console.error(`removeGroupByBundle failed, code is ${err}`); }); ``` ## Notification.setDoNotDisturbDate<sup>8+</sup> setDoNotDisturbDate(date: DoNotDisturbDate, callback: AsyncCallback\<void\>): void è®¾ç½®å…æ‰“扰时间(Callbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------- | ---- | ---------------------- | | date | [DoNotDisturbDate](#donotdisturbdate8-deprecated) | 是 | å…æ‰“扰时间选项。 | | callback | AsyncCallback\<void\> | 是 | è®¾ç½®å…æ‰“扰时间回调函数。 | **示例:** ```ts import Base from '@ohos.base'; let setDoNotDisturbDateCallback = (err: Base.BusinessError) => { if (err) { console.info("setDoNotDisturbDate failed " + JSON.stringify(err)); } else { console.info("setDoNotDisturbDate success"); } } let doNotDisturbDate: Notification.DoNotDisturbDate = { type: Notification.DoNotDisturbType.TYPE_ONCE, begin: new Date(), end: new Date(2021, 11, 15, 18, 0) }; Notification.setDoNotDisturbDate(doNotDisturbDate, setDoNotDisturbDateCallback); ``` ## Notification.setDoNotDisturbDate<sup>8+</sup> setDoNotDisturbDate(date: DoNotDisturbDate): Promise\<void\> è®¾ç½®å…æ‰“扰时间(Promiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ---- | ---------------- | ---- | -------------- | | date | [DoNotDisturbDate](#donotdisturbdate8-deprecated) | 是 | å…æ‰“扰时间选项。 | **返回值:** | 类型 | 说明 | | ------- |------------| | Promise\<void\> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```ts import Base from '@ohos.base'; let doNotDisturbDate: Notification.DoNotDisturbDate = { type: Notification.DoNotDisturbType.TYPE_ONCE, begin: new Date(), end: new Date(2021, 11, 15, 18, 0) }; Notification.setDoNotDisturbDate(doNotDisturbDate).then(() => { console.info("setDoNotDisturbDate success"); }).catch((err: Base.BusinessError) => { console.error(`setDoNotDisturbDate failed, code is ${err}`); }); ``` ## Notification.setDoNotDisturbDate<sup>8+</sup> setDoNotDisturbDate(date: DoNotDisturbDate, userId: number, callback: AsyncCallback\<void\>): void æŒ‡å®šç”¨æˆ·è®¾ç½®å…æ‰“扰时间(Callbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------- | ---- | ---------------------- | | date | [DoNotDisturbDate](#donotdisturbdate8-deprecated) | 是 | å…æ‰“扰时间选项。 | | userId | number | 是 | è®¾ç½®å…æ‰“扰时间的用户ID。 | | callback | AsyncCallback\<void\> | 是 | è®¾ç½®å…æ‰“扰时间回调函数。 | **示例:** ```ts import Base from '@ohos.base'; let setDoNotDisturbDateCallback = (err: Base.BusinessError) => { if (err) { console.info("setDoNotDisturbDate failed " + JSON.stringify(err)); } else { console.info("setDoNotDisturbDate success"); } } let doNotDisturbDate: Notification.DoNotDisturbDate = { type: Notification.DoNotDisturbType.TYPE_ONCE, begin: new Date(), end: new Date(2021, 11, 15, 18, 0) }; let userId: number = 1; Notification.setDoNotDisturbDate(doNotDisturbDate, userId, setDoNotDisturbDateCallback); ``` ## Notification.setDoNotDisturbDate<sup>8+</sup> setDoNotDisturbDate(date: DoNotDisturbDate, userId: number): Promise\<void\> æŒ‡å®šç”¨æˆ·è®¾ç½®å…æ‰“扰时间(Promiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | ------ | ---------------- | ---- | -------------- | | date | [DoNotDisturbDate](#donotdisturbdate8-deprecated) | 是 | å…æ‰“扰时间选项。 | | userId | number | 是 | è®¾ç½®å…æ‰“扰时间的用户ID。 | **返回值:** | 类型 | 说明 | | ------- |------------| | Promise\<void\> | æ— è¿”å›žç»“æžœçš„Promise对象。 | **示例:** ```ts import Base from '@ohos.base'; let doNotDisturbDate: Notification.DoNotDisturbDate = { type: Notification.DoNotDisturbType.TYPE_ONCE, begin: new Date(), end: new Date(2021, 11, 15, 18, 0) }; let userId: number = 1; Notification.setDoNotDisturbDate(doNotDisturbDate, userId).then(() => { console.info("setDoNotDisturbDate success"); }).catch((err: Base.BusinessError) => { console.error(`setDoNotDisturbDate failed, code is ${err}`); }); ``` ## Notification.getDoNotDisturbDate<sup>8+</sup> getDoNotDisturbDate(callback: AsyncCallback\<DoNotDisturbDate\>): void æŸ¥è¯¢å…æ‰“扰时间(Callbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------------------- | ---- | ---------------------- | | callback | AsyncCallback\<[DoNotDisturbDate](#donotdisturbdate8-deprecated)\> | 是 | æŸ¥è¯¢å…æ‰“扰时间回调函数。 | **示例:** ```ts import Base from '@ohos.base'; let getDoNotDisturbDateCallback = (err: Base.BusinessError, data: Notification.DoNotDisturbDate) => { if (err) { console.info("getDoNotDisturbDate failed " + JSON.stringify(err)); } else { console.info("getDoNotDisturbDate success"); } } Notification.getDoNotDisturbDate(getDoNotDisturbDateCallback); ``` ## Notification.getDoNotDisturbDate<sup>8+</sup> getDoNotDisturbDate(): Promise\<DoNotDisturbDate\> æŸ¥è¯¢å…æ‰“扰时间(Promiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **返回值:** | 类型 | 说明 | | ------------------------------------------------- | ----------------------------------------- | | Promise\<[DoNotDisturbDate](#donotdisturbdate8-deprecated)\> | 以Promiseå½¢å¼è¿”å›žæŸ¥è¯¢åˆ°çš„å…æ‰“扰时间。 | **示例:** ```ts import Base from '@ohos.base'; Notification.getDoNotDisturbDate().then((data: Notification.DoNotDisturbDate) => { console.info("getDoNotDisturbDate success, data: " + JSON.stringify(data)); }).catch((err: Base.BusinessError) => { console.error(`getDoNotDisturbDate failed, code is ${err}`); }); ``` ## Notification.getDoNotDisturbDate<sup>8+</sup> getDoNotDisturbDate(userId: number, callback: AsyncCallback\<DoNotDisturbDate\>): void æŸ¥è¯¢æŒ‡å®šç”¨æˆ·çš„å…æ‰“扰时间(Callbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------------------- | ---- | ---------------------- | | callback | AsyncCallback\<[DoNotDisturbDate](#donotdisturbdate8-deprecated)\> | 是 | æŸ¥è¯¢å…æ‰“扰时间回调函数。 | | userId | number | 是 | 用户ID。 | **示例:** ```ts import Base from '@ohos.base'; let getDoNotDisturbDateCallback = (err: Base.BusinessError, data: Notification.DoNotDisturbDate) => { if (err) { console.info("getDoNotDisturbDate failed " + JSON.stringify(err)); } else { console.info("getDoNotDisturbDate success"); } } let userId: number = 1; Notification.getDoNotDisturbDate(userId, getDoNotDisturbDateCallback); ``` ## Notification.getDoNotDisturbDate<sup>8+</sup> getDoNotDisturbDate(userId: number): Promise\<DoNotDisturbDate\> æŸ¥è¯¢æŒ‡å®šç”¨æˆ·çš„å…æ‰“扰时间(Promiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------------------- | ---- | ---------------------- | | userId | number | 是 | 用户ID。 | **返回值:** | 类型 | 说明 | | ------------------------------------------------- | ----------------------------------------- | | Promise\<[DoNotDisturbDate](#donotdisturbdate8-deprecated)\> | 以Promiseå½¢å¼è¿”å›žæŸ¥è¯¢åˆ°çš„å…æ‰“扰时间。 | **示例:** ```ts import Base from '@ohos.base'; let userId: number = 1; Notification.getDoNotDisturbDate(userId).then((data: Notification.DoNotDisturbDate) => { console.info("getDoNotDisturbDate success, data: " + JSON.stringify(data)); }).catch((err: Base.BusinessError) => { console.error(`getDoNotDisturbDate failed, code is ${err}`); }); ``` ## Notification.supportDoNotDisturbMode<sup>8+</sup> supportDoNotDisturbMode(callback: AsyncCallback\<boolean\>): void æŸ¥è¯¢æ˜¯å¦æ”¯æŒå…打扰功能(Callbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | ------------------------ | ---- | -------------------------------- | | callback | AsyncCallback\<boolean\> | 是 | æŸ¥è¯¢æ˜¯å¦æ”¯æŒå…打扰功能回调函数。 | **示例:** ```ts import Base from '@ohos.base'; let supportDoNotDisturbModeCallback = (err: Base.BusinessError, data: boolean) => { if (err) { console.info("supportDoNotDisturbMode failed " + JSON.stringify(err)); } else { console.info("supportDoNotDisturbMode success"); } } Notification.supportDoNotDisturbMode(supportDoNotDisturbModeCallback); ``` ## Notification.supportDoNotDisturbMode<sup>8+</sup> supportDoNotDisturbMode(): Promise\<boolean\> æŸ¥è¯¢æ˜¯å¦æ”¯æŒå…打扰功能(Promiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **返回值:** | 类型 | 说明 | | ----------------------------------------------------------- | ------------------------------------------------------------ | | Promise\<boolean\> | 以Promiseå½¢å¼è¿”å›žèŽ·å–æ˜¯å¦æ”¯æŒå…打扰功能的结果。 | **示例:** ```ts import Base from '@ohos.base'; Notification.supportDoNotDisturbMode().then((data: boolean) => { console.info("supportDoNotDisturbMode success, data: " + JSON.stringify(data)); }).catch((err: Base.BusinessError) => { console.error(`supportDoNotDisturbMode failed, code is ${err}`); }); ``` ## Notification.enableDistributed<sup>8+</sup> enableDistributed(enable: boolean, callback: AsyncCallback\<void\>): void è®¾ç½®è®¾å¤‡æ˜¯å¦æ”¯æŒåˆ†å¸ƒå¼é€šçŸ¥ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | ------------------------ | ---- | -------------------------- | | enable | boolean | 是 | æ˜¯å¦æ”¯æŒã€‚ | | callback | AsyncCallback\<void\> | 是 | è®¾ç½®è®¾å¤‡æ˜¯å¦æ”¯æŒåˆ†å¸ƒå¼é€šçŸ¥çš„回调函数。 | **示例:** ```ts import Base from '@ohos.base'; let enabledNotificationCallback = (err: Base.BusinessError) => { if (err) { console.info("enableDistributed failed " + JSON.stringify(err)); } else { console.info("enableDistributed success"); } }; let enable: boolean = true; Notification.enableDistributed(enable, enabledNotificationCallback); ``` ## Notification.enableDistributed<sup>8+</sup> enableDistributed(enable: boolean): Promise\<void> è®¾ç½®è®¾å¤‡æ˜¯å¦æ”¯æŒåˆ†å¸ƒå¼é€šçŸ¥ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | ------------------------ | ---- | -------------------------- | | enable | boolean | 是 | æ˜¯å¦æ”¯æŒã€‚ | **示例:** ```ts import Base from '@ohos.base'; let enable: boolean = true; Notification.enableDistributed(enable).then(() => { console.info("enableDistributed success"); }).catch((err: Base.BusinessError) => { console.error(`enableDistributed failed, code is ${err}`); }); ``` ## Notification.enableDistributedByBundle<sup>8+</sup> enableDistributedByBundle(bundle: BundleOption, enable: boolean, callback: AsyncCallback\<void>): void è®¾ç½®æŒ‡å®šåº”ç”¨æ˜¯å¦æ”¯æŒåˆ†å¸ƒå¼é€šçŸ¥ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | ------------------------ | ---- | -------------------------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 应用的包信æ¯ã€‚ | | enable | boolean | 是 | æ˜¯å¦æ”¯æŒã€‚ | | callback | AsyncCallback\<void\> | 是 | åº”ç”¨ç¨‹åºæ˜¯å¦æ”¯æŒåˆ†å¸ƒå¼é€šçŸ¥çš„回调函数。 | **示例:** ```ts import Base from '@ohos.base'; let enableDistributedByBundleCallback = (err: Base.BusinessError) => { if (err) { console.info("enableDistributedByBundle failed " + JSON.stringify(err)); } else { console.info("enableDistributedByBundle success"); } }; let bundle: Notification.BundleOption = { bundle: "bundleName1", }; let enable: boolean = true; Notification.enableDistributedByBundle(bundle, enable, enableDistributedByBundleCallback); ``` ## Notification.enableDistributedByBundle<sup>8+</sup> enableDistributedByBundle(bundle: BundleOption, enable: boolean): Promise\<void> è®¾ç½®æŒ‡å®šåº”ç”¨æ˜¯å¦æ”¯æŒåˆ†å¸ƒå¼é€šçŸ¥ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | ------------------------ | ---- | -------------------------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 应用的包。 | | enable | boolean | 是 | æ˜¯å¦æ”¯æŒã€‚ | **示例:** ```ts import Base from '@ohos.base'; let enable: boolean = true; let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.enableDistributedByBundle(bundle, enable).then(() => { console.info("enableDistributedByBundle success"); }).catch((err: Base.BusinessError) => { console.error(`enableDistributedByBundle failed, code is ${err}`); }); ``` ## Notification.isDistributedEnabledByBundle<sup>8+</sup> isDistributedEnabledByBundle(bundle: BundleOption, callback: AsyncCallback\<boolean>): void æ ¹æ®åº”用的包获å–åº”ç”¨ç¨‹åºæ˜¯å¦æ”¯æŒåˆ†å¸ƒå¼é€šçŸ¥ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | ------------------------ | ---- | -------------------------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 应用的包。 | | callback | AsyncCallback\<boolean\> | 是 | æŸ¥è¯¢æŒ‡å®šåº”ç”¨æ˜¯å¦æ”¯æŒåˆ†å¸ƒå¼é€šçŸ¥çš„回调函数。 | **示例:** ```ts import Base from '@ohos.base'; let isDistributedEnabledByBundleCallback = (err: Base.BusinessError, data: boolean) => { if (err) { console.info("isDistributedEnabledByBundle failed " + JSON.stringify(err)); } else { console.info("isDistributedEnabledByBundle success" + JSON.stringify(data)); } }; let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.isDistributedEnabledByBundle(bundle, isDistributedEnabledByBundleCallback); ``` ## Notification.isDistributedEnabledByBundle<sup>8+</sup> isDistributedEnabledByBundle(bundle: BundleOption): Promise\<boolean> æŸ¥è¯¢æŒ‡å®šåº”ç”¨æ˜¯å¦æ”¯æŒåˆ†å¸ƒå¼é€šçŸ¥ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | ------------------------ | ---- | -------------------------- | | bundle | [BundleOption](./js-apis-inner-notification-notificationCommonDef.md#bundleoption) | 是 | 应用的包。 | **返回值:** | 类型 | 说明 | | ------------------ | ------------------------------------------------- | | Promise\<boolean\> | Promiseæ–¹å¼è¿”å›žæŒ‡å®šåº”ç”¨æ˜¯å¦æ”¯æŒåˆ†å¸ƒå¼é€šçŸ¥çš„结果。 | **示例:** ```ts import Base from '@ohos.base'; let bundle: Notification.BundleOption = { bundle: "bundleName1", }; Notification.isDistributedEnabledByBundle(bundle).then((data: boolean) => { console.info("isDistributedEnabledByBundle success, data: " + JSON.stringify(data)); }).catch((err: Base.BusinessError) => { console.error(`isDistributedEnabledByBundle failed, code is ${err}`); }); ``` ## Notification.getDeviceRemindType<sup>8+</sup> getDeviceRemindType(callback: AsyncCallback\<DeviceRemindType\>): void 获å–通知的æé†’æ–¹å¼ï¼ˆCallbackå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **傿•°ï¼š** | 傿•°å | 类型 | å¿…å¡« | 说明 | | -------- | --------------------------------- | ---- | -------------------------- | | callback | AsyncCallback\<[DeviceRemindType](#deviceremindtype8-deprecated)\> | 是 | 获å–通知æé†’æ–¹å¼çš„回调函数。 | **示例:** ```ts import Base from '@ohos.base'; let getDeviceRemindTypeCallback = (err: Base.BusinessError, data: Notification.DeviceRemindType) => { if (err) { console.info("getDeviceRemindType failed " + JSON.stringify(err)); } else { console.info("getDeviceRemindType success"); } }; Notification.getDeviceRemindType(getDeviceRemindTypeCallback); ``` ## Notification.getDeviceRemindType<sup>8+</sup> getDeviceRemindType(): Promise\<DeviceRemindType\> 获å–通知的æé†’æ–¹å¼ï¼ˆPromiseå½¢å¼ï¼‰ã€‚ **系统能力**:SystemCapability.Notification.Notification **éœ€è¦æƒé™**: ohos.permission.NOTIFICATION_CONTROLLER **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ **返回值:** | 类型 | 说明 | | ------------------ | --------------- | | Promise\<[DeviceRemindType](#deviceremindtype8-deprecated)\> | Promiseæ–¹å¼è¿”回获å–通知æé†’æ–¹å¼çš„结果。 | **示例:** ```ts import Base from '@ohos.base'; Notification.getDeviceRemindType().then((data: Notification.DeviceRemindType) => { console.info("getDeviceRemindType success, data: " + JSON.stringify(data)); }).catch((err: Base.BusinessError) => { console.error(`getDeviceRemindType failed, code is ${err}`); }); ``` ## DoNotDisturbDate<sup>8+</sup> <sup>deprecated</sup> **系统能力**:以下å„项对应的系统能力å‡ä¸ºSystemCapability.Notification.Notification > **说明:** > 从 API version 8开始支æŒï¼Œä»ŽAPI version 9开始废弃。建议使用[notificationManager.DoNotDisturbDate](js-apis-notificationManager-sys.md#donotdisturbdate)替代 **系统API**ï¼šæ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ | åç§° | 类型 | å¯è¯» | å¯å†™ | 说明 | | ----- | -------------------------------------- | ---- | ---- | ---------------------- | | type | [DoNotDisturbType](./js-apis-notificationManager-sys.md#donotdisturbtype) | 是 | 是 | å…æ‰“扰设置的时间类型。 | | begin | Date | 是 | 是 | å…æ‰“扰设置的起点时间。 | | end | Date | 是 | 是 | å…æ‰“扰设置的终点时间。 | ## DoNotDisturbType<sup>8+</sup> <sup>deprecated</sup> **系统能力**:以下å„项对应的系统能力å‡ä¸ºSystemCapability.Notification.Notification > **说明:** > 从 API version 8开始支æŒï¼Œä»ŽAPI version 9开始废弃。建议使用[notificationManager.DoNotDisturbType](js-apis-notificationManager-sys.md#donotdisturbtype)替代 **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ | åç§° | 值 | 说明 | | ------------ | ---------------- | ------------------------------------------ | | TYPE_NONE | 0 | éžé€šçŸ¥å‹¿æ‰°ç±»åž‹ã€‚ | | TYPE_ONCE | 1 | 以设置时间段(åªçœ‹å°æ—¶å’Œåˆ†é’Ÿ)一次执行勿扰。 | | TYPE_DAILY | 2 | 以设置时间段(åªçœ‹å°æ—¶å’Œåˆ†é’Ÿ)æ¯å¤©æ‰§è¡Œå‹¿æ‰°ã€‚ | | TYPE_CLEARLY | 3 | 以设置时间段(明确年月日时分)执行勿扰。 | ## DeviceRemindType<sup>8+</sup> <sup>deprecated</sup> **系统能力**:SystemCapability.Notification.Notification **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ > **说明:** > 从 API version 8开始支æŒï¼Œä»ŽAPI version 9开始废弃。建议使用[notificationManager.DeviceRemindType](js-apis-notificationManager-sys.md#deviceremindtype)替代 | åç§° | 值 | 说明 | | -------------------- | --- | --------------------------------- | | IDLE_DONOT_REMIND | 0 | è®¾å¤‡æœªè¢«ä½¿ç”¨ï¼Œæ— éœ€æé†’。 | | IDLE_REMIND | 1 | æé†’设备未被使用。 | | ACTIVE_DONOT_REMIND | 2 | 设备æ£åœ¨ä½¿ç”¨ï¼Œæ— 需æé†’。 | | ACTIVE_REMIND | 3 | æé†’设备æ£åœ¨ä½¿ç”¨ã€‚ | ## SourceType<sup>8+</sup> <sup>deprecated</sup> **系统能力**:SystemCapability.Notification.Notification **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ > **说明:** > 从 API version 8开始支æŒï¼Œä»ŽAPI version 9开始废弃。建议使用[notificationManager.SourceType](js-apis-notificationManager-sys.md#sourcetype)替代 | åç§° | 值 | 说明 | | -------------------- | --- | -------------------- | | TYPE_NORMAL | 0 | 一般通知。 | | TYPE_CONTINUOUS | 1 | 连ç»é€šçŸ¥ã€‚ | | TYPE_TIMER | 2 | 计划通知。 | ## RemoveReason <sup>deprecated</sup> **系统能力**:SystemCapability.Notification.Notification **系统API**: æ¤æŽ¥å£ä¸ºç³»ç»ŸæŽ¥å£ï¼Œä¸‰æ–¹åº”ç”¨ä¸æ”¯æŒè°ƒç”¨ã€‚ > **说明:** > 从 API version 7开始支æŒï¼Œä»ŽAPI version 9开始废弃。建议使用[notificationManager.RemoveReason](js-apis-notificationSubscribe-sys.md#removereason)替代 | åç§° | 值 | 说明 | | -------------------- | --- | -------------------- | | CLICK_REASON_REMOVE | 1 | 点击通知åŽåˆ 除通知。 | | CANCEL_REASON_REMOVE | 2 | ç”¨æˆ·åˆ é™¤é€šçŸ¥ã€‚ |