从API版本26.0.0开始,支持跨空间消息提醒的能力。
Enterprise Space Kit为应用提供跨空间消息提醒的能力,支持企业空间与个人空间之间的双向通知互通:企业应用可主动触达个人空间,个人空间的应用也能将关键信息同步至企业空间。
企业管理员可调用配置接口控制“设置 > 通知和状态栏 > 通知管理”路径下的开关,以及是否隐藏通知内容,同时还能通过查询接口实时获取当前的配置状态。
详细接口说明可参考接口文档。
| 接口名 | 描述 |
|---|---|
| setNotificationConfig(configs: NotificationConfig[]): Promise<void> | 设置跨空间消息提醒配置。 |
| getNotificationConfig(): Promise<NotificationConfig[]> | 获取跨空间消息提醒配置。 |
导入跨空间消息提醒API模块相关依赖。
import { spaceManager } from '@kit.EnterpriseSpaceKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { ErrCode } from '../../common/ErrCode'; 跨空间消息提醒API接口封装。
const TAG = '[Sample_SpaceManagerSample]';
const DOMAIN = 0xF811;
export class NotificationConfigApi {
static async setNotificationConfig(configs: spaceManager.NotificationConfig[]): Promise<number> {
try {
await spaceManager.setNotificationConfig(configs);
hilog.info(DOMAIN, TAG, 'Succeeded in setting notification config.');
return ErrCode.OK;
} catch (err) {
hilog.error(DOMAIN, TAG, `Failed to set notification config. Code: ${err.code}, message: ${err.message}`);
return ErrCode.ERR;
}
}
static async getNotificationConfig(): Promise<spaceManager.NotificationConfig[] | undefined> {
try {
const configs: spaceManager.NotificationConfig[] = await spaceManager.getNotificationConfig();
hilog.info(DOMAIN, TAG, `Succeeded in getting notification config. configs: ${JSON.stringify(configs)}`);
return configs;
} catch (err) {
hilog.error(DOMAIN, TAG, `Failed to get notification config. Code: ${err.code}, message: ${err.message}`);
return undefined;
}
}
} 导入跨空间消息提醒业务实现相关依赖。
import { router } from '@kit.ArkUI';
import { spaceManager } from '@kit.EnterpriseSpaceKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { ErrCode } from '../../common/ErrCode';
import { NotificationConfigApi } from '../api/NotificationConfigApi' 跨空间消息提醒业务相关实现。
const TAG = '[Sample_SpaceManagerSample]';
const DOMAIN = 0xF811;
@Entry
@Component
struct NotificationConfigPage {
async setNotificationConfig() {
const configs: spaceManager.NotificationConfig[] = [
{
workspaceId: 100, // 空间ID,由用户配置
appIdentifier: '691867************', // 应用的唯一标识,请根据实际情况进行替换。
notificationState: spaceManager.NotificationSwitch.ON,
visibilityState: spaceManager.NotificationVisibilitySwitch.NOTIFICATION_VISIBLE,
allowVisibilityChange: spaceManager.NotificationVisibilityControl.ALLOW_CHANGE,
}
];
if (await NotificationConfigApi.setNotificationConfig(configs) !== ErrCode.ERR) {
// 处理后置逻辑
} else {
// 异常处理
hilog.error(DOMAIN, TAG, 'Failed to set notification config!');
return;
}
}
async getNotificationConfig() {
const configs: spaceManager.NotificationConfig[] | undefined =
await NotificationConfigApi.getNotificationConfig();
if (configs === undefined) {
// 异常处理
hilog.error(DOMAIN, TAG, 'Failed to get notification config!');
return;
}
// 处理后置逻辑
}
build() {
Column() {
Row() {
Button($r('app.string.setNotificationConfig'))
.buttonCommonStyle()
.onClick(() => {
this.setNotificationConfig();
})
}
Row() {
Button($r('app.string.getNotificationConfig'))
.buttonCommonStyle()
.onClick(() => {
this.getNotificationConfig();
})
}
Row() {
Button($r('app.string.back'))
.buttonCommonStyle()
.onClick(() => {
router.back();
})
}
}
}
}
@Extend(Button)
function buttonCommonStyle() {
.width(200)
.height(50)
.backgroundColor('#6366F1')
.fontColor('#FFFFFF')
.fontSize(14)
.margin({ left: 20, bottom: 5 })
}