全部栏目

首页 操作系统 后端开发 数据库 前端开发 移动端开发
您的当前位置：首页正文

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

2024-10-17 来源：个人技术集锦

?前言

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

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

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

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

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

  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@Componentstruct 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@Componentstruct 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@Componentstruct 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@Componentstruct 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@Componentstruct 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],// }// 创建WantAgentwantAgent.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@Componentstruct Index {  @State message: string = 'Hello World'  build() {    Row() {      Column() {        Text(this.message)          .fontSize(50)          .fontWeight(FontWeight.Bold)          .onClick(() => {          })      }      .width('100%')    }    .height('100%')  }}

?写在最后

  • 如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
  • 点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
  • 关注小编，同时可以期待后续文章ing?，不定期分享原创知识。
  • 更多鸿蒙最新技术知识点，请关注作者博客：

显示全文