HarmonyOS入门之通知中集成行为意图

精选原创

Datcon 2024-05-24 15:18:17 博主文章分类：Harmony ©著作权

文章标签 WantAgent Harmony 文章分类 Android 移动开发

©著作权归作者所有：来自51CTO博客作者Datcon的原创作品，请联系作者获取转载授权，否则将追究法律责任

在HarmonyOS应用开发中，为了提升用户体验和应用间交互的效率，开发者往往需要利用通知（Notification）来传达信息并引导用户执行特定操作。其中，WantAgent作为一种强大的功能，允许开发者封装应用的行为意图，如启动特定的应用组件或发布公共事件。本文将详细介绍如何在HarmonyOS应用中，结合NotificationManager和WantAgent，为通知添加行为意图，从而在用户点击通知时执行预设的操作。

WantAgent核心概念

WantAgent是HarmonyOS提供的一种机制，旨在封装应用的行为意图。这些意图可以简单到打开一个应用页面，也可以复杂到触发一系列后台服务操作。通过将WantAgent附加到通知上，开发者能够确保用户与通知的交互不仅限于阅读信息，还能直接响应并执行应用内部的逻辑。

实现机制概览

HarmonyOS入门之通知中集成行为意图_Harmony

如图所示，当应用需要发布带有行为意图的通知时，会先向Ability Manager Service（AMS）申请一个WantAgent。这个WantAgent包含了想要执行的操作细节，随后它被嵌入到通知消息中。一旦用户点击通知栏上的通知，系统就会触发该WantAgent，执行其定义的行为，例如启动一个特定的Ability。

接口说明

在实现这一功能前，了解关键的WantAgent接口是必要的。以下是一些常用接口的简要说明：

getWantAgent: 用于根据提供的WantAgent信息创建一个WantAgent实例。
trigger: 触发WantAgent中封装的意图。
cancel: 取消尚未触发的WantAgent。
getWant: 获取WantAgent中封装的原始Want对象。
equal: 判断两个WantAgent实例是否相等。

开发步骤

1. 导入所需模块

首先，确保导入了@ohos.notificationManager和@ohos.app.ability.wantAgent模块。

import NotificationManager from '@ohos.notificationManager';
import wantAgent from '@ohos.app.ability.wantAgent';

2. 创建WantAgent

场景一：拉起Ability

let wantAgentInfo = {
    wants: [{
        deviceId: '', // 设备ID，如果目标在当前设备则为空
        bundleName: 'com.example.test', // 目标应用的包名
        abilityName: 'com.example.test.MainAbility', // 目标Ability的名称
        action: '', // 动作类型
        entities: [], // 实体列表
        uri: '', // 资源URI
        parameters: {} // 参数
    }],
    operationType: wantAgent.OperationType.START_ABILITY, // 操作类型：启动Ability
    requestCode: 0, // 请求码
    wantAgentFlags: [wantAgent.WantAgentFlags.CONSTANT_FLAG] // WantAgent标志
};

wantAgent.getWantAgent(wantAgentInfo, (err, data) => {
    if (!err) {
        wantAgentObj = data;
    }
});

场景二：发布公共事件

let wantAgentInfo = {
    wants: [{
        action: 'event_name', // 公共事件名
        parameters: {} // 事件参数
    }],
    operationType: wantAgent.OperationType.SEND_COMMON_EVENT, // 操作类型：发送公共事件
    requestCode: 0,
    wantAgentFlags: [wantAgent.WantAgentFlags.CONSTANT_FLAG]
};

// 创建WantAgent过程同上

3. 构造并发布通知

结合WantAgent，构造NotificationRequest对象，并发布通知。

let notificationRequest = {
    content: {
        contentType: NotificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
        normal: {
            title: '测试通知',
            text: '请点击查看',
            additionalText: '附加信息'
        }
    },
    id: 1,
    label: '测试标签',
    wantAgent: wantAgentObj // 将创建好的WantAgent附加到通知中
};

NotificationManager.publish(notificationRequest, (err) => {
    if (err) {
        console.error(`发布通知失败: ${err}`);
    } else {
        console.log('通知发布成功！');
    }
});