鸿蒙HarmonyOS实战-ArkTS语言基础类库（通知）

蜀道山QAQ2024-06-07 15:18

🚀前言

移动应用中的通知是指应用程序发送给用户的一种提示或提醒消息。这些通知可以在用户设备的通知中心或状态栏中显示，以提醒用户有关应用程序的活动、事件或重要信息。

移动应用中的通知可以分为两种类型：本地通知和远程通知。

本地通知是由应用程序自身发起的通知，不需要连接到远程服务器。应用程序可以根据特定条件或事件触发本地通知，例如定时提醒、任务完成等。本地通知可以直接在设备上显示，即使应用程序未运行，用户也能收到通知。

远程通知是由远程服务器发送给应用程序的通知。应用程序需要与远程服务器建立连接，以接收和处理远程通知。远程通知可以用于各种目的，如推送新闻、推广促销活动、提醒用户更新等。

无论是本地通知还是远程通知，移动应用中的通知通常都具有以下特点：

  1. 可定制性：应用程序可以自定义通知的内容、标题、图标等，以便向用户提供个性化的体验。

  2. 交互性：通知可以包含操作按钮或链接，用户可以通过点击通知来执行特定的操作，如打开应用、查看详情等。

  3. 静默通知：某些通知可以以静默模式发送，即用户不会收到任何视觉或声音提示，但应用程序仍可以在后台处理通知。

  4. 优先级控制：应用程序可以为通知设置优先级，以便在设备上显示不同的通知样式或触发不同的提示音。

🚀一、通知

🔎1.通知概述

🦋1.1 通知简介

HarmonyOS应用可以通过通知接口发送通知消息。开发者可以使用该接口发送各种类型的通知，包括普通通知、长文字通知、大图通知等。终端用户可以通过通知栏查看通知内容，并进行相应操作，比如点击通知来打开应用。

通过通知接口，开发者可以设置通知的标题、内容、图标、优先级等属性。可以通过设置点击通知后的跳转动作，实现点击通知打开应用的功能。此外，开发者还可以通过设置通知的声音、震动等效果，提升用户体验。

通知常见的使用场景：

  • 提醒用户有待办事项，如闹钟、日历事件等。

  • 通知用户设备的状态，如电量低、网络连接状态等。

  • 提醒用户有新的邮件、社交媒体消息等。

  • 显示其他应用的提醒、通知，如电话、音乐播放器、定时器等。

  • 显示系统级别的通知，如系统更新、权限请求等。

  • 提醒用户有新的软件更新、安全补丁等。

  • 通知用户有新的活动、促销等。

  • 提醒用户有新的天气预报、股票行情等。

  • 显示其他应用的报警、警报等紧急通知。

HarmonyOS通过Advanced Notification Service（ANS）为应用程序提供通知管理服务。ANS支持多种通知类型，包括基础类型通知和进度条类型通知。

基础类型通知是一种简单的通知样式，用于显示重要的文本信息或简短的通知内容。它可以包含标题、内容和图标，用户可以通过点击通知来执行相关操作。

进度条类型通知用于显示任务进度或下载进度等信息。它除了包含基础类型通知的内容外，还可以添加一个进度条，以便用户了解任务的进度情况。

🦋1.2 通知业务流程

通知子系统是一个中间件，负责接收来自通知发送端的通知消息，并将这些消息分发给订阅端。它起到了消息调度和分发的作用，实现了发布-订阅模式。

通知发送端是产生通知消息的组件，可以是应用程序、系统模块等。它负责生成通知消息，并通过IPC通信机制将消息发送到通知子系统。

通知订阅端是接收通知消息的组件，可以是应用程序、监控工具等。它通过订阅通知子系统，接收特定类型的通知消息。

整个通知业务流程如下：

  1. 通知发送端生成一条通知消息，包括通知的类型、内容等。
  2. 通知发送端通过IPC通信机制将通知消息发送到通知子系统。
  3. 通知子系统接收到通知消息后，根据消息的类型和订阅端的订阅情况，将消息分发给相应的订阅端。
  4. 订阅端接收到通知消息后，进行相应的处理，比如展示通知内容、触发某些操作等。

通过通知子系统的中间件架构，可以实现高效的通知消息分发。通知发送端和订阅端之间解耦，可以独立开发和部署，提高了系统的可扩展性和可维护性。同时，通过订阅机制，订阅端可以选择性地接收感兴趣的通知消息，提高了系统的灵活性。

🔎2.发布通知

🦋2.1 发布基础类型通知

基础类型通知可以用来发送各种类型的通知，包括短信息、提示信息和广告推送等。它们可以包含普通文本、长文本、多行文本和图片等。

例如，你可以发送一条包含简短文字的通知来提醒用户某个事件即将发生，或者发送一条包含长文本的通知来提供详细的信息。此外，你还可以发送一条包含多行文本的通知，每行显示一条信息。如果需要显示图片，你可以发送一条包含图片的通知。基础类型通知非常灵活，可以根据具体需求来进行设置。

☀️2.1.1 接口说明
☀️2.1.2 开发步骤

在HarmonyOS中，NotificationRequest类是用于创建通知的一个重要类。通过NotificationRequest类，可以设置通知的各种属性，如标题、内容、图标、声音、震动等。

🌈2.1.2.1 普通文本类型
import NotificationManager from '@ohos.notificationManager';
let notificationRequest = {
  id: 1,
  content: {
    contentType: NotificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT, // 普通文本类型通知
    normal: {
      title: 'test_title',
      text: 'test_text',
      additionalText: 'test_additionalText',
    }
  }
}

@Entry
@Component
struct Index {
  @State message: string = 'Hello World'

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {
            NotificationManager.publish(notificationRequest, (err) => {
              if (err) {
                console.error(`[ANS] failed to publish, error[${err}]`);
                return;
              }
              console.info(`[ANS] publish success`);
            });
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}
🌈2.1.2.2 长文本类型通知
import NotificationManager from '@ohos.notificationManager';
let notificationRequest = {
  id: 1,
  content: {
    contentType: NotificationManager.ContentType.NOTIFICATION_CONTENT_LONG_TEXT, // 长文本类型通知
    longText: {
      title: 'test_title',
      text: 'test_text',
      additionalText: 'test_additionalText',
      longText: 'test_longText',
      briefText: 'test_briefText',
      expandedTitle: 'test_expandedTitle',
    }
  }
}
// 发布通知
NotificationManager.publish(notificationRequest, (err) => {
  if (err) {
    console.error(`[ANS] failed to publish, error[${err}]`);
    return;
  }
  console.info(`[ANS] publish success`);
});
@Entry
@Component
struct Index {
  @State message: string = 'Hello World'

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {

          })
      }
      .width('100%')
    }
    .height('100%')
  }
}
🌈2.1.2.3 多行文本类型通知
import NotificationManager from '@ohos.notificationManager';
let notificationRequest = {
  id: 1,
  content: {
    contentType: NotificationManager.ContentType.NOTIFICATION_CONTENT_MULTILINE, // 多行文本类型通知
    multiLine: {
      title: 'test_title',
      text: 'test_text',
      briefText: 'test_briefText',
      longTitle: 'test_longTitle',
      lines: ['line_01', 'line_02', 'line_03', 'line_04'],
    }
  }
}

// 发布通知
NotificationManager.publish(notificationRequest, (err) => {
  if (err) {
    console.error(`[ANS] failed to publish, error[${err}]`);
    return;
  }
  console.info(`[ANS] publish success`);
});
@Entry
@Component
struct Index {
  @State message: string = 'Hello World'

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {

          })
      }
      .width('100%')
    }
    .height('100%')
  }
}
🌈2.1.2.4 图片类型通知
import NotificationManager from '@ohos.notificationManager';
import image from '@ohos.multimedia.image';
// 图片构造
const color = new ArrayBuffer(60000);
let bufferArr = new Uint8Array(color);
for (var i = 0; i<bufferArr.byteLength;i++) {
  bufferArr[i++] = 60;
  bufferArr[i++] = 20;
  bufferArr[i++] = 220;
  bufferArr[i] = 100;
}
let opts = { editable:true, pixelFormat:"ARGB_8888", size: {height:100, width : 150}};

image
  // @ts-ignore
  .createPixelMap(color, opts)
  .then(async (pixelmap) => {
    await pixelmap.getImageInfo().then(imageInfo => {
      console.log("=====size: ====" + JSON.stringify(imageInfo.size));
    }).catch(err => {
      console.error("Failed to obtain the image pixel map information." + JSON.stringify(err));
      return;
    })
    let notificationRequest = {
      id: 1,
      content: {
        contentType: NotificationManager.ContentType.NOTIFICATION_CONTENT_PICTURE,
        picture: {
          title: 'test_title',
          text: 'test_text',
          additionalText: 'test_additionalText',
          picture: pixelmap,
          briefText: 'test_briefText',
          expandedTitle: 'test_expandedTitle',
        }
      },
    }
    // 发送通知
    NotificationManager.publish(notificationRequest, (err) => {
      if (err) {
        console.error(`[ANS] failed to publish, error[${err}]`);
        return;
      }
      console.info(`[ANS] publish success `);
    });
  }).catch(err=>{
    console.error('create pixelmap failed =========='+ JSON.stringify(err));
    return;
  })

@Entry
@Component
struct Index {
  @State message: string = 'Hello World'

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {

          })

      }
      .width('100%')
    }
    .height('100%')
  }
}

🦋2.2 发布进度条类型通知

☀️2.2.1 接口说明
☀️2.2.2 开发步骤
import NotificationManager from '@ohos.notificationManager';
NotificationManager.isSupportTemplate('downloadTemplate').then((data) => {
  console.info(`[ANS] isSupportTemplate success`);
  let isSupportTpl: boolean = data; // isSupportTpl的值为true表示支持支持downloadTemplate模板类通知，false表示不支持
  // ...
}).catch((err) => {
  console.error(`[ANS] isSupportTemplate failed, error[${err}]`);
});

let template = {
  name:'downloadTemplate',
  data: {
    title: '标题：',
    fileName: 'music.mp4',
    progressValue: 30,
    progressMaxValue:100,
  }
}
//构造NotificationRequest对象
let notificationRquest = {
  id: 1,
  slotType: NotificationManager.SlotType.OTHER_TYPES,
  template: template,
  content: {
    contentType: NotificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
    normal: {
      title: template.data.title + template.data.fileName,
      text: "sendTemplate",
      additionalText: "30%"
    }
  },
  deliveryTime: new Date().getTime(),
  showDeliveryTime: true
}
NotificationManager.publish(notificationRquest).then(() => {
  console.info(`[ANS] publish success `);
}).catch((err) => {
  console.error(`[ANS] failed to publish, error[${err}]`);
});

@Entry
@Component
struct Index {
  @State message: string = 'Hello World'

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {

          })

      }
      .width('100%')
    }
    .height('100%')
  }
}

🦋2.3 为通知添加行为意图

WantAgent是HarmonyOS提供的一种功能，它允许开发者封装行为意图。行为意图主要用于拉起指定的应用组件或发布公共事件等。在HarmonyOS中，我们可以通过通知的方式将WantAgent从发布方传递给接收方，从而在接收方触发WantAgent中指定的意图。

举个例子，假设有一个应用发布一个通知消息，通常希望用户能够通过点击通知栏来打开目标应用组件。为了实现这个目标，开发者可以将WantAgent封装到通知消息中。当系统接收到带有WantAgent的通知消息时，用户点击通知栏时会触发WantAgent中指定的意图，从而打开目标应用组件。

为了实现通知中的行为意图，应用需要向应用组件管理服务（AMS）申请WantAgent，并将其与其他通知信息一起发送给桌面。当用户在桌面通知栏上点击通知时，系统会触发WantAgent的动作，从而实现目标应用组件的打开。

☀️2.3.1 接口说明
☀️2.3.2 开发步骤
import NotificationManager from '@ohos.notificationManager';
import wantAgent from '@ohos.app.ability.wantAgent';

let wantAgentObj = null; // 用于保存创建成功的wantAgent对象，后续使用其完成触发的动作。

// 通过WantAgentInfo的operationType设置动作类型。
let wantAgentInfo = {
  wants: [
    {
      deviceId: '',
      bundleName: 'com.example.test',
      abilityName: 'com.example.test.MainAbility',
      action: '',
      entities: [],
      uri: '',
      parameters: {}
    }
  ],
  operationType: wantAgent.OperationType.START_ABILITY,
  requestCode: 0,
  wantAgentFlags:[wantAgent.WantAgentFlags.CONSTANT_FLAG]
}

// // wantAgentInfo
// let wantAgentInfo = {
//   wants: [
//     {
//       action: 'event_name', // 设置事件名。
//       parameters: {},
//     }
//   ],
//   operationType: wantAgent.OperationType.SEND_COMMON_EVENT,
//   requestCode: 0,
//   wantAgentFlags: [wantAgent.WantAgentFlags.CONSTANT_FLAG],
// }

// 创建WantAgent
wantAgent.getWantAgent(wantAgentInfo, (err, data) => {
  if (err) {
    console.error('[WantAgent]getWantAgent err=' + JSON.stringify(err));
  } else {
    console.info('[WantAgent]getWantAgent success');
    wantAgentObj = data;
  }
});
// 构造NotificationRequest对象
let notificationRequest = {
  content: {
    contentType: NotificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
    normal: {
      title: 'Test_Title',
      text: 'Test_Text',
      additionalText: 'Test_AdditionalText',
    },
  },
  id: 1,
  label: 'TEST',
  //wantAgent: wantAgentObj,//好像报错
}
// 通知发送
NotificationManager.publish(notificationRequest, (err) => {
  if (err) {
    console.error(`[ANS] failed to publish, error[${err}]`);
    return;
  }
  console.info(`[ANS] publish success `);
});

@Entry
@Component
struct Index {
  @State message: string = 'Hello World'

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
          .onClick(() => {

          })

      }
      .width('100%')
    }
    .height('100%')
  }
}

🚀写在最后

  • 如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
  • 点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
  • 关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
  • 更多鸿蒙最新技术知识点，请关注作者博客：https://t.doruo.cn/14DjR1rEY
相关推荐
️ 邪神3 小时前
【Android、IOS、Flutter、鸿蒙、ReactNative 】自定义View
flutter·ios·鸿蒙·reactnative·anroid
SameX4 小时前
HarmonyOS Next 安全生态构建与展望
前端·harmonyos
SameX4 小时前
HarmonyOS Next 打造智能家居安全系统实战
harmonyos
Random_index12 小时前
#Uniapp篇：支持纯血鸿蒙&发布&适配&UIUI
uni-app·harmonyos
鸿蒙自习室15 小时前
鸿蒙多线程开发——线程间数据通信对象02
ui·harmonyos·鸿蒙
SuperHeroWu718 小时前
【HarmonyOS】鸿蒙应用接入微博分享
华为·harmonyos·鸿蒙·微博·微博分享·微博sdk集成·sdk集成
zhangjr057520 小时前
【HarmonyOS Next】鸿蒙实用装饰器一览(一)
前端·harmonyos·arkts
诗歌难吟4641 天前
初识ArkUI
harmonyos
SameX1 天前
HarmonyOS Next 设备安全特性深度剖析学习
harmonyos
郭梧悠1 天前
HarmonyOS(57) UI性能优化
ui·性能优化·harmonyos
热门推荐
01(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明02PyTorch机器学习实现液态神经网络03【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总04玄机平台应急响应—webshell查杀05Coze扣子平台完整体验和实践（附国内和国际版对比）06Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO07【目标跟踪】相机运动补偿08Unity中PICO实现 隔空取物 和 接触抓取物体09RAG 实践- Ollama+RagFlow 部署本地知识库10怎样让音频速度变慢？请跟随以下方法进行操作