From ab7deb348c269eab298e606c5283fead08960530 Mon Sep 17 00:00:00 2001 From: zhengzhuolan Date: Sat, 28 Jun 2025 15:45:48 +0800 Subject: [PATCH] disableNotificationFeature interface description Signed-off-by: zhengzhuolan --- .../js-apis-notificationManager-sys.md | 60 +++++++++++++++++++ 1 file changed, 60 insertions(+) diff --git a/zh-cn/application-dev/reference/apis-notification-kit/js-apis-notificationManager-sys.md b/zh-cn/application-dev/reference/apis-notification-kit/js-apis-notificationManager-sys.md index 0bc2e29d8f3..f09b09e8dd7 100644 --- a/zh-cn/application-dev/reference/apis-notification-kit/js-apis-notificationManager-sys.md +++ b/zh-cn/application-dev/reference/apis-notification-kit/js-apis-notificationManager-sys.md @@ -4637,6 +4637,66 @@ try { } ``` +## notificationManager.disableNotificationFeature20+ + +disableNotificationFeature(disabled: boolean, bundleList: Array\, userId: number): Promise\ + +将应用包名添加到通知发布权限管控名单,以阻止应用发布通知。支持启用或关闭该功能。 + +该接口不支持wearable设备。 + +**系统能力**:SystemCapability.Notification.Notification + +**需要权限**:ohos.permission.NOTIFICATION_CONTROLLER 或 ohos.permission.MANAGE_EDM_POLICY + +**系统接口**:此接口为系统接口。 + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------------------------------------------ | ---- | ------------------------ | +| disabled | boolean | 是 | 表示是否启用通知发布权限管控名单。true表示启用,false表示关闭。 | +| bundleList | Array\ | 是 | 指定通知发布权限管控名单的应用列表,使用包名表示应用。 | +| userId | number | 是 | 表示用户ID。 | + +**返回值:** + +| 类型 | 说明 | +|-----------------|-------------------------| +| Promise\ | Promise对象,无返回结果。 | + +**错误码**: + +以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[通知错误码](./errorcode-notification.md)。 + +| 错误码ID | 错误信息 | +| -------- | ------------------------------------------------------------ | +| 201 | Permission verification failed. The application does not have the permission required to call the API. | +| 202 | Permission verification failed. A non-system application calls a system API. | +| 1600001 | Internal error. | +| 1600002 | Marshalling or unmarshalling error. | + +**示例:** + +```ts +import { notificationManager } from '@kit.NotificationKit'; +import { BusinessError } from '@kit.BasicServicesKit'; +import { hilog } from '@kit.PerformanceAnalysisKit'; + +let disabled: boolean = true; +let bundleList: Array = ["com.example.myapplication"]; +let userId: number = 1; +try { + notificationManager.disableNotificationFeature(disabled, bundleList, userId).then(() => { + hilog.info(0x0000, 'testTag', '%{public}s', `disableNotificationFeature success.`); + }).catch((err: BusinessError) => { + hilog.error(0x0000, 'testTag', '%{public}s', `disableNotificationFeature failed, code is ${err.code}, message is ${err.message}`); + }); +} catch (err) { + hilog.error(0x0000, 'testTag', '%{public}s', `testTag failed, code is ${err.code}, message is ${err.message}`); +} +``` + ## notificationManager.setTargetDeviceStatus18+ setTargetDeviceStatus(deviceType: string, status: number): Promise\ -- Gitee