App之百度云推送

2022-02-16 14:13:24

集成SDK

下载最新的Android SDK压缩包并解压，在新建工程或已有工程中增加百度云推送功能。

我下载的是

，里面有一个同名的文件夹，文件夹中有

导入云推送jar包和so文件：

将解压后的libs文件夹中所有文件拷贝到您的工程的libs文件夹中。如果您的工程中没有其他的.so文件，建议只拷贝armeabi文件夹。如果您的工程中还使用了其他的.so文件，只需要拷贝对应目录下的.so文件即可。如果你使用的Android开发环境是Android Stutio，在工程中“src/main”目录中新建名为jniLibs的目录，将libs文件夹中文件拷贝到“jniLibs”目录内。

将解压后的libs中的文件拷贝到工程libs中对应的目录中，没有目录的话，直接拷贝目录。

其中用红线框住的是从SDK压缩包中拷贝到工程中的，其他的文件或目录都是工程原有的。

配置AndroidManifest文件：

在当前工程的AndroidManifest.xml文件中，添加权限和声明信息：

 <!-- Push service 运行需要的权限 -->

 <uses-permission android:name="android.permission.INTERNET" />

 <uses-permission android:name="android.permission.READ_PHONE_STATE" />

 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

 <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

 <uses-permission android:name="android.permission.WRITE_SETTINGS" />

 <uses-permission android:name="android.permission.VIBRATE" />

 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

 <uses-permission android:name="android.permission.ACCESS_DOWNLOAD_MANAGER"/>

 <uses-permission android:name="android.permission.DOWNLOAD_WITHOUT_NOTIFICATION" />

 <uses-permission android:name="android.permission.DISABLE_KEYGUARD" />

 <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

 <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

 <uses-permission android:name="android.permission.EXPAND_STATUS_BAR" />

 <!-- !!!!!下面的标签要放在application标签内!!!!! -->

 <!-- 4.6版本新增的Activity声明，提升Push后台存活率 -->

 <activity

     android:name="com.baidu.android.pushservice.PushKeepAlive"

     android:theme="@android:style/Theme.Translucent.NoTitleBar"/>

 <!-- push service start -->

 <!-- 用于接收系统消息以保证PushService正常运行 -->

 <receiver android:name="com.baidu.android.pushservice.PushServiceReceiver"

     android:process=":bdservice_v1" >

     <intent-filter>

         <action android:name="android.intent.action.BOOT_COMPLETED" />

         <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />

         <action android:name="com.baidu.android.pushservice.action.notification.SHOW" />

         <action android:name="com.baidu.android.pushservice.action.media.CLICK" />

         <!-- 以下四项为可选的action声明，可大大提高service存活率和消息到达速度 -->

         <action android:name="android.intent.action.MEDIA_MOUNTED" />

         <action android:name="android.intent.action.USER_PRESENT" />

         <action android:name="android.intent.action.ACTION_POWER_CONNECTED" />

         <action android:name="android.intent.action.ACTION_POWER_DISCONNECTED" />

     </intent-filter>

 </receiver>

 <!-- Push服务接收客户端发送的各种请求-->

 <receiver android:name="com.baidu.android.pushservice.RegistrationReceiver"

     android:process=":bdservice_v1" >

     <intent-filter>

         <action android:name="com.baidu.android.pushservice.action.METHOD" />

         <action android:name="com.baidu.android.pushservice.action.BIND_SYNC" />

     </intent-filter>

     <intent-filter>

         <action android:name="android.intent.action.PACKAGE_REMOVED" />

         <data android:scheme="package" />

     </intent-filter>

 </receiver>

 <service android:name="com.baidu.android.pushservice.PushService" android:exported="true"

     android:process=":bdservice_v1" >

     <intent-filter >

             <action android:name="com.baidu.android.pushservice.action.PUSH_SERVICE" />

     </intent-filter>

 </service>

 <!-- 4.4版本新增的CommandService声明，提升小米和魅族手机上的实际推送到达率 -->

 <service android:name="com.baidu.android.pushservice.CommandService"

     android:exported="true" />

 <!-- push结束 -->

启动云推送

在当前工程的主Activity的onCreate函数中，添加以下代码：

PushManager.startWork(getApplicationContext(),PushConstants.LOGIN_TYPE_API_KEY,"api_key")

其中的“API Key“需要手动修改为指定应用的API Key。

自定义回调类

在当前工程中新建一个PushTestReceiver类（类名可以是其他任意），该类要继承PushMessageReceiver，并重载所有的回调函数：

代码如下:

在当前工程的AndroidManifest.xml文件中，添加自定义Receiver信息如下：

<!-- 此处Receiver名字修改为当前包名路径 -->

<receiver android:name="com.*.*.PushTestReceiver">

    <intent-filter>

        <!-- 接收push消息 -->

        <action android:name="com.baidu.android.pushservice.action.MESSAGE" />

        <!-- 接收bind、setTags等method的返回结果-->

        <action android:name="com.baidu.android.pushservice.action.RECEIVE" />

        <!-- 接收通知点击事件，和通知自定义内容 -->

        <action android:name="com.baidu.android.pushservice.action.notification.CLICK" />

    </intent-filter>

</receiver>

运行App

右键点击当前工程，选择Run As --> Android Application，选中已连接的设备或Android虚拟机，运行该程序。如果在logcat中的回调函数中的errorCode为0，说明已经绑定成功，并返回userid和channelid，我们就可以在云控制台推送通知和透传消息到该app了。

！！！以上仅仅是做好了接收端（客户端）的接受配置，表示可以接收百度云推送的消息了，下面要进行真正的消息推送了。

推送消息

在集成SDK后，可以通过以下两种方式推送消息。

通过控制台推送消息：

1、在百度云推送控制台 http://push.baidu.com/console/app 中创建应用，并进行应用配置

2、进入应用管理，API KEY等都是从里面找到的。

3、推送列表

4、点击重发。（注意：推送成功并不表示手机就收到了消息通知，只有到达数+1时，才表示有手机收到了该通知）

通过服务端SDK推送消息（目前服务端提供 java和php 两种语言的SDK，以下是java代码）：

　　在百度云推送上下载java服务端的SDK http://push.baidu.com/sdk/push_server_sdk_for_java

下面是AndoridPushMsgToAll.java的代码，仅供参考，具体的解释请看官方文档http://push.baidu.com/doc/java/api，写的很好。

 package com.baidu.yun.push.sample;

 import com.baidu.yun.core.log.YunLogEvent;

 import com.baidu.yun.core.log.YunLogHandler;

 import com.baidu.yun.push.auth.PushKeyPair;

 import com.baidu.yun.push.client.BaiduPushClient;

 import com.baidu.yun.push.constants.BaiduPushConstants;

 import com.baidu.yun.push.exception.PushClientException;

 import com.baidu.yun.push.exception.PushServerException;

 import com.baidu.yun.push.model.PushMsgToAllRequest;

 import com.baidu.yun.push.model.PushMsgToAllResponse;

 public class AndroidPushMsgToAll {

     public static void main(String[] args)

             throws PushClientException,PushServerException {

         /* 1. 创建PushKeyPair

          *     用于app的合法身份认证

          *     apikey和secretKey可在应用详情中获取

          */

         String apiKey = "MmPl80nW1RbeCAOT4rcNBGTu";

         String secretKey = "QTWsFfuqFlL0RHfvP6tXoV4AndhF49W2";

         PushKeyPair pair = new PushKeyPair(apiKey, secretKey);

         // 2. 创建BaiduPushClient，访问SDK接口

         BaiduPushClient pushClient = new BaiduPushClient(pair,

                 BaiduPushConstants.CHANNEL_REST_URL);

         // 3. 注册YunLogHandler，获取本次请求的交互信息

         pushClient.setChannelLogHandler(new YunLogHandler() {

             @Override

             public void onHandle(YunLogEvent event) {

                 System.out.println(event.getMessage());

             }

         });

         try {

             // 4. 设置请求参数，创建请求实例

             PushMsgToAllRequest request = new PushMsgToAllRequest()

                     .addMsgExpires(new Integer(3600))//设置消息的有效时间,单位秒,默认3600*5.

                     .addMessageType(1)    //设置消息类型,0表示透传消息,1表示通知,默认为0.

                     .addMessage("{\"title\":\"TEST\",\"description\":\"Hello Baidu push!!---!\"}") //添加透传消息

                     .addSendTime(System.currentTimeMillis() / 1000 + 120) // 设置定时推送时间，必需超过当前时间一分钟，单位秒.实例2分钟后推送

                     .addDeviceType(3); //设置设备类型，deviceType => 1 for web, 2 for pc, 3 for android, 4 for ios, 5 for wp.

             // 5. 执行Http请求

             PushMsgToAllResponse response = pushClient.pushMsgToAll(request);

             // 6. Http请求返回值解析

             System.out.println("msgId: " + response.getMsgId() + ",sendTime: "

                     + response.getSendTime() + ",timerId: "

                     + response.getTimerId());

         } catch (PushClientException e) {

             //ERROROPTTYPE 用于设置异常的处理方式 -- 抛出异常和捕获异常,

             //'true' 表示抛出, 'false' 表示捕获。

             if (BaiduPushConstants.ERROROPTTYPE) {

                 throw e;

             } else {

                 e.printStackTrace();

             }

         } catch (PushServerException e) {

             if (BaiduPushConstants.ERROROPTTYPE) {

                 throw e;

             } else {

                 System.out.println(String.format(

                         "requestId: %d, errorCode: %d, errorMessage: %s",

                         e.getRequestId(), e.getErrorCode(), e.getErrorMsg()));

             }

         }

     }

 }

其它语言可以通过包装RestAPI使用云推送服务，详情见http://push.baidu.com/doc/restapi/restapi

手机接收通知消息

当设备接收到通知消息后，查看手机的通知栏，可以看到通知栏内的新通知展示。如图：

通知到达时，当通知被用户点击时，会回调onNotificationClicked函数。

注意：百度云推送的频率有限制，限制策略为：单播默认：5000qps，组播默认：100qps，1000qpm，5000qph，广播默认：每4秒只能推送2次

小米手机可能会出现失败的情况，建议重启一下手机。

码农公寓