PBAP協議

使用場景:智慧車載中同步聯絡人等資訊

其實,不僅可以同步聯絡人,還可以同步通話記錄等資訊。

1.協議概述

協議程式碼路徑: 

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

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

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

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

pbap這個包中檔案如下,

使用pbap協議同步聯絡人/通話記錄時的開發流程和其他的協議不一樣,並且pbap協議只有客戶端,沒有服務端. BluetoothPbapClient是其客戶端,在此先不看其客戶端的方法。

2開發步驟

1) 構造BluetoothPbapClient物件,

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

3詳細開發過程

3.1構造BluetoothPbapClient

BluetoothPbapClient如何構造呢?原始碼有2個構造方法,其中一種如下 ,

public BluetoothPbapClient(BluetoothDevice device, Handler handler) { 
        mClientHandler = handler; 
        mSessionHandler = new SessionHandler(this); 
        addSdp();
        mSession = new BluetoothPbapSession(device, mSessionHandler);
    }
 

從中可以看到,構造方法有2個引數, device當然是遠端藍芽裝置了,這個很容易獲取,

另外一個Handler物件,主要用於一些訊息的回撥,那就先新建一個Handler物件。

所以可以很簡單的進行構造,

mPbapClient = new BluetoothPbapClient(device, mPbapHandler);

3.2方法以及回撥處理

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

BluetoothPbapClient一些字串定義如下,

public static final String ICH_PATH = "telecom/ich.vcf"; // 手機來電記錄
public static final String OCH_PATH = "telecom/och.vcf"; // 手機去電記錄
public static final String MCH_PATH = "telecom/mch.vcf";// 手機未接電話記錄
public static final String CCH_PATH = "telecom/cch.vcf";  // 所有通話記錄
public static final String PB_PATH = "telecom/pb.vcf";      // 手機聯絡人

對應的SIM卡上的通話記錄以及聯絡人路徑如下,

public static final String SIM_ICH_PATH = "SIM1/telecom/ich.vcf";
public static final String SIM_OCH_PATH = "SIM1/telecom/och.vcf";
public static final String SIM_MCH_PATH = "SIM1/telecom/mch.vcf";
public static final String SIM_CCH_PATH = "SIM1/telecom/cch.vcf";
public static final String SIM_PB_PATH = "SIM1/telecom/pb.vcf";

同步聯絡人的詳細開發如下,

 設定路徑,呼叫pullPhoneBook方法,

private String mDownloadSpinner = "telecom/pb.vcf";
mPbapClient. pullPhoneBook(mDownloadSpinner);

 回撥處理

ArrayList<VCardEntry>pullPhoneBook; // 儲存同步的聯絡人

private final Handler mPbapHandler = new Handler() {

        @Override
        public void handleMessage(Message msg) {
            switch (msg.what) {
               case BluetoothPbapClient.EVENT_PULL_PHONE_BOOK_DONE: 
                	pullPhoneBook = (ArrayList<VCardEntry>) msg.obj;
                    break;
                }
};

到此, pullPhoneBook就儲存了同步的聯絡人,後續就可以進行處理了。

同樣的,也可以設定其他路徑以方法同步通話記錄等。

ArrayList<BluetoothPbapCard> pullVcardListing = null; // 儲存同步檔案
VCardEntry pullVcardEntry = null;  // 儲存同步單個檔案

 4流程圖

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

流程圖很簡單,沒有跨程序通訊,只是單開一個執行緒同步聯絡人,每個聯絡人對應一個VCardEntry物件。VCardEntry物件在VCardEntryConstructor類中建立,在BluetoothPbapVcardList的內部類CardEntryHandler的onEntryCreated方法新增到名為mCards的ArrayList中。同步完之後, BluetoothPbapClient中的SessionHandler物件首先獲取mCards,然後通過EVENT_PULL_PHONE_BOOK_DONE訊息將mCards(VCardEntry陣列)發出,因此在開發時處理該訊息就可以獲取同步的聯絡人。

5 VCardEntry簡析

VCardEntry可以儲存聯絡人/通話記錄的各種資訊,看列舉EntryLabel

每一個列舉物件都對應一個聯絡人資訊,比如名字/電話號碼,也對應一個VCardEntry的內部類,它們都繼承內部介面EntryElement。

看下VCardParser_V21類parseOneVCard方法

private boolean parseOneVCard() throws IOException, VCardException {
        // reset for this entire vCard.
        mCurrentEncoding = DEFAULT_ENCODING;
        mCurrentCharset = DEFAULT_CHARSET;

        boolean allowGarbage = false;
        if (!readBeginVCard(allowGarbage)) {
            return false;
        }
        for (VCardInterpreter interpreter : mInterpreterList) {
            interpreter.onEntryStarted();
        }
        parseItems();
        for (VCardInterpreter interpreter : mInterpreterList) {
            interpreter.onEntryEnded();
        }
        return true;
    }

onEntryStarted最後會構造VCardEntry, parseItems會呼叫VCardEntry的addProperty方法完成各種資訊的儲存,最後呼叫onEntryEnded將所有VCardEntry物件打包到ArrayList中。

在這14個列舉中,並沒有時間資訊,即使是獲取通話記錄,也並沒有時間的資訊。如何同步時間資訊呢?

檢視PBAP協議,有一個這樣的欄位,X-IRMC-CALL-DATETIME,說明可以同步時間資訊的。通過對VCardParserImpl_V21和VCardEntry的addProperty方法進行除錯,發現X-IRMC-CALL-DATETIME引數是有輸出的,只是VCardEntry中沒有該列舉和對應的類而已。在VCardEntry中新增列舉和對應的內部類就可以實現同步時間的功能。

  1,,在列舉EntryLabel最後新增一項,

DATETIME

  2,, 新增對應的內部類

public static class DatetimeData implements EntryElement {
        private final String mDatetime;

        public DatetimeData(String datetime) {
            mDatetime = datetime;
        }
        @Override
        public EntryLabel getEntryLabel() {
            return EntryLabel. DATETIME;
        }
        @Override
        public boolean isEmpty() {
            return TextUtils.isEmpty(mDatetime);
        }
        @Override
        public void constructInsertOperation(List<ContentProviderOperation>
 operationList, int backReferenceIndex) { 
        }
        @Override
        public boolean equals(Object obj) {
            if (this == obj) {
                return true;
            }
            if (!(obj instanceof DatetimeData)) {
                return false;
            }
            DatetimeData datetimeData = (DatetimeData) obj;
            return TextUtils.equals(mDatetime, datetimeData.mDatetime);
        }
        @Override
        public int hashCode() {
            return mDatetime != null ? mDatetime.hashCode() : 0;
        }
        @Override
        public String toString() {
            return "call datetime: " + mDatetime;
        }
        public String getCallDatetime() {
            return mDatetime;
        }
    }

if(propertyName.equals(VCardConstants.PROPERTY_ DATETIME)) {
            mDatetimeData = new DatetimeData(propValue);  
}

4,,新增getter方法

public final String getCallDatetime() {
     return mCallDatetimeData != null ? mCallDatetimeData.mCallDatetime : null;
  }

public static final String PROPERTY_ DATETIME = "X-IRMC-CALL-DATETIME";