写点什么

HarmonyOS 学习路之开发篇——公共事件与通知(二)

发布于: 3 小时前
HarmonyOS学习路之开发篇——公共事件与通知(二)

通知

HarmonyOS 提供了应用的通知功能,即在应用外层通过使用应用图标进行一些事件的通知。常见的使用场景:


  • 显示接收到短消息、即时消息等。

  • 显示应用的推送消息,如广告、版本更新等。

  • 显示当前正在进行的事件,如播放音乐、导航、下载等。

接口说明

通知相关基础类包含 NotificationSlot、NotificationRequest 和 NotificationHelper。基础类之间的关系如下所示:


图 1 通知基础类关系图



  • NotificationSlotNotificationSlot 可以对提示音、振动、锁屏显示和重要级别等进行设置。一个应用可以创建一个或多个 NotificationSlot,在发布通知时,通过绑定不同的 NotificationSlot,实现不同用途。


NotificationSlot 的级别目前支持如下几种, 由低到高:


  • LEVEL_NONE: 表示通知不发布。

  • LEVEL_MIN:表示通知可以发布,但是不显示在通知栏,不自动弹出,无提示音;该级别不适用于前台服务的场景。

  • LEVEL_LOW:表示通知可以发布且显示在通知栏,不自动弹出,无提示音。

  • LEVEL_DEFAULT:表示通知发布后可在通知栏显示,不自动弹出,触发提示音。

  • LEVEL_HIGH:表示通知发布后可在通知栏显示,自动弹出,触发提示音。


  • NotificationRequestNotificationRequest 用于设置具体的通知对象,包括设置通知的属性,如:通知的分发时间、小图标、大图标、自动删除等参数,以及设置具体的通知类型,如普通文本、长文本等。


具体的通知类型:目前支持六种类型,包括普通文本 NotificationNormalContent、长文本 NotificationLongTextContent、图片 NotificationPictureContent、多行 NotificationMultiLineContent、社交 NotificationConversationalContent、媒体 NotificationMediaContent。


  • NotificationHelperNotificationHelper 封装了发布、更新、删除通知等静态方法。

效果演示

https://live.csdn.net/v/168000

开发步骤

通知的开发指导分为创建 NotificationSlot、发布通知和取消通知等开发场景。

第一步、初始化 NotificationSlot


public static final String SLOT_ID = "high"; public static final String SLOT_NAME = "Order notification";//-------------------- .... @Overridepublic void onStart(Intent intent) { super.onStart(intent); super.setUIContent(ResourceTable.Layout_main_ability_slice); ... defineNotificationSlot(Const.SLOT_ID, Const.SLOT_NAME, NotificationSlot.LEVEL_HIGH); ... }//---------------------private void defineNotificationSlot(String id, String name, int importance) { // 创建notificationSlot对象 NotificationSlot notificationSlot = new NotificationSlot(id, name, importance); // 设置振动提醒 notificationSlot.setEnableVibration(true); // 设置锁屏模式 notificationSlot.setLockscreenVisibleness(NotificationRequest.VISIBLENESS_TYPE_PUBLIC); Uri uri = Uri.parse(Const.SOUND_URI); notificationSlot.setSound(uri); try { NotificationHelper.addNotificationSlot(notificationSlot); } catch (RemoteException ex) { HiLog.error(LABEL_LOG, "%{public}s", "defineNotificationSlot remoteException."); } }
复制代码

第二步、发布通知

private void publishNotification(String title, String text) {       //构建NotificationRequest对象,应用发布通知前,通过NotificationRequest的setSlotId()方法与NotificationSlot绑定,使该通知在发布后都具备该对象的特征        notificationId = 0x1000001;        NotificationRequest request = new NotificationRequest(notificationId).setSlotId(Const.SLOT_ID)            .setTapDismissed(true);        //调用setContent()设置通知的内容        request.setContent(createNotificationContent(title, text));        IntentAgent intentAgent = createIntentAgent(MainAbility.class.getName(),            IntentAgentConstant.OperationType.START_ABILITY);        request.setIntentAgent(intentAgent);        //调用publishNotification()发布通知        try {            NotificationHelper.publishNotification(request);        } catch (RemoteException ex) {            HiLog.error(LABEL_LOG, "%{public}s", "publishNotification remoteException.");        }    }
复制代码

第三步、取消通知

取消通知分为取消指定单条通知和取消所有通知,应用只能取消自己发布的通知。


  • 调用 cancelNotification()取消指定的单条通知。


private void cancel() {        try {            NotificationHelper.cancelNotification(notificationId);        } catch (RemoteException ex) {            HiLog.error(LABEL_LOG, "%{public}s", "cancel remoteException.");        }    }
复制代码


  • 调用 cancelAllNotifications()取消所有通知


private void cancelAll() {        try {            NotificationHelper.cancelAllNotifications();        } catch (RemoteException ex) {            HiLog.error(LABEL_LOG, "%{public}s", "cancelAll remoteException.");        }    }
复制代码


发布于: 3 小时前阅读数: 3
用户头像

公众号【美男子玩编程】 2020.05.07 加入

精通移动开发、Android开发; 熟练应用java/JavaScript进行HarmonyOS开发; 熟练使用HTML/CSS语言进行网页开发。

评论

发布
暂无评论
HarmonyOS学习路之开发篇——公共事件与通知(二)