openharmony 鸿蒙 js-apis-notificationExtensionSubscription

2026-08-25 浏览 (1)

@ohos.notificationExtensionSubscription (notificationExtensionSubscription模块)

本模块提供管理通知扩展的能力，具体包括：打开通知扩展订阅设置界面、订阅和取消订阅通知扩展、获取和设置通知授权状态。

说明：

本模块首批接口从API version 22开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import { notificationExtensionSubscription } from '@kit.NotificationKit';
import { BusinessError } from '@kit.BasicServicesKit';

notificationExtensionSubscription.openSubscriptionSettings

openSubscriptionSettings(context: UIAbilityContext): Promise<void>

打开应用的通知扩展订阅授权页面，以半模态弹窗形式显示。用户可在该页面授权“允许获取本机通知”开关与“已获取的本机通知”应用开关。使用Promise异步回调。

系统能力：SystemCapability.Notification.Notification

需要权限：ohos.permission.SUBSCRIBE_NOTIFICATION

参数：

参数名类型必填说明
contextUIAbilityContext是通知设置页面绑定Ability的上下文。

返回值：

类型说明
Promise<void>Promise对象，无返回结果。

错误码：

以下错误码的详细介绍请参见通用错误码和通知错误码。

错误码ID错误信息
201Permission denied or current device not supported.
1600001Internal error.
1600018The notification settings window is already displayed.
1600023The application does not implement the NotificationSubscriberExtensionAbility.

示例：

import { common } from '@kit.AbilityKit';

try {
  // 请在组件内获取context，确保this.getUIContext().getHostContext()返回结果为UIAbilityContext。
  let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  notificationExtensionSubscription.openSubscriptionSettings(context).then(() => {
    console.info(`openSubscriberSettings success`);
  }).catch((e:Error) => {
    let error = e as BusinessError
    console.error(`failed to call openSubscriptionSettings ${JSON.stringify(error)}`)
  });
} catch (error) {
  console.error(`failed to call openSubscriptionSettings ${JSON.stringify(error)}`)
}

notificationExtensionSubscription.openSubscriptionSettingsWithResult

openSubscriptionSettingsWithResult(context: UIAbilityContext): Promise<UserGrantSetting>

打开应用的通知扩展订阅授权页面，以半模态弹窗形式显示。用户可在该页面授权“允许获取本机通知”开关与“已获取的本机通知”应用开关。使用Promise异步回调，当半模态窗口关闭时返回用户设置的授权的结果。

起始版本：26.0.0

模型约束：此接口仅可在Stage模型下使用。

系统能力：SystemCapability.Notification.Notification

需要权限：ohos.permission.SUBSCRIBE_NOTIFICATION

参数：

参数名类型必填说明
contextUIAbilityContext是通知设置页面绑定Ability的上下文。

返回值：

类型说明
Promise<UserGrantSetting>Promise对象，返回用户设置的授权的结果。

错误码：

以下错误码的详细介绍请参见通用错误码和通知错误码。

错误码ID错误信息
201Permission denied or current device not supported.
1600001Internal error.
1600018The notification settings window is already displayed.
1600023The application does not implement the NotificationSubscriberExtensionAbility.

示例：

import { common } from '@kit.AbilityKit';

try {
  // 请在组件内获取context，确保this.getUIContext().getHostContext()返回结果为UIAbilityContext。
  let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  notificationExtensionSubscription.openSubscriptionSettingsWithResult(context).then((data) => {
    console.info(`openSubscriptionSettingsWithResult success, data: ${JSON.stringify(data)}`);
  }).catch((e:Error) => {
    let error = e as BusinessError
    console.error(`failed to call openSubscriptionSettingsWithResult ${JSON.stringify(error)}`)
  });
} catch (error) {
  console.error(`failed to call openSubscriptionSettingsWithResult ${JSON.stringify(error)}`)
}

notificationExtensionSubscription.subscribe

subscribe(info: NotificationExtensionSubscriptionInfo[]): Promise<void>

订阅通知扩展。使用蓝牙模块相关接口获取蓝牙设备的唯一地址后方可订阅。使用Promise异步回调。

系统能力：SystemCapability.Notification.Notification

需要权限：ohos.permission.SUBSCRIBE_NOTIFICATION

参数：

参数名类型必填说明
infoNotificationExtensionSubscriptionInfo[]是订阅的信息列表（数组）。

返回值：

类型说明
Promise<void>Promise对象，无返回结果。

错误码：

以下错误码的详细介绍请参见通用错误码和通知错误码。

错误码ID错误信息
201Permission denied or current device not supported.
1600001Internal error.
1600003Failed to connect to the service.
1600023The application does not implement the NotificationSubscriberExtensionAbility.

示例：


let infos: notificationExtensionSubscription.NotificationExtensionSubscriptionInfo[] = [
  {
    addr: '01:23:45:67:89:AB', // 使用动态获取的蓝牙地址
    type: notificationExtensionSubscription.SubscribeType.BLUETOOTH
  }
];
notificationExtensionSubscription.subscribe(infos).then(() => {
  console.info("subscribe success");
}).catch((err: BusinessError) => {
  console.error(`subscribe fail: ${JSON.stringify(err)}`);
});

notificationExtensionSubscription.unsubscribe

unsubscribe(): Promise<void>

取消通知扩展的订阅。使用Promise异步回调。

系统能力：SystemCapability.Notification.Notification

需要权限：ohos.permission.SUBSCRIBE_NOTIFICATION

返回值：

类型说明
Promise<void>Promise对象，无返回结果。

错误码：

以下错误码的详细介绍请参见通用错误码和通知错误码。

错误码ID错误信息
201Permission denied or current device not supported.
1600001Internal error.
1600003Failed to connect to the service.

示例：


notificationExtensionSubscription.unsubscribe().then(() => {
  console.info("unsubscribe success");
}).catch((err: BusinessError) => {
  console.error(`unsubscribe fail: ${JSON.stringify(err)}`);
});

notificationExtensionSubscription.getSubscribeInfo

getSubscribeInfo(): Promise<NotificationExtensionSubscriptionInfo[]>

获取当前应用的通知扩展订阅信息。使用Promise异步回调。

系统能力：SystemCapability.Notification.Notification

需要权限：ohos.permission.SUBSCRIBE_NOTIFICATION

返回值：

类型说明
Promise<NotificationExtensionSubscriptionInfo[]>Promise对象，返回一个NotificationExtensionSubscriptionInfo[]对象数组，表示应用的订阅信息。

错误码：

以下错误码的详细介绍请参见通用错误码和通知错误码。

错误码ID错误信息
201Permission denied or current device not supported.
1600001Internal error.
1600003Failed to connect to the service.

示例：


notificationExtensionSubscription.getSubscribeInfo().then((data: notificationExtensionSubscription.NotificationExtensionSubscriptionInfo[]) => {
  console.info(`getSubscribeInfo successfully. Data: ${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
  console.error(`getSubscribeInfo fail: ${JSON.stringify(err)}`);
});

notificationExtensionSubscription.isUserGranted

isUserGranted(): Promise<boolean>

查询“允许获取本机通知”的开关状态。使用Promise异步回调。

系统能力：SystemCapability.Notification.Notification

需要权限：ohos.permission.SUBSCRIBE_NOTIFICATION

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示功能已启用；返回false表示功能未启用。

错误码：

以下错误码的详细介绍请参见通用错误码和通知错误码。

错误码ID错误信息
201Permission denied or current device not supported.
1600001Internal error.
1600003Failed to connect to the service.

示例：


notificationExtensionSubscription.isUserGranted().then((isOpen: boolean) => {
  if (isOpen) {
    console.info('isUserGranted true');
  } else {
    console.info('isUserGranted false');
  }
}).catch((err: BusinessError) => {
  console.error(`isUserGranted fail: ${JSON.stringify(err)}`);
});

notificationExtensionSubscription.getUserGrantedEnabledBundles

getUserGrantedEnabledBundles(): Promise<GrantedBundleInfo[]>

获取指定应用中“已获取的本机通知”通知开关开启的应用列表。使用Promise异步回调。

系统能力：SystemCapability.Notification.Notification

需要权限：ohos.permission.SUBSCRIBE_NOTIFICATION

返回值：

类型说明
Promise<GrantedBundleInfo[]>Promise对象，返回获取指定应用中“已获取的本机通知”通知开关开启的应用列表。

错误码：

以下错误码的详细介绍请参见通用错误码和通知错误码。

错误码ID错误信息
201Permission denied or current device not supported.
1600001Internal error.
1600003Failed to connect to the service.

示例：


notificationExtensionSubscription.getUserGrantedEnabledBundles().then((data: notificationExtensionSubscription.GrantedBundleInfo[]) => {
  console.info(`getUserGrantedEnabledBundles successfully. Data: ${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
  console.error(`getUserGrantedEnabledBundles fail: ${JSON.stringify(err)}`);
});

NotificationExtensionSubscriptionInfo

type NotificationExtensionSubscriptionInfo = _NotificationExtensionSubscriptionInfo

用于描述通知扩展订阅的信息。

系统能力： SystemCapability.Notification.Notification

类型说明
_NotificationExtensionSubscriptionInfo用于描述通知扩展订阅的信息。

NotificationInfo

type NotificationInfo = _NotificationInfo

通知订阅扩展能力中onReceiveMessage回调的通知信息。

系统能力：SystemCapability.Notification.Notification

类型说明
_NotificationInfo通知订阅扩展能力中onReceiveMessage回调的通知信息。

SubscribeType

表示通知扩展订阅的类型。

系统能力：SystemCapability.Notification.Notification

名称值说明
BLUETOOTH0通过蓝牙订阅通知。

BundleOption

type BundleOption = _BundleOption

指定应用的包信息。

系统能力： SystemCapability.Notification.Notification

类型说明
_BundleOption指定应用的包信息。

GrantedBundleInfo

type GrantedBundleInfo = _GrantedBundleInfo

授权应用的包信息。

系统能力： SystemCapability.Notification.Notification

类型说明
_GrantedBundleInfo授权应用的包信息。

UserGrantSetting

type UserGrantSetting = _UserGrantSetting

用户授权的设置信息。

起始版本：26.0.0

模型约束：此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Notification.Notification

类型说明
_UserGrantSetting用户授权的设置信息。

你可能感兴趣的鸿蒙文章

openharmony 鸿蒙 js-apis-inner-notification-notificationFlags

openharmony 鸿蒙 js-apis-notificationSubscribe-sys

openharmony 鸿蒙 js-apis-notificationSubscriberExtensionAbility

openharmony 鸿蒙 errorcode-notification

openharmony 鸿蒙 js-apis-inner-notification-notificationExtensionContent

openharmony 鸿蒙 js-apis-notification-sys

openharmony 鸿蒙 js-apis-inner-notification-notificationContent-sys

openharmony 鸿蒙 js-apis-inner-notification-notificationCommonDef

openharmony 鸿蒙 Readme-CN

openharmony 鸿蒙 js-apis-inner-notification-notificationTemplate

  • 所属分类： 后端技术
  • 本文标签： 鸿蒙 软件
  • 版权声明： 本文链接 https://seaxiang.com/blog/juxM1d4V