小米推送服务集成
前言
丰富厂商渠道推送,下图为小米手机,应用销毁进程之后收到推送消息,点击消息打开引用的Gif图。
如果这是你想要的,那么就可以往后面看了。
我的小米手机型号是MI 8 ,MIUI版本 12.0.4,Android版本 10.0。
正文
有时间的时候我习惯写一下文章放松自己,下面进入主题,首先进入小米开放平台。
注册小米的开发者账号,然后登陆账号,完成企业开发者认证之后。开始今天的小米推送服务集成,前期准备:Android Studio,小米手机、小米的开发者账号。
一、创建平台应用
进入小米推送运营平台
点击创建应用。
这里需要一个包名,因此我们需要在AS创建一个项目,命名为XMPushDemo,如下图所示:
点击Finish,完成项目创建,然后复制包名到创建平台应用这里。
点击创建按钮,完成平台应用创建。
勾选上,然后启用消息推送服务。
消息推送启用成功。
这里的AppID和AppKey在代码中需要配置的,记录一下。
二、下载SDK
点击推送SDK下载
点击下载到电脑本地,然后解压。找到SDK中的jar文件
复制到你的项目的libs下
此时这个jar是没有展开的。打开你的app下的build.gradle,查看有没有这行代码,
implementation fileTree(dir: 'libs', include: ['*.jar']) 1
没有就加上,然后Sync Now。
有的话就点击这个小象图标。
然后你的jar就是可展开的了,这说明你的SDK导入成功。
三、项目配置
打开AndroidManifest.xml,进行权限配置,如下所示:
<uses-sdk android:minSdkVersion="9"/> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <uses-permission android:name="android.permission.VIBRATE"/> <permission android:name="com.llw.xmpushdemo.permission.MIPUSH_RECEIVE" android:protectionLevel="signature" /> <uses-permission android:name="com.llw.xmpushdemo.permission.MIPUSH_RECEIVE" />
这里要注意使用自己的app的包名。
然后配置service和receiver。
<service android:name="com.xiaomi.push.service.XMPushService" android:enabled="true" android:process=":pushservice" /> <!--注:此service必须在3.0.1版本以后(包括3.0.1版本)加入--> <service android:name="com.xiaomi.push.service.XMJobService" android:enabled="true" android:exported="false" android:permission="android.permission.BIND_JOB_SERVICE" android:process=":pushservice" /> <service android:name="com.xiaomi.mipush.sdk.PushMessageHandler" android:enabled="true" android:exported="true" /> <!--注:此service必须在2.2.5版本以后(包括2.2.5版本)加入--> <service android:name="com.xiaomi.mipush.sdk.MessageHandleService" android:enabled="true" /> <receiver android:name="com.xiaomi.push.service.receivers.NetworkStatusReceiver" android:exported="true"> <intent-filter> <action android:name="android.net.conn.CONNECTIVITY_CHANGE" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter> </receiver> <receiver android:name="com.xiaomi.push.service.receivers.PingReceiver" android:exported="false" android:process=":pushservice"> <intent-filter> <action android:name="com.xiaomi.push.PING_TIMER" /> </intent-filter> </receiver>
注意添加的位置
四、注册推送
首先新建一个MyBroadcastReceiver,集成PushMessageReceiver 。里面的代码如下:
package com.llw.xmpushdemo; import android.content.Context; import android.text.TextUtils; import android.util.Log; import android.widget.Toast; import com.xiaomi.mipush.sdk.ErrorCode; import com.xiaomi.mipush.sdk.MiPushClient; import com.xiaomi.mipush.sdk.MiPushCommandMessage; import com.xiaomi.mipush.sdk.MiPushMessage; import com.xiaomi.mipush.sdk.PushMessageReceiver; import java.util.List; /** * @author llw */ public class MyBroadcastReceiver extends PushMessageReceiver { public static final String TAG = MyBroadcastReceiver.class.getSimpleName(); private String mRegId; private long mResultCode = -1; private String mReason; private String mCommand; private String mMessage; private String mTopic; private String mAlias; private String mUserAccount; private String mStartTime; private String mEndTime; @Override public void onReceivePassThroughMessage(Context context, MiPushMessage message) { mMessage = message.getContent(); if(!TextUtils.isEmpty(message.getTopic())) { mTopic=message.getTopic(); } else if(!TextUtils.isEmpty(message.getAlias())) { mAlias=message.getAlias(); } else if(!TextUtils.isEmpty(message.getUserAccount())) { mUserAccount=message.getUserAccount(); } } @Override public void onNotificationMessageClicked(Context context, MiPushMessage message) { mMessage = message.getContent(); if(!TextUtils.isEmpty(message.getTopic())) { mTopic=message.getTopic(); } else if(!TextUtils.isEmpty(message.getAlias())) { mAlias=message.getAlias(); } else if(!TextUtils.isEmpty(message.getUserAccount())) { mUserAccount=message.getUserAccount(); } } @Override public void onNotificationMessageArrived(Context context, MiPushMessage message) { mMessage = message.getContent(); if(!TextUtils.isEmpty(message.getTopic())) { mTopic=message.getTopic(); } else if(!TextUtils.isEmpty(message.getAlias())) { mAlias=message.getAlias(); } else if(!TextUtils.isEmpty(message.getUserAccount())) { mUserAccount=message.getUserAccount(); } } @Override public void onCommandResult(Context context, MiPushCommandMessage message) { String command = message.getCommand(); List<String> arguments = message.getCommandArguments(); String cmdArg1 = ((arguments != null && arguments.size() > 0) ? arguments.get(0) : null); String cmdArg2 = ((arguments != null && arguments.size() > 1) ? arguments.get(1) : null); if (MiPushClient.COMMAND_REGISTER.equals(command)) { if (message.getResultCode() == ErrorCode.SUCCESS) { mRegId = cmdArg1; Log.d(TAG,"regId:"+mRegId); } } else if (MiPushClient.COMMAND_SET_ALIAS.equals(command)) { if (message.getResultCode() == ErrorCode.SUCCESS) { mAlias = cmdArg1; Log.d(TAG,"alias:"+mRegId); } } else if (MiPushClient.COMMAND_UNSET_ALIAS.equals(command)) { if (message.getResultCode() == ErrorCode.SUCCESS) { mAlias = cmdArg1; } } else if (MiPushClient.COMMAND_SUBSCRIBE_TOPIC.equals(command)) { if (message.getResultCode() == ErrorCode.SUCCESS) { mTopic = cmdArg1; Log.d(TAG,"topic:"+mRegId); } } else if (MiPushClient.COMMAND_UNSUBSCRIBE_TOPIC.equals(command)) { if (message.getResultCode() == ErrorCode.SUCCESS) { mTopic = cmdArg1; } } else if (MiPushClient.COMMAND_SET_ACCEPT_TIME.equals(command)) { if (message.getResultCode() == ErrorCode.SUCCESS) { mStartTime = cmdArg1; mEndTime = cmdArg2; } } } @Override public void onReceiveRegisterResult(Context context, MiPushCommandMessage message) { String command = message.getCommand(); List<String> arguments = message.getCommandArguments(); String cmdArg1 = ((arguments != null && arguments.size() > 0) ? arguments.get(0) : null); String cmdArg2 = ((arguments != null && arguments.size() > 1) ? arguments.get(1) : null); if (MiPushClient.COMMAND_REGISTER.equals(command)) { if (message.getResultCode() == ErrorCode.SUCCESS) { mRegId = cmdArg1; } } } }
注意这个包名。
下面进行推送服务的注册,新建一个MyApplication,继承Applicaton,这里面的AppID和AppKey都是在前面提到过的,记得使用自己的,代码如下:
package com.llw.xmpushdemo; import android.app.Application; import com.xiaomi.mipush.sdk.MiPushClient; public class MyApplication extends Application { public static final String APP_ID = "2882303761519985273"; public static final String APP_KEY = "5431998523273"; @Override public void onCreate() { super.onCreate(); //初始化push推送服务 MiPushClient.registerPush(this, APP_ID, APP_KEY); } }
然后在AndroidManifest.xml中配置一下:
注册push服务,注册成功后会向DemoMessageReceiver发送广播,然后会打印regId。下面运行一下,当你在手机上看到Hello World!的时候,查看一下控制台。
这个就是你这个设备的regId,现在已经注册成功了。
五、创建推送消息
回到平台上,创建推送消息
编辑推送消息
输入regId
然后滑动到最下面点击完成。
确认无误之后点击立即推送,不出意外,你的手机上会收到一条推送消息。
下面再试试应用进程结束之后能不能收到推送消息。
其实挺简单的,上高水长,后会有期。