应用必要吸收关照,必须先发起订阅,关照子体系提供两种接口:订阅所有应用发布的关照和订阅某些应用发布的关照。
体系提供[NotificationSubscriber]对象,用于提供订阅成功、关照吸收、关照取消、订阅取消等回调接口,将变化信息回调给订阅者。
关照订阅原理
关照业务流程由关照子体系、关照发送端、关照订阅端组成。一条关照从关照发送端产生,通过[IPC通讯]发送到关照子体系,再由关照子体系分发给关照订阅端。
- 关照发送端:可以是三方应用或体系应用。开发者重点关注。
- 关照订阅端:只能为体系应用,比如关照中心。关照中心默认会订阅手机上所有应用对当前用户的关照。开发者无需关注。
图1 关照业务流程
接口阐明
表1 关照订阅接口先容
接口名形貌subscribe(subscriber: NotificationSubscriber, info: NotificationSubscribeInfo, callback: AsyncCallback): void订阅指定应用关照。subscribe(subscriber: NotificationSubscriber, callback: AsyncCallback): void订阅所有关照。 表2 关照订阅回调接口先容
接口名形貌onConsume?: (data: SubscribeCallbackData) => void关照回调。onCancel?: (data: SubscribeCallbackData) => void关照取消回调。onUpdate?: (data: NotificationSortingMap) => void关照排序更新回调。onConnect?: () => void;订阅成功回调。onDisconnect?: () => void;取消订阅回调。onDestroy?: () => void与关照子体系断开回调。onDoNotDisturbDateChangedeprecated?: (mode: notification.DoNotDisturbDatedeprecated) => void免打搅时间选项变更回调(从API11起已废弃)。onDoNotDisturbChanged?: (mode: notificationManager.DoNotDisturbDate) => void免打搅时间选项变更回调。onEnabledNotificationChanged?: (callbackData: EnabledNotificationCallbackData) => void关照开关变更回调。onBadgeChanged?: (data: BadgeNumberCallbackData) => void应用角标个数变化回调。 开发步骤
- 申请ohos.permission.NOTIFICATION_CONTROLLER权限
- 导入关照订阅模块。
- import { notificationSubscribe } from '@kit.NotificationKit';
- import { BusinessError } from '@kit.BasicServicesKit';
- import { hilog } from '@kit.PerformanceAnalysisKit';
- const TAG: string = '[SubscribeOperations]';
- const DOMAIN_NUMBER: number = 0xFF00;
- ts
复制代码 - 创建订阅者对象。
- let subscriber:notificationSubscribe.NotificationSubscriber = {
- onConsume: (data:notificationSubscribe.SubscribeCallbackData) => {
- let req: notificationManager.NotificationRequest = data.request;
- hilog.info(DOMAIN_NUMBER, TAG, `onConsume callback. req.id: ${req.id}`);
- },
- onCancel: (data:notificationSubscribe.SubscribeCallbackData) => {
- let req: notificationManager.NotificationRequest = data.request;
- hilog.info(DOMAIN_NUMBER, TAG, `onCancel callback. req.id: ${req.id}`);
- },
- onUpdate: (data) => {
- hilog.info(DOMAIN_NUMBER, TAG, `onUpdate callback. req.id: ${data.sortedHashCode}`);
- },
- onConnect: () => {
- hilog.info(DOMAIN_NUMBER, TAG, `onConnect callback.`);
- },
- onDisconnect: () => {
- hilog.info(DOMAIN_NUMBER, TAG, `onDisconnect callback.`);
- },
- onDestroy: () => {
- hilog.info(DOMAIN_NUMBER, TAG, `onDestroy callback.`);
- },
- };
- ts
复制代码 - 发起关照订阅。
- notificationSubscribe.subscribe(subscriber, (err: BusinessError) => { // callback形式调用异步接口
- if (err) {
- hilog.error(DOMAIN_NUMBER, TAG, `Failed to subscribe notification. Code is ${err.code}, message is ${err.message}`);
- return;
- }
- });
复制代码
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。 |