harmony 鸿蒙通知消息跨设备协同管理（仅对系统应用开放）

2025-06-12
浏览 (8)

通知消息跨设备协同管理（仅对系统应用开放）

默认情况下，通知消息会进行跨设备协同。如果应用已通过分布式通信能力实现跨设备协同（例如短信通知消息由短信应用本身协同到手表、平板、2in1等设备），为了避免通知消息在不同设备上重复发送，需要针对分布式通知的协同设备进行管理。

从API version 18开始，支持系统应用通过以下方式对分布式通知的协同设备进行管理：

当应用的某个通知消息仅在当前设备发布时，需要将NotificationRequest参数中的notDistributed字段配置为true。
当应用的某个通知消息需要按设备管控名单发布时，需要将NotificationRequest参数中的notDistributed字段配置为false，forceDistributed字段为配置true。

接口说明

接口名	描述	说明
publish(request: NotificationRequest): Promise<void>	发布通知。	具体使用方法见入参对象NotificationRequest中notDistributed与forceDistributed字段说明。

开发步骤

导入模块。

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

通知消息跨设备协同管理。

配置应用通知消息仅在当前设备上发布。

// publish回调
let publishCallback = (err: BusinessError): void => {
  if (err) {
    console.error(`Failed to publish notification. Code is ${err.code}, message is ${err.message}`);
  } else {
    console.info(`Succeeded in publishing notification.`);
  }
}
// 通知Request对象
let notificationRequest: notificationManager.NotificationRequest = {
  id: 1,
  content: {
    notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
    normal: {
      title: 'test_title',
      text: 'test_text',
      additionalText: 'test_additionalText'
      }
    },
    // 配置应用通知消息仅在当前设备上发布。
    notDistributed: true
};
notificationManager.publish(notificationRequest, publishCallback);

配置应用通知消息根据管控名单跨设备协同发布。

// publish回调
let publishCallback = (err: BusinessError): void => {
  if (err) {
    console.error(`Failed to publish notification. Code is ${err.code}, message is ${err.message}`);
  } else {
    console.info(`Succeeded in publishing notification.`);
  }
}
// 通知Request对象
let notificationRequest: notificationManager.NotificationRequest = {
  id: 1,
  content: {
    notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
    normal: {
      title: 'test_title',
      text: 'test_text',
      additionalText: 'test_additionalText'
      }
    },
    // 配置应用通知消息根据管控名单跨设备协同发布。
    notDistributed: false,
    forceDistributed: true
};
notificationManager.publish(notificationRequest, publishCallback);