• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 自定义通知推送
2
3### 介绍
4
5本示例主要展示了通知过滤回调管理的功能，使用[@ohos.notificationManager](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-notification-kit/js-apis-notificationManager.md)接口，进行通知监听回调，决定应用通知是否发送。
6
7### 效果预览
8
9| 通知过滤关闭                               | 通知过滤开启                              |
10|--------------------------------------|-------------------------------------|
11| ![image](screenshots/filter_off.png) | ![image](screenshots/filter_on.png) |
12
13使用说明
14
151. 在使用本应用时，需安装[自定义通知角标应用](../CustomNotificationBadge)；
162. 在主界面，进行通知过滤的开启及关闭；
173. 开启通知过滤后，可以选择允许通知的类型，去勾选后，相应类型的通知将不会发送出现通知栏；
184. 打开自定义通知角标应用应用，进行通知的发送，查看是否发送成功；
195. 发送通知的应用必须为普通应用才能进行通知过滤，系统应用默认所有通知都能发送。
20
21### 工程目录
22
23```
24entry/src/main/ets/
25|---feature
26|   |---NotificationFilterUtil.ets           // 对外提供通知过滤的接口
27|---entryability
28|---pages
29|   |---Index.ets                            // 首页
30|---util
31|   |---Logger.ets                           // 日志工具
32```
33
34### 具体实现
35
36* 允许通知过滤、指定通知类型过滤的功能接口封装在NotificationFilterUtil，源码参考：[NotificationFilterUtil.ets](entry/src/main/ets/feature/NotificationFilterUtil.ets)
37    * 允许通知过滤：在[Index.ets](entry/src/main/ets/pages/Index.ets)
38      页面中通过Toggle状态改变事件调用setNotificationEnableFilter()接口开启通知监听并设置通知过滤回调管理；
39    * 指定类型通知过滤：在[Index.ets](entry/src/main/ets/pages/Index.ets)
40      页面中，开启通知过滤后，勾选或取消勾选指定通知类型调用接口setContentTypeEnable()接口设置通知类型是否允许发送；
41
42### 相关权限
43[ohos.permission.NOTIFICATION_CONTROLLER](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-system-apps.md#ohospermissionnotification_controller)
44
45[ohos.permission.NOTIFICATION_AGENT_CONTROLLER](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-system-apps.md#ohospermissionnotification_agent_controller)
46
47### 依赖
48
49通知发送依赖于[自定义通知角标应用](../CustomNotificationBadge)，
50进行不同类型通知的发送测试。
51
52### 约束与限制
53
541. 本示例仅支持标准系统上运行，支持设备：RK3568;
552. 本示例仅支持API10版本SDK，SDK版本号(API Version 10 Release),镜像版本号(4.0Release)。
563. 本示例需要使用DevEco Studio 版本号(4.0Release)及以上版本才可编译运行。
574. 本示例涉及系统接口，需要配置系统应用签名，可以参考[特殊权限配置方法](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/hapsigntool-overview.md) ，把配置文件中的“app-feature”字段信息改为“hos_system_app”,"apl"字段修改为“system_core”。
58
59### 下载
60
61如需单独下载本工程，执行如下命令：
62
63```
64git init
65git config core.sparsecheckout true
66echo code/BasicFeature/Notification/CustomNotificationPush/ > .git/info/sparse-checkout
67git remote add origin https://gitee.com/openharmony/applications_app_samples.git
68git pull origin master
69```