华为推送服务(Push)

您所在的位置：网站首页 › 华为如何关闭推送通知提醒 › 华为推送服务(Push)

华为推送服务(Push)

2023-10-11 00:42| 来源: 网络整理| 查看: 265

Huawei PUSH（华为推送服务）是华为为开发者提供的消息推送平台

1. 是什么华为推送服务？

云端到终端的消息推送通道。PUSH通道拥有高到达率，推送速度每秒最高可达百万级，消息量每日百亿级，并且支持实时消息回执(实时反馈收发状态)。

2. 华为推送功能

2.1 终端设备收到消息的形式有？

Huawei PUSH可发送两种类型的消息给终端：通知栏消息和透传消息

2.2 PUSH主要功能

支持单发、群发机制，可以一次给一个或者多个用户发送PUSH消息当终端用户不在线时，支持消息缓存能力(消息缓存是指设备不在线华为PUSH平台会将消息缓存起来，等到设备上线后再次推送给用户。如果用户很长时间不在线，这些缓存的消息默认保存24小时，最大保存15天，超期的消息会被PUSH平台丢弃)支持实时消息回执支持通知栏消息和透传消息两种方式。华为推荐用户尽量使用通知栏消息

2.3 通知栏或透传消息区别？

终端用户点击对应的通知栏消息触发相应的动作，如打开应用、打开一个网页、打开应用内某界面透传消息由开发者的APP自主解析自定义内容，并触发相关动作，华为PUSH仅仅提供通道能力。利用此功能开发者可以实现好友邀请、IP呼叫等功能

2.4 华为推荐用户尽量使用通知栏消息的原因？

通知栏消息的优势如下

降低PUSH业务的功耗传统的Push功能都需要应用的进程存在时才能显示通知栏消息，但是应用进程很难常驻在系统，一般系统出于功耗的考虑会停止后台长时间没有活动的进程，这种情况下当收到通知栏消息需要展示时就需要拉起应用进程，频繁的操作会增加耗电影响手机续航能力通知栏消息到达率通常比透传消息高（不受低功耗方案对广播拉起应用的限制）

2.5 消息送达率如何？

影响PUSH消息送达率的因素有

终端设备是否在线用户手机上集成HMS SDK的应用是否被卸载移动网络是否稳定终端手机的安全控制策略不同终端厂商设备的支持度

2.6 不同终端平台对PUSH消息的限制?

原则上安装了HMS APK（华为移动服务）的Android终端设备即可支持华为PUSH业务

华为Android终端设备（设备出厂自带HMS APK） Tips：华为手机管家可以拦截Android广播消息，Push消息因此也会被拦截

非华为Android手机（小米、VIVO、OPPO、三星、酷派、中兴等） Tips：需要终端设备先安装HMS APK。某些厂商手机可能会删除华为进程，导致消息不可达

2.7 PUSH消息大小限制

PUSH消息支持的Android APP包名称最大为128个字节，消息内容最大限制为4K（不包括Token）

2.8 PUSH消息流控限制

目前华为PUSH服务会对如下两个场景进行流控

服务端申请Access Token 开发者应用服务器短时间内频繁申请Access Token会被网关流控，返回error=6错误码

服务端发送PUSH消息api.push.hicloud.com 开发者应用服务器短时间内发送大量的推送消息会被流控，返回HTTP 503状态码

2.9 华为PUSH开放API认证方式

目前华为PUSH的开放API存在两种鉴权模式

用户级鉴权模式开发者使用开发者帐号登录华为开发者联盟后，使用PUSH控制台进行通知消息发送时采用用户级鉴权模式 Tips：PUSH控制台是华为为开发者提供的PUSH消息发送测试平台，可以在线编辑并发送PUSH消息用于测试应用是否正确集成Push服务

应用级鉴权模式开发者在应用服务器调用开放API发送的通知消息采用的是基于应用的鉴权模式，在使用前必须获取对应级别的Access Token才能进行正常的消息下发

2.10 自定义通知渠道

通知渠道（channel）是Android O版本引入的新功能，意在解决如下问题：

应用的通知越来越多，给用户造成明显打扰。华为手机系统EMUI 10.0之前仅有一个“默认通知”渠道，无法做通知消息呈现方式的定制。

华为手机系统从EMUI 10.0开始新增了三个通知渠道（服务提醒，普通通知与营销通知）来实现不同级别（重要与一般）的通知消息展示。

3. 华为Push集成注册认证成为开发者创建产品和应用开通推送服务获取推送服务参数下载SDK推送配置等集成工程

详情可参考：点我查看

接下来梳理集成步骤

在开发应用前，需要在AppGallery Connect中配置相关信息

注册成为开发者(开通Push服务)

推送配置等，例如：集成HMS Core SDK 将agconnect-services.json文件拷贝到应用级根目录下

配置HMS Core SDK的Maven仓地址打开Android Studio项目级“build.gradle”文件

buildscript { repositories { google() jcenter() // 配置HMS Core SDK的Maven仓地址。 maven {url 'https://developer.huawei.com/repo/'} } dependencies { ... // 增加agcp配置。 classpath 'com.huawei.agconnect:agcp:1.4.1.300' } } allprojects { repositories { google() jcenter() // 配置HMS Core SDK的Maven仓地址。 maven {url 'https://developer.huawei.com/repo/'} } }

备注：Maven仓地址无法直接在浏览器中打开访问，只能在IDE中配置。如需添加多个Maven代码库，请将华为公司的Maven仓地址配置在最后

添加编译依赖，打开子工程app下的build.gradle文件 dependencies { // {version} 替换为实际的版本号 // 如：api 'com.huawei.hms:push:5.0.4.302' api 'com.huawei.hms:push:{version}' }

在文件头apply plugin: 'com.android.application’下一行添加如下配置

apply plugin: 'com.huawei.agconnect' 在manifest节点下增加所需权限 =26，请务必添加以下权限 --> PACKAGE_NAME} 要替换上您应用的包名 --> 在application节点下声明2个receiver和1个service，用于接收广播信息用来接收PUSH消息的receiver： *;} -keep class com.huawei.updatesdk.**{*;} -keep class com.huawei.hms.**{*;} -keep class com.huawei.android.hms.agent.**{*;} 5. 客户端开发

主要实现：获取设备的PUSH Token，获取Token后，开发者可以在联盟PUSH控制台或者开发者自己服务器向这些Token发送推送消息

5.1 申请Push Token

通过Push SDK的自动初始化能力来自动获取Token

HmsMessaging.getInstance(mContext).setAutoInitEnabled(true);

通过HmsMessageService类中的onNewToken方法获取Token值

@Override public void onNewToken(String token) { // 获取token Log.i(TAG, "received refresh token:" + token); // 判断token是否为空 if (!TextUtils.isEmpty(token)) { refreshedTokenToServer(token); } } // 将获取Token传给APP服务器端 private void refreshedTokenToServer(String token) { Log.i(TAG, "sending token to server. token:" + token); }

5.2 设置是否显示通知栏消息

通知栏消息是由系统直接在通知中心下拉列表呈现的即时消息。您如果想控制应用是否允许显示通知栏消息，可以调用HmsMessaging类中的turnOnPush或者HmsMessaging类中的turnOffPush方法

/** * 2.设置是否显示通知栏消息 * * @param enable */ public void setReceiveNotifyMsg(final boolean enable) { if (enable) { HmsMessaging.getInstance(mContext).turnOnPush() .addOnCompleteListener(new OnCompleteListener() { @Override public void onComplete(Task task) { if (task.isSuccessful()) { CLog.i(TAG, "turnOnPush Complete"); } else { CLog.i(TAG, "turnOnPush failed: cause=" + task.getException().getMessage()); } } }); } else { HmsMessaging.getInstance(mContext).turnOffPush() .addOnCompleteListener(new OnCompleteListener() { @Override public void onComplete(Task task) { if (task.isSuccessful()) { CLog.i(TAG, "turnOffPush Complete"); } else { CLog.i(TAG, "turnOffPush failed: cause =" + task.getException().getMessage()); } } }); } }

5.3 自定义点击消息的动作

5.4 展示应用角标这个具体参看：点我查看

5.5 客户端测试

开发者可以参考PUSH控制台发送测试消息来测试PUSH消息能否正确送达客户端。如需实现服务端自定义发送Push消息

开发者通过在APP服务器端调用PUSH接口，向Huawei PUSH平台发送推送消息 Huawei PUSH平台将消息发给安装了相应APP的终端设备

5.6 从2023年9月15日开始，华为推送服务将对本地通知进行灰度管控，主要包括对应用发送本地通知进行分类管理，以及对资讯营销消息统一进行频次管控。

6. 常见问题

6.1 华为推送服务中提供的透传消息是可能会丢失的.(当APP被杀死后,透传消息有时是收不到的。所以不推荐使用透传去做一些重要的功能)

6.2 从Push SDK4.0版本开始我们提供了自动初始化获取Token的能力

6.3 应用不要固定判断Token长度，因为后续长度可变；应用的Token要定期更新（建议应用每次启动的时候都获取Token，如果发现和上次取到的不同，则上报到自己的服务器）

6.4 推送是否支持非华为手机？ A：支持，非华为手机必须要安装华为移动服务，请到华为应用市场中搜索下载

6.5 通知栏消息系统版本要求 A：支持NC（Notification Center）功能的手机：部分EMUI4.0和4.1的手机，以及EMUI5.0及之后的华为手机。建议最好是5.0系统以及以上

6.6 通知栏消息样式

华为通知样式默认是系统默认样式，通知栏消息的声音、样式和振动等不可以自定义大文本样式：默认样式下仅支持单行文本，大文本样式支持标题单行，内容文字多行（当前EMUI 9系统限制最多显示12行中文或者14行英文，EMUI 10&11系统限制最多显示11行中文或者13行英文）自定义消息小图标

6.7 推送是否支持角标 A：目前不支持通知栏消息和角标的同步，透传消息可以自行实现

6.8 透传消息和通知栏消息的区别 A：透传消息：是华为Push将消息送达手机后不做呈现，直接转给开发者的应用，由应用本身去解析消息和呈现内容通知栏消息：是华为Push将消息送达手机后，会在通知栏显示一条消息，点击后触发指定动作，应用不需要去解析消息和控制呈现，减少了应用的开发工作量

6.9 无法收到推送消息 A：

EMUI版本太低小于4.1.或华为移动服务版本较低检查CP是否使用的是老版本的的push,老版本sdk会出现消息延时很明显的情况，以及收不到推送，需要尽快切换到新版本服务端在推送消息到设备时，是否Token失效等，可让服务端配合查发送消息的返回状态码，详情点我查看

6.10 接收不到消息，抓取相关日志

Adb连上手机分别执行下面命令 adb shell setprop log.tag.hwpush VERBOSE adb logcat –v time > /Users/aaron/Desktop/huawei/hwpush.log 7. 参考 Android集成华为推送踩坑问题总结Android华为推送自定义动作的实现Android集成华为推送踩坑问题总结消息推送（华为）华为推送SDK【重要】Huawei Push 的Token生成规则变化公告自定义通知渠道华为消息分类调整通知：自分类权益消息申请消息分类标准集成HMS Core SDK获取和注销Token获取消息数据(包括处理通知消息和透传消息)

【本文地址】

华为推送服务(Push)

华为推送服务(Push)

今日新闻

推荐新闻