MAP協議

使用場景:智慧車載中同步簡訊,彩信等資訊

1 協議概述

協議程式碼路徑: 

frameworks\opt\bluetooth\src\android\bluetooth\client\ map這個包中

Jar包名稱,android.bluetooth.client. map

所以進行開發時,在mk檔案中需要新增這個包,

並且,在AndroidManifest檔案中必須匯入Obex庫,<uses-libraryandroid:name="javax.obex" />

map這個包中檔案如下,

MAP和PBAP協議開發流程以及細節幾乎完全一樣。

 2開發步驟

1) 構造BluetoothMasClient物件,

2) 呼叫BluetoothMasClient物件方法,處理對應的回撥訊息。

3詳細開發過程

3.1構造BluetoothMasClient

BluetoothMasClient的構造方法如下,

public BluetoothMasClient(BluetoothDevice device, SdpMasRecord mas, Handler callback) {
        mDevice = device;
        mMas = mas;
        mCallback = callback;

        mPath = new ArrayDeque<String>();
    }
 

有三個引數, device當然是遠端藍芽裝置了,這個很容易獲取,

mas 是遠端藍芽裝置的一個mas代理,是如何獲取的呢?

Callback 是Handler物件,主要用於一些訊息的回撥.

通過註冊廣播,接收廣播可以獲取SdpMasRecord物件,

 註冊廣播

IntentFilter filter = new IntentFilter();
filter.addAction(BluetoothDevice.ACTION_SDP_RECORD);
registerReceiver(mReceiver, filter);

 接收廣播

private final BroadcastReceiver mReceiver = new BroadcastReceiver() {
 @Override
public void onReceive(Context context, Intent intent) {
    String action = intent.getAction();
    if (action.equals(BluetoothDevice.ACTION_SDP_RECORD)){
       BluetoothDevice dev = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE); 
        ParcelUuid uuid = intent.getParcelableExtra(BluetoothDevice.EXTRA_UUID); 
        if(uuid.equals(BluetoothUuid.MAS)){
             SdpMasRecord masrec =
 intent.getParcelableExtra(BluetoothDevice.EXTRA_SDP_RECORD);
             BluetoothMasClient mapclient = new BluetoothMasClient(mDevice, masrec, 
                            mMapHandler);
                }
    };
 

3.2方法以及回撥處理

客戶端BluetoothMasClient的主要方法以及對應的回撥訊息如下,

已讀簡訊/未讀簡訊/草稿箱通過setFolderRoot方法來設定,路徑分別如下,

String inbox = "telecom/msg/inbox";
String outbox = "telecom/msg/outbox";
String draft= "telecom/msg/draft";

可以通過setMessageReadStatus方法設定同步的簡訊的狀態(已讀/未讀)

可以通過setMessageDeletedStatus方法設定同步的簡訊的狀態(刪除/不刪除)

還有通過pushMessage來新建簡訊,通過updateInbox來更新簡訊箱。

同步簡訊的詳細開發如下,

mapclient. connect()

mapclient. setFolderRoot()

mapclient.getMessagesListing()

ArrayList<BluetoothMapMessage> getMessagesListing; // 儲存同步簡訊
    BluetoothMapBmessage getMessage; //儲存同步簡訊

private final Handler mMapHandler = new Handler() {
        @Override
        public void handleMessage(Message msg) {
            switch (msg.what) {
              case BluetoothMasClient.EVENT_GET_MESSAGES_LISTING: 
                getMessagesListing = (ArrayList< BluetoothMapMessage >) msg.obj;
                    break;
                }
};

到此, getMessagesListing就儲存了同步的簡訊,後續就可以進行處理了。

 4流程圖

同步的方法呼叫流程幾乎是一模一樣的,所以以getMessagesListing方法為例,

流程圖比同步聯絡人更簡單,每條簡訊對應一個BluetoothMapMessage物件。同步完之後, BluetoothMasClient中的SessionHandler物件首先獲取BluetoothMapMessage陣列,然後通過EVENT_GET_MESSAGES_LISTING訊息將BluetoothMapMessage發出,因此在開發時處理該訊息就可以獲取同步的簡訊。

5 BluetoothMapMessage簡析

檢視BluetoothMapMessage原始碼,可以看到同步簡訊所儲存的資訊,

private final String mHandle;
private final String mSubject;
private final Date mDateTime;
private final String mSenderName;
private final String mSenderAddressing;
private final String mReplytoAddressing;
private final String mRecipientName;
private final String mRecipientAddressing;
private final Type mType;
private final int mSize;
private final boolean mText;
private final ReceptionStatus mReceptionStatus;
private final int mAttachmentSize;
private final boolean mPriority;
private final boolean mRead;
private final boolean mSent;
private final boolean mProtected;

每條簡訊的資訊都在BluetoothMapMessage構造方法中賦值,並且每個字元/boolean值都有對應的獲取/判斷方法,一一對應,相對來說,比pbap協議的要簡單得多。