华为推送服务(Push)

华为推送服务官方集成文档：华为推送服务集成步骤注册成为开发者集成HM SDK2.1HMSAgent.init(this);2.2HMSAgent.connect((Activity) context, new ConnectHandler() {@Overridepublic void onConnect(int rst)...

初心一点

18779人浏览 · 2019-06-05 22:56:22

初心一点 · 2019-06-05 22:56:22 发布

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节点下增加所需权限

<!--HMS-SDK引导升级HMS功能，访问OTA服务器需要网络权限-->    
<uses-permission android:name="android.permission.INTERNET" />   
 
<!--HMS-SDK引导升级HMS功能，保存下载的升级包需要SD卡写权限-->    
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />  
  
<!--检测网络状态-->  
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>  

<!--检测wifi状态-->  
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>  

<!--为了获取用户手机的IMEI，用来唯一的标识用户。-->  
<uses-permission android:name="android.permission.READ_PHONE_STATE"/> 

<!--如果是安卓8.0，应用编译配置的targetSdkVersion>=26，请务必添加以下权限 -->
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

<!-- 接收PUSH TOKEN的广播以及PUSH消息需要定义该权限 ${PACKAGE_NAME} 要替换上您应用的包名 -->
<permission android:name="${PACKAGE_NAME}.permission.PROCESS_PUSH_MSG"
	android:protectionLevel="signatureOrSystem"/>

<!--接收PUSH TOKEN的广播以及PUSH消息需要定义该权限 ${PACKAGE_NAME} 要替换上您应用的包名 -->
<uses-permission android:name="${PACKAGE_NAME}.permission.PROCESS_PUSH_MSG" />

在application节点下声明2个receiver和1个service，用于接收广播信息

 用来接收PUSH消息的receiver：

  <!-- 接入HMSSDK PUSH模块需要注册，第三方相关 :接收Push消息（注册、透传消息、通知栏点击事件）广播，此receiver类需要开发者自己创建并继承com.huawei.hms.support.api.push.PushReceiver类，参考示例代码中的类：com.huawei.hmsagent.HuaweiPushRevicer-->

  <!--“xxx”用实际的类名替换, ${PACKAGE_NAME} 要替换上您应用的包名-->
  <receiver android:name="xxx"
         android:permission="${PACKAGE_NAME}.permission.PROCESS_PUSH_MSG">
            <intent-filter>
               <!-- 必须,用于接收token -->
               <action android:name="com.huawei.android.push.intent.REGISTRATION" />
               <!-- 必须, 用于接收透传消息 -->
               <action android:name="com.huawei.android.push.intent.RECEIVE" />
               <!-- 必须, 用于接收通知栏消息点击事件 此事件不需要开发者处理，只需注册就可以-->
               <action android:name="com.huawei.intent.action.PUSH_DELAY_NOTIFY"/>
            </intent-filter>
  </receiver>

配置混淆脚本
开发者编译APK时请不要混淆HMS SDK以及HMS SDK的相关资源文件，避免功能异常
加入排除hms的混淆配置

-ignorewarning
-keepattributes *Annotation*
-keepattributes Exceptions
-keepattributes InnerClasses
-keepattributes Signature
-keepattributes SourceFile,LineNumberTable
-keep class com.hianalytics.android.**{*;}
-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<Void>() {
                        @Override
                        public void onComplete(Task<Void> 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<Void>() {
                        @Override
                        public void onComplete(Task<Void> 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.` 参考

华为云开发者联盟

为开发者提供学习成长、分享交流、生态实践、资源工具等服务，帮助开发者快速成长。

更多推荐

【重磅】华为云盘古大模型5.0，正式发布！

华为云开发者联盟

中图科信携手华为云打造“思瓜LUFFA AI”首次亮相华为开发者大会

华为云开发者联盟

盘古媒体大模型，重塑媒体产业生产力

华为云开发者联盟

所有评论(0)

查看更多评论

初心一点

@zmm911zmm

已为社区贡献2条内容

华为推送服务(Push)

初心一点

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

2. 华为推送功能

3. 华为Push集成

5. 客户端开发

6. 常见问题

7. 参考

所有评论(0)

初心一点

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

`2.` 华为推送功能

`3.` 华为Push集成

`5.` 客户端开发

`6.` 常见问题

`7.` 参考