小米推送服务客户端-DevStore.doc

?小米推送服务Client端SDK (MiPushServiceSDK for Client) 小米推送服务客户端SDK使用指南 修订历史 2013年7月 草稿 2013年9月10日 修正部分描述不准确的地方，增加对于自定义Application和打开客户端日志的部分。 2013年9月26日 增加推送使用场景的描述，修改了权限部分和推送Service和Receiver的声明，增加alias的和topic的使用场景描述。增加通知栏logo的设置方法。 2013年1月 修改客户端接入方式为广播方式 在集成过程中遇到任何问题，请联系我们：DevPush@ 目录 1. 客户端SDK说明 2. SDK使用说明 2.1. 配置AndroidManifest.xml文件 2.2. 自定义一个BroadcastReceiver类 2.3. 调试日志 2.4. 注册推送服务 2.5. 设置alias和订阅topic 2.6. 定制通知栏通知的图标 2.7. 正式服务器和测试服务器之间的切换 3. API说明 3.1. MiPushClient的接入类 3.2. ErrorCode错误类型 3.3. PushMesssageReceiver广播接收器 3.4. API详细说明 1.?客户端SDK说明 在使用小米推送服务前，开发者需要先登录小米开发者网站 ，注册app，申请AppId, AppKey,AppSecret。其中AppId和AppKey是客户端的身份标识，在客户端SDK初始化时使用；AppSecret是服务器端的身份标识，在使用ServerSDK向客户端发送消息时使用。然后下载最新的SDK压缩包，其中包括了Server SDK、Client SDK、android DEMO。 小米推送服务目前只支持Android客户端。Android的SDK以jar形式提供， 第三方APP只需要添加少量代码即可接入小米推送服务。 推送服务客户端SDK主要功能接口请参考第3节API说明。客户端在注册成功后，会得到服务器颁发的regId，然后可以通过订阅topic、设置alias（参考2.3）来接收推送消息。小米推送目前支持两种消息传递方式：透传方式和通知栏方式。透传消息到达手机端后，SDK会将消息通过广播方式传给AndroidManifest中注册的PushMessageReceiver的子类中；对于通知栏消息，SDK会根据消息中设置的信息弹出通知栏通知，用户点击之后再传给您的PushMessageReceiver的子类。 2.?SDK使用说明 这里介绍如何配置和使用小米推送，您也可以参照SDK中的demo来配置和使用小米推送。 2.1.? 配置AndroidManifest.xml文件 小米推送服务SDK支持的最低安卓版本为2.2。 uses-sdk ?android:minSdkVersion=8/ 推送服务需要的权限列表 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.GET_TASKS / uses-permission android:name=android.permission.VIBRATE/ permission android:name=com.xiaomi.mipushdemo.permission.MIPUSH_RECEIVE android:protectionLevel=signatureOrSystem / !--这里com.xiaomi.mipushdemo改成app的包名-- ? uses-permission android:name=com.xiaomi.mipushdemo.permission.MIPUSH_RECEIVE / !--这里com.xiaomi.mipushdemo改成app的包名-- 推送服务需要配置的service和receiver service android:enabled=true android:process=:pushservice android:name=com.xia