Android推送百度云推送入門篇

dmw_zgl 2015-03-11

展開全文

轉(zhuǎn)載請標明出處：http://blog.csdn.net/lmj623565791/article/details/27231237

現(xiàn)在app基本都有推送的功能，于是看了下百度云的推送,，官方文檔和Demo都很到位,，記錄下使用過程,，目標是利用百度云推送最為服務器寫個及時通訊的例子~當然了，這是第一篇入門~

1,、第一步就是在百度開發(fā)者服務管理中創(chuàng)建項目,，然后拿到API key , Secret Key ;這個過程就不多說了，上官網(wǎng)直接申請就行,，不復雜,。

2、下載云推送的客戶端SDK,，SDK的壓縮文件中包含一個例子代碼,，一個用戶手冊，和所需的libs和資源等（其實直接看用戶手冊和Demo基本就沒問題了）,。

3,、準備工作結(jié)束，接下來,，我們就直接開始新建項目測試

a,、新建一個項目，然后把SDK中的libs中的jar和so文件夾拷貝到新建的項目中去

b,、將manifest中的application的name設置為：com.baidu.frontia.FrontiaApplication

[java] view plain copy

<application
android:name="com.baidu.frontia.FrontiaApplication"
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >

如果你的項目需要自定義Application,，請參考用戶手冊中的相關配置。

c,、添加權(quán)限

[java] view plain copy

<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.DISABLE_KEYGUARD" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

d,、添加兩個receiver和一個Service(注釋標明了用處)

[java] view plain copy

<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" />
</intent-filter>
</receiver>
<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>

e,、我們需要自己實現(xiàn)一個Receiver，來接收Push消息、接口調(diào)用回調(diào)以及通知點擊事件,。

[java] view plain copy

<receiver android:name="com.example.zhy_baiduyun_tuisong01.receiver.MyPushMessageReceiver" >
<intent-filter>
<action android:name="com.baidu.android.pushservice.action.MESSAGE" />
<action android:name="com.baidu.android.pushservice.action.RECEIVE" />
<action android:name="com.baidu.android.pushservice.action.notification.CLICK" />
</intent-filter>
</receiver>

代碼:

[java] view plain copy

package com.example.zhy_baiduyun_tuisong01.receiver;
import java.util.List;
import org.json.JSONException;
import org.json.JSONObject;
import android.content.Context;
import android.content.Intent;
import android.text.TextUtils;
import android.util.Log;
import com.baidu.frontia.api.FrontiaPushMessageReceiver;
import com.example.zhy_baiduyun_tuisong01.MainActivity;
import com.example.zhy_baiduyun_tuisong01.util.PreUtils;
/**
* Push消息處理receiver,。請編寫您需要的回調(diào)函數(shù)，一般來說： onBind是必須的,，用來處理startWork返回值,；
* onMessage用來接收透傳消息； onSetTags,、onDelTags,、onListTags是tag相關操作的回調(diào)；
* onNotificationClicked在通知被點擊時回調(diào),； onUnbind是stopWork接口的返回值回調(diào)
*
* 返回值中的errorCode,，解釋如下：
* 0 - Success
* 10001 - Network Problem
* 30600 - Internal Server Error
* 30601 - Method Not Allowed
* 30602 - Request Params Not Valid
* 30603 - Authentication Failed
* 30604 - Quota Use Up Payment Required
* 30605 - Data Required Not Found
* 30606 - Request Time Expires Timeout
* 30607 - Channel Token Timeout
* 30608 - Bind Relation Not Found
* 30609 - Bind Number Too Many
*
* 當您遇到以上返回錯誤時，如果解釋不了您的問題,，請用同一請求的返回值requestId和errorCode聯(lián)系我們追查問題,。
*
*/
public class MyPushMessageReceiver extends FrontiaPushMessageReceiver {
/** TAG to Log */
public static final String TAG = MyPushMessageReceiver.class
.getSimpleName();
/**
* 調(diào)用PushManager.startWork后，sdk將對push
* server發(fā)起綁定請求,，這個過程是異步的,。綁定請求的結(jié)果通過onBind返回。如果您需要用單播推送,，需要把這里獲取的channel
* id和user id上傳到應用server中,，再調(diào)用server接口用channel id和user id給單個手機或者用戶推送。
*
* @param context
* BroadcastReceiver的執(zhí)行Context
* @param errorCode
* 綁定接口返回值,，0 - 成功
* @param appid
* 應用id,。errorCode非0時為null
* @param userId
* 應用user id。errorCode非0時為null
* @param channelId
* 應用channel id,。errorCode非0時為null
* @param requestId
* 向服務端發(fā)起的請求id,。在追查問題時有用；
* @return none
*/
@Override
public void onBind(Context context, int errorCode, String appid,
String userId, String channelId, String requestId) {
String responseString = "onBind errorCode=" + errorCode + " appid="
+ appid + " userId=" + userId + " channelId=" + channelId
+ " requestId=" + requestId;
Log.e(TAG, responseString);
// 綁定成功,，設置已綁定flag,，可以有效的減少不必要的綁定請求
if (errorCode == 0) {
PreUtils.bind(context);
}
// Demo更新界面展示代碼，應用請在這里加入自己的處理邏輯
updateContent(context, responseString);
}
/**
* 接收透傳消息的函數(shù),。
*
* @param context
* 上下文
* @param message
* 推送的消息
* @param customContentString
* 自定義內(nèi)容,為空或者json字符串
*/
@Override
public void onMessage(Context context, String message,
String customContentString) {
String messageString = "透傳消息 message=\"" + message
+ "\" customContentString=" + customContentString;
Log.e(TAG, messageString);
// 自定義內(nèi)容獲取方式,，mykey和myvalue對應透傳消息推送時自定義內(nèi)容中設置的鍵和值
if (!TextUtils.isEmpty(customContentString)) {
JSONObject customJson = null;
try {
customJson = new JSONObject(customContentString);
String myvalue = null;
if (customJson.isNull("mykey")) {
myvalue = customJson.getString("mykey");
}
} catch (JSONException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
// Demo更新界面展示代碼，應用請在這里加入自己的處理邏輯
updateContent(context, messageString);
}
/**
* 接收通知點擊的函數(shù),。注：推送通知被用戶點擊前，應用無法通過接口獲取通知的內(nèi)容。
*
* @param context
* 上下文
* @param title
* 推送的通知的標題
* @param description
* 推送的通知的描述
* @param customContentString
* 自定義內(nèi)容,，為空或者json字符串
*/
@Override
public void onNotificationClicked(Context context, String title,
String description, String customContentString) {
String notifyString = "通知點擊 title=\"" + title + "\" description=\""
+ description + "\" customContent=" + customContentString;
Log.e(TAG, notifyString);
// 自定義內(nèi)容獲取方式,，mykey和myvalue對應通知推送時自定義內(nèi)容中設置的鍵和值
if (!TextUtils.isEmpty(customContentString)) {
JSONObject customJson = null;
try {
customJson = new JSONObject(customContentString);
String myvalue = null;
if (customJson.isNull("mykey")) {
myvalue = customJson.getString("mykey");
}
} catch (JSONException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
// Demo更新界面展示代碼，應用請在這里加入自己的處理邏輯
updateContent(context, notifyString);
}
/**
* setTags() 的回調(diào)函數(shù),。
*
* @param context
* 上下文
* @param errorCode
* 錯誤碼,。0表示某些tag已經(jīng)設置成功；非0表示所有tag的設置均失敗,。
* @param successTags
* 設置成功的tag
* @param failTags
* 設置失敗的tag
* @param requestId
* 分配給對云推送的請求的id
*/
@Override
public void onSetTags(Context context, int errorCode,
List<String> sucessTags, List<String> failTags, String requestId) {
String responseString = "onSetTags errorCode=" + errorCode
+ " sucessTags=" + sucessTags + " failTags=" + failTags
+ " requestId=" + requestId;
Log.e(TAG, responseString);
// Demo更新界面展示代碼,，應用請在這里加入自己的處理邏輯
updateContent(context, responseString);
}
/**
* delTags() 的回調(diào)函數(shù)。
*
* @param context
* 上下文
* @param errorCode
* 錯誤碼,。0表示某些tag已經(jīng)刪除成功,；非0表示所有tag均刪除失敗。
* @param successTags
* 成功刪除的tag
* @param failTags
* 刪除失敗的tag
* @param requestId
* 分配給對云推送的請求的id
*/
@Override
public void onDelTags(Context context, int errorCode,
List<String> sucessTags, List<String> failTags, String requestId) {
String responseString = "onDelTags errorCode=" + errorCode
+ " sucessTags=" + sucessTags + " failTags=" + failTags
+ " requestId=" + requestId;
Log.e(TAG, responseString);
// Demo更新界面展示代碼，應用請在這里加入自己的處理邏輯
updateContent(context, responseString);
}
/**
* listTags() 的回調(diào)函數(shù)。
*
* @param context
* 上下文
* @param errorCode
* 錯誤碼,。0表示列舉tag成功,；非0表示失敗。
* @param tags
* 當前應用設置的所有tag,。
* @param requestId
* 分配給對云推送的請求的id
*/
@Override
public void onListTags(Context context, int errorCode, List<String> tags,
String requestId) {
String responseString = "onListTags errorCode=" + errorCode + " tags="
+ tags;
Log.e(TAG, responseString);
// Demo更新界面展示代碼，應用請在這里加入自己的處理邏輯
updateContent(context, responseString);
}
/**
* PushManager.stopWork() 的回調(diào)函數(shù)。
*
* @param context
* 上下文
* @param errorCode
* 錯誤碼,。0表示從云推送解綁定成功；非0表示失敗,。
* @param requestId
* 分配給對云推送的請求的id
*/
@Override
public void onUnbind(Context context, int errorCode, String requestId) {
String responseString = "onUnbind errorCode=" + errorCode
+ " requestId = " + requestId;
Log.e(TAG, responseString);
// 解綁定成功,，設置未綁定flag，
if (errorCode == 0) {
PreUtils.unbind(context);
}
// Demo更新界面展示代碼,，應用請在這里加入自己的處理邏輯
updateContent(context, responseString);
}
private void updateContent(Context context, String content) {
Log.e(TAG, "updateContent");
//String logText = "" + Utils.logStringCache;
// if (!logText.equals("")) {
// logText += "\n";
// }
// SimpleDateFormat sDateFormat = new SimpleDateFormat("HH-mm-ss");
// logText += sDateFormat.format(new Date()) + ": ";
// logText += content;
//Utils.logStringCache = logText;
Intent intent = new Intent();
intent.putExtra("result", content);
intent.setClass(context.getApplicationContext(), MainActivity.class);
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
context.getApplicationContext().startActivity(intent);
}
}