Android中NFC程式設計
你可以在Android的NFC支援頁面找到相關的API文件和NFC的示例程式碼:
接下來該怎麼做呢?通常需要硬體的支援(手機支援NFC)和新增你的應用的許可權。
這需要你修改你的AndroidManifest.xml檔案,將最低的SDK版本更改為10,也就是Android2.3.3及以上版本:
<uses-sdkandroid:minSdkVersion="10"/>
還有就是你的手機需要支援NFC,應用必須獲取與硬體互動的許可權:
<uses-featureandroid:name="android.hardware.nfc"android:required="true"/> <uses-permissionandroid:name="android.permission.NFC"/>
你也可以通過定義Intent來對NFC掃描獲取的資料進行過濾處理。這裡僅僅是使用ACTION_NDEF_DISCOVERED處理字元資料。當然也有其他的NFC規格的資料型別的定義。
<intent-filter> <action android:name="android.nfc.action.NDEF_DISCOVERED"/> <categoryandroid:name="android.intent.category.DEFAULT"/> <dataandroid:mimeType="text/plain"/> </intent-filter>
NFC資料交換格式
NdefMessage包含傳輸在NDEF中的資料,每個NdefMessage由定義在NdefRecord的多個記錄組成。每個NdefRecord根據它指明的3-bit的TNF進行解釋。檢視完整的TNF列表及其對映,最常用的TNF是TNF_WELL_KNOWN 和 TNF_MIME_MEDIA。標籤排程系統通過三個Intent處理解包的NFC資料(通過Intent傳遞資料)。根據優先順序的先後,它們是ACTION_NDEF_DISCOVERED,ACTION_TECH_DISCOVERED,和ACTION_TAG_DISCOVERED。
這裡是官方的描述:“只要可能,儘可能的使用NDEF訊息和ACTION_NDEF_DISCOVERED,因為三個Intent中最詳細的。這個Intent可以比其他兩個Intent在更加合適的時間啟動你的應用,給使用者更好的體驗”。
在Android中讀取NFC標籤 和貼紙
正如我們在前一節提到,NdefMessage 是交換NFC資料最常用的方式。當然,你仍然可以定義你自己的non-NDEF 資料,但是這超出了本教程的範圍。為了說明資料是如何被標籤排程系統解析和處理的,我們僅在我們的例項中使用簡單的純文字。對於其他型別,看一下官方網站。
NfcAdapter用來監測裝置對NFC的支援。前臺排程系統允許一個活動攔截一個意圖並允許這個活動比其他處理相同意圖的活動擁有更高的優先順序。
在onNewIntent(),我們試圖解析所有的NDEF訊息和它們的記錄。因為有幾個不同的資料型別,這個例子僅僅試圖解析由inNdefRecord.RTD_TEXT定義的文字型別。
packagecom.songsoft.NFC;
importjava.util.Arrays;
importandroid.app.Activity;
importandroid.app.PendingIntent;
importandroid.content.Intent;
importandroid.content.IntentFilter;
importandroid.nfc.NdefMessage;
importandroid.nfc.NdefRecord;
importandroid.nfc.NfcAdapter;
importandroid.nfc.Tag;
importandroid.nfc.tech.NfcF;
importandroid.os.Bundle;
importandroid.os.Parcelable;
importandroid.util.Log;
importandroid.widget.TextView;
publicclass TagDispatch extends Activity {
private TextView mTextView;
private NfcAdapter mNfcAdapter;
private PendingIntent mPendingIntent;
private IntentFilter[] mIntentFilters;
private String[][] mNFCTechLists;
@Override
public void onCreate(Bundle savedState){
super.onCreate(savedState);
setContentView(R.layout.main);
mTextView =(TextView)findViewById(R.id.tv);
mNfcAdapter =NfcAdapter.getDefaultAdapter(this);
if (mNfcAdapter != null) {
mTextView.setText("讀取一個NFC標籤");
} else {
mTextView.setText("不支援NFC。");
}
mPendingIntent =PendingIntent.getActivity(this, 0,
newIntent(this, getClass()).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP), 0);
IntentFilter ndefIntent = newIntentFilter(NfcAdapter.ACTION_NDEF_DISCOVERED);
try {
ndefIntent.addDataType("*/*");
mIntentFilters = newIntentFilter[] { ndefIntent };
} catch (Exception e) {
Log.e("TagDispatch",e.toString());
}
mNFCTechLists = newString[][] { new String[] { NfcF.class.getName() } };
}
@Override
public void onNewIntent(Intent intent){
String action =intent.getAction();
Tag tag =intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
String s = action +"\n\n" + tag.toString();
Parcelable[] data =intent.getParcelableArrayExtra(NfcAdapter.EXTRA_NDEF_MESSAGES);
if (data != null) {
try {
for (int i= 0; i < data.length; i++) {
NdefRecord[] recs = ((NdefMessage)data[i]).getRecords();
for(int j = 0; j < recs.length; j++) {
if(recs[j].getTnf() == NdefRecord.TNF_WELL_KNOWN &&
Arrays.equals(recs[j].getType(),NdefRecord.RTD_TEXT)) {
byte[]payload = recs[j].getPayload();
StringtextEncoding = ((payload[0] & 0200) == 0) ? "UTF-8" :"UTF-16";
intlangCodeLen = payload[0] & 0077;
s+= ("\n\nNdefMessage[" + i + "], NdefRecord[" + j +"]:\n\"" +
newString(payload, langCodeLen + 1,
payload.length- langCodeLen - 1, textEncoding) +
"\"");
}
}
}
} catch (Exceptione) {
Log.e("TagDispatch",e.toString());
}
}
mTextView.setText(s);
}
@Override
public void onResume() {
super.onResume();
if (mNfcAdapter != null)
mNfcAdapter.enableForegroundDispatch(this, mPendingIntent,mIntentFilters, mNFCTechLists);
}
@Override
public void onPause() {
super.onPause();
if (mNfcAdapter != null)
mNfcAdapter.disableForegroundDispatch(this);
}
}
通過AndroidBeam將NFC資料傳到其他裝置
通過Android Beam的支援傳送NFC資料,所以這個活動通常被成為“beaming”。許多NDEF資料可以被傳遞,當然可以定義你自己的格式。這個例項演示瞭如何建立一個純文字型別的記錄。大部分程式碼看起來很熟悉。
packagecom.songsoft.NFC;
importjava.nio.charset.Charset;
importjava.util.Locale;
importandroid.app.Activity;
importandroid.nfc.NdefMessage;
importandroid.nfc.NdefRecord;
importandroid.nfc.NfcAdapter;
importandroid.os.Bundle;
importandroid.widget.TextView;
publicclass BeamData extends Activity {
private NfcAdapter mNfcAdapter;
private TextView mTextView;
private NdefMessage mNdefMessage;
@Override
public void onCreate(Bundle savedState){
super.onCreate(savedState);
setContentView(R.layout.main);
mTextView =(TextView)findViewById(R.id.tv);
mNfcAdapter =NfcAdapter.getDefaultAdapter(this);
if (mNfcAdapter != null) {
mTextView.setText("到另外一個裝置");
} else {
mTextView.setText("不支援NFC");
}
mNdefMessage = newNdefMessage(
newNdefRecord[] {
createNewTextRecord("NDEF文字記錄的第一個例項", Locale.ENGLISH, true),
createNewTextRecord("NDEF文字記錄的第二個例項", Locale.ENGLISH, true) });
}
public static NdefRecordcreateNewTextRecord(String text, Locale locale, boolean encodeInUtf8) {
byte[] langBytes =locale.getLanguage().getBytes(Charset.forName("US-ASCII"));
Charset utfEncoding =encodeInUtf8 ? Charset.forName("UTF-8") :Charset.forName("UTF-16");
byte[] textBytes =text.getBytes(utfEncoding);
int utfBit = encodeInUtf8 ? 0: (1 << 7);
char status = (char)(utfBit +langBytes.length);
byte[] data = new byte[1 +langBytes.length + textBytes.length];
data[0] = (byte)status;
System.arraycopy(langBytes,0, data, 1, langBytes.length);
System.arraycopy(textBytes,0, data, 1 + langBytes.length, textBytes.length);
return newNdefRecord(NdefRecord.TNF_WELL_KNOWN, NdefRecord.RTD_TEXT, new byte[0], data);
}
@Override
public void onResume() {
super.onResume();
if (mNfcAdapter != null)
mNfcAdapter.enableForegroundNdefPush(this,mNdefMessage);
}
@Override
public void onPause() {
super.onPause();
if (mNfcAdapter != null)
mNfcAdapter.disableForegroundNdefPush(this);
}
}
總結
本NFC教程主要以強調一些關鍵的方面作為出發點,要想活的更多的資訊,可以訪問Android的官方網站。