作者 謝恩銘,公眾號「程序員聯(lián)盟」(微信號:coderhub)。
轉(zhuǎn)載請注明出處。
原文:http://www.lxweimin.com/p/e85884989f12
內(nèi)容簡介
- 前言
- 不可行的實(shí)現(xiàn)
- 可行的實(shí)現(xiàn)
1. 前言
這篇文章算是一個(gè)小小的 Android 開發(fā)經(jīng)驗(yàn)總結(jié),也是拋磚引玉。如有錯(cuò)謬,歡迎指正。
最近在 Github 上一個(gè)開源的 Android Messages app 中,修正了一個(gè)需求的實(shí)現(xiàn)。
這個(gè)開源的 Android app 是 QKSMS 。還不錯(cuò)的一個(gè)遵循 Material Design 的開源免費(fèi)的 Android 消息應(yīng)用,不過貌似作者不怎么維護(hù)了,比較可惜。
之前我也為這個(gè)開源項(xiàng)目貢獻(xiàn)過一些補(bǔ)丁,我還寫了一篇文章專門講如何為 Github 的開源項(xiàng)目提交補(bǔ)丁:
Github | 如何貢獻(xiàn)Android開源項(xiàng)目和提交補(bǔ)丁
需求如下:
在退出 Airplane mode(飛行模式)之后自動發(fā)送之前失敗的所有 SMS(Short Message Service,就是「短信」)和 MMS(Multimedia Message Service,就是「彩信」,例如 圖片,視頻,音頻,VCard 等等)。
2. 不可行的實(shí)現(xiàn)
之前作者其實(shí)已經(jīng)寫了這一塊代碼,但是沒有滿足需求。
他是這么處理的:
既然要在退出飛行模式時(shí)重新發(fā)送,那么就用一個(gè) BroadcastReceiver 來接收系統(tǒng)的飛行模式狀態(tài)改變的廣播,一旦接收到廣播,即重新發(fā)送所有失敗的 SMS和 MMS。
關(guān)鍵代碼如下:
// 類定義
public class AirplaneModeReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
if (!intent.getAction().equals(Intent.ACTION_AIRPLANE_MODE_CHANGED)) {
return;
}
// 如果是進(jìn)入飛行模式,那么什么也不做
if (intent.getBooleanExtra("state", true)) {
return;
}
// 找出所有包含未成功的消息的對話(conversation),返回 Cursor
Cursor conversationCursor = context.getContentResolver().query(
SmsHelper.CONVERSATIONS_CONTENT_PROVIDER,
Conversation.ALL_THREADS_PROJECTION,
Conversation.FAILED_SELECTION, null,
SmsHelper.sortDateDesc
);
// 遍歷每個(gè)這樣的對話
while (conversationCursor.moveToNext()) {
Uri uri = ContentUris.withAppendedId(SmsHelper.MMS_SMS_CONTENT_PROVIDER, conversationCursor.getLong(Conversation.ID));
// 找出對話中所有未成功的消息,返回 Cursor
Cursor cursor = context.getContentResolver().query(uri, MessageColumns.PROJECTION,
SmsHelper.FAILED_SELECTION, null, SmsHelper.sortDateAsc);
// 把 Cursor 映射到一個(gè) MessageItem 對象,然后重新發(fā)送它
MessageColumns.ColumnsMap columnsMap = new MessageColumns.ColumnsMap(cursor);
while (cursor.moveToNext()) {
try {
MessageItem message = new MessageItem(context, cursor.getString(columnsMap.mColumnMsgType),
cursor, columnsMap, null, true);
sendMessage(context, message);
} catch (MmsException e) {
e.printStackTrace();
}
}
cursor.close();
}
conversationCursor.close();
}
// 發(fā)送消息
private void sendMessage(Context context, MessageItem messageItem) {
Transaction sendTransaction = new Transaction(context, SmsHelper.getSendSettings(context));
Message message = new Message(messageItem.mBody, messageItem.mAddress);
message.setType(Message.TYPE_SMSMMS);
context.getContentResolver().delete(messageItem.mMessageUri, null, null);
sendTransaction.sendNewMessage(message, 0);
}
}
<!-- 在 AndroidManifest.xml 中注冊這個(gè) BroadcastReceiver -->
<receiver android:name=".AirplaneModeReceiver">
<intent-filter>
<action android:name="android.intent.action.AIRPLANE_MODE" />
</intent-filter>
</receiver>
上面的代碼中有些內(nèi)容,比如重新發(fā)送消息的代碼,包含一些 QKSMS 中的定義,不過不少代碼都是用的 Android 源碼中的定義。
例如:
public static final Uri CONVERSATIONS_CONTENT_PROVIDER = Uri.parse("content://mms-sms/conversations?simple=true");
SmsHelper.CONVERSATIONS_CONTENT_PROVIDER 這個(gè) Uri 是表示所有的對話。
而 Conversation.ALL_THREADS_PROJECTION 的定義如下:
public static final String[] ALL_THREADS_PROJECTION = {
Threads._ID, Threads.DATE, Threads.MESSAGE_COUNT, Threads.RECIPIENT_IDS,
Threads.SNIPPET, Threads.SNIPPET_CHARSET, Threads.READ, Threads.ERROR,
Threads.HAS_ATTACHMENT
};
SmsHelper.MMS_SMS_CONTENT_PROVIDER 也是標(biāo)準(zhǔn)的 Android 的 Uri:
public static final Uri MMS_SMS_CONTENT_PROVIDER = Uri.parse("content://mms-sms/conversations/");
而 MessageItem 這樣的類基本使用了 Android 的 AOSP(Android Open Source Project)中的代碼。
QKSMS 這個(gè)開源項(xiàng)目大量使用了 AOSP 中的代碼,這也是它必須開源的原因。
其他的一些定義則是 QKSMS 中自定義的類或變量,大家可以自行去看 Github 上的 源碼,或者 git clone 下來用 Android Studio 查看。上面的重新發(fā)送 SMS 和 MMS 的代碼是一個(gè)可以借鑒的實(shí)現(xiàn)。
上面的代碼看似可以實(shí)現(xiàn)需求。實(shí)際測試時(shí)發(fā)現(xiàn),一旦退出飛行模式,確實(shí)會重新發(fā)送失敗的 SMS 和 MMS,但是還是會失敗。
這是為什么呢?
原因很簡單:
剛退出飛行模式時(shí),系統(tǒng)還需要一些時(shí)間去重新連接 Cellular network(蜂窩網(wǎng)絡(luò),又稱 移動網(wǎng)絡(luò)(mobile network))。如果在檢測到關(guān)閉飛行模式時(shí)立即發(fā)送未成功的消息,系統(tǒng)還沒有連接完畢,難免會失敗。
3. 可行的實(shí)現(xiàn)
既然上面的實(shí)現(xiàn)不可行,那么應(yīng)該如何來實(shí)現(xiàn)呢?
首先我們要知道:
MMS 需要移動數(shù)據(jù),SMS 不需要移動數(shù)據(jù)。
就是說:MMS 的發(fā)送和接收需要 Mobile data,而 SMS 則并不需要。當(dāng)然了,SMS 和 MMS 都需要有運(yùn)營商(Network Operator)的網(wǎng)絡(luò),也就是需要有 SIM 卡。
開啟和關(guān)閉 Mobile data 的操作一般可以在 Android 手機(jī)里的「儀表盤」上這樣實(shí)現(xiàn):
如上圖所示,左邊的 Mobile data 是用于開啟或關(guān)閉 Mobile data(移動數(shù)據(jù))。右邊的 Airplane mode 是用于開啟或關(guān)閉飛行模式。
因此,有兩種情況:
開啟飛行模式前,并沒有開啟 Mobile data。這樣的話,在關(guān)閉飛行模式后,MMS 也不能發(fā)送,只有 SMS 能被發(fā)送,因?yàn)橹挥?Cellular network 會重新連接。
開啟飛行模式前,已經(jīng)開啟 Mobile data。這樣的話,在關(guān)閉飛行模式后,MMS 和 SMS 都可以被發(fā)送。因?yàn)?Cellular network 和 Mobile data 都會重新連接。
我們的代碼也就需要分兩部分來監(jiān)聽:
負(fù)責(zé)重新發(fā)送 SMS 的:只需要監(jiān)聽 Cellular network(移動網(wǎng)絡(luò))的狀態(tài)改變。如果狀態(tài)為已連接,則嘗試重新發(fā)送未成功的 SMS。
負(fù)責(zé)重新發(fā)送 MMS 的:因?yàn)?Cellular network 連接還不夠,還需要 Mobile data 連接。因此需要監(jiān)聽 Mobile data(移動數(shù)據(jù))狀態(tài)改變。如果狀態(tài)為已連接,則嘗試重新發(fā)送未成功的 MMS。
監(jiān)聽 Cellular network(移動網(wǎng)絡(luò))的狀態(tài)改變
我們需要監(jiān)聽 "android.intent.action.SERVICE_STATE" 這個(gè) actioin 對應(yīng)的廣播:
@Override
public void onReceive(Context context, Intent intent) {
if (intent.getAction().equals("android.intent.action.SERVICE_STATE")) {
if (isCellularNetworkOn(context)) {
// 當(dāng) Cellular network 連接上之后,主要用于重新發(fā)送未成功的 SMS
// 重新發(fā)送的實(shí)現(xiàn) ...
}
}
}
監(jiān)聽 Mobile datata(移動數(shù)據(jù))狀態(tài)改變
我們需要監(jiān)聽 ConnectivityManager.CONNECTIVITY_ACTION (也就是 "android.net.conn.CONNECTIVITY_CHANGE" )這個(gè) actioin 對應(yīng)的廣播:
@Override
public void onReceive(Context context, Intent intent) {
if (intent.getAction().equals(ConnectivityManager.CONNECTIVITY_ACTION)) {
NetworkInfo mNetworkInfo = intent.getParcelableExtra(ConnectivityManager.EXTRA_NETWORK_INFO);
if ((mNetworkInfo == null) || (mNetworkInfo.getType() != ConnectivityManager.TYPE_MOBILE)) {
return;
}
if (mNetworkInfo.isConnected()) {
// 當(dāng) Mobile data 連接上時(shí),主要用于重新發(fā)送未成功的 MMS
// 重新發(fā)送的實(shí)現(xiàn) ...
}
}
}
合并實(shí)現(xiàn)
我們可以把兩個(gè)監(jiān)聽的部分合并在一個(gè) BroadcastReceiver 中實(shí)現(xiàn),合并后的代碼如下 :
/**
* 監(jiān)聽移動網(wǎng)絡(luò)狀態(tài)改變,以便能夠重新發(fā)送未成功的消息(SMS 和 MMS)
* MMS 需要 Mobile data,而 SMS不需要
*/
public class MobileNetworkReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
if (intent.getAction().equals("android.intent.action.SERVICE_STATE")) {
if (isCellularNetworkOn(context)) {
// 當(dāng) Cellular network 連接上時(shí),主要用于重新發(fā)送未成功的 SMS
resendFailedMessages(context);
}
} else if (intent.getAction().equals(ConnectivityManager.CONNECTIVITY_ACTION)) {
NetworkInfo mNetworkInfo = intent.getParcelableExtra(ConnectivityManager.EXTRA_NETWORK_INFO);
if ((mNetworkInfo == null) || (mNetworkInfo.getType() != ConnectivityManager.TYPE_MOBILE)) {
return;
}
if (mNetworkInfo.isConnected()) {
// 當(dāng) Mobile data 連接上時(shí),主要用于重新發(fā)送未成功的 MMS
resendFailedMessages(context);
}
}
}
// 重新發(fā)送失敗的消息(SMS 或 MMS)
private void resendFailedMessages(Context context) {
// 找出所有包含未成功的消息的對話(conversation),返回 Cursor
Cursor conversationCursor = context.getContentResolver().query(
SmsHelper.CONVERSATIONS_CONTENT_PROVIDER,
Conversation.ALL_THREADS_PROJECTION,
Conversation.FAILED_SELECTION, null,
SmsHelper.sortDateDesc
);
// 遍歷每個(gè)這樣的對話
while (conversationCursor.moveToNext()) {
Uri uri = ContentUris.withAppendedId(SmsHelper.MMS_SMS_CONTENT_PROVIDER, conversationCursor.getLong(Conversation.ID));
// 找出對話中所有未成功的消息,返回 Cursor
Cursor cursor = context.getContentResolver().query(uri, MessageColumns.PROJECTION,
SmsHelper.FAILED_SELECTION, null, SmsHelper.sortDateAsc);
// 把 Cursor 映射到一個(gè) MessageItem 對象,然后重新發(fā)送它
MessageColumns.ColumnsMap columnsMap = new MessageColumns.ColumnsMap(cursor);
while (cursor.moveToNext()) {
try {
MessageItem message = new MessageItem(context, cursor.getString(columnsMap.mColumnMsgType),
cursor, columnsMap, null, true);
sendMessage(context, message);
} catch (MmsException e) {
e.printStackTrace();
}
}
cursor.close();
}
conversationCursor.close();
}
// 發(fā)送消息
private void sendMessage(Context context, MessageItem messageItem) {
Transaction sendTransaction = new Transaction(context, SmsHelper.getSendSettings(context));
Message message = new Message(messageItem.mBody, messageItem.mAddress);
message.setType(Message.TYPE_SMSMMS);
sendTransaction.sendNewMessage(message, 0);
context.getContentResolver().delete(messageItem.mMessageUri, null, null);
}
// 判斷 Cellular network 是否已連接
public static boolean isCellularNetworkOn(Context context) {
TelephonyManager telephonyManager = (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
return telephonyManager.getNetworkOperator() != null && !telephonyManager.getNetworkOperator().isEmpty();
}
}
<!-- 在 AndroidManifest.xml 中添加權(quán)限 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 在 AndroidManifest.xml 中注冊這個(gè) BroadcastReceiver -->
<receiver android:name=".MobileNetworkReceiver">
<intent-filter>
<action android:name="android.intent.action.SERVICE_STATE" />
<action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
</intent-filter>
</receiver>
我是 謝恩銘,公眾號「程序員聯(lián)盟」(微信號:coderhub)運(yùn)營者,慕課網(wǎng)精英講師 Oscar 老師,終生學(xué)習(xí)者。
熱愛生活,喜歡游泳,略懂烹飪。
人生格言:「向著標(biāo)桿直跑」