轉自 http://blog.csdn.net/think_soft/article/details/8190463html
Android應用程序記錄(Android Application Record---AAR)java
在Android4.0(API Level 14)中引入的Android應用程序記錄(AAR),提供了較強的在掃描到NFC標籤時,啓動應用程序的肯定性。AAR有嵌入到NDEF記錄內部的應用程序的包名。你可以把一個AAR添加到你的NDEF消息的任何記錄中,由於Android會針對AAR來搜索整個NDEF消息。若是它找到一個AAR,它就會基於AAR內部的包名來啓動應用程序。若是該應用程序不在當前的設備上,會啓動Google Play來下載對應的應用程序。android
若是你想要防止其餘的應用對相同的Intent的過濾並潛在的處理你部署的特定的NFC標籤,那麼AAR是有用的。AAR僅在應用程序級被支持,由於包名的約束,並不能在Activity級別來過濾Intent。若是你想要在Activity級處理Intent,請使用Intent過濾器。app
若是NFC標籤中包含了AAR,則NFC標籤調度系統會按照下列方式來調度:ide
1. 一般,嘗試使用Intent過濾器來啓動一個Activity。若是跟該Intent匹配的Activity也跟AAR匹配,那麼就啓動該Activity。ui
2. 若是跟Intent隊形的Activity跟AAR不匹配,或者是有多個Activity可以處理該Intent,或者是沒有可以處理該Intent的Activity存在,那麼就啓動由AAR指定的應用程序。this
3. 若是沒有跟該AAR對應的應用程序,那麼就會啓動Google Play來小組基於該AAR的應用程序。spa
注意:你可以用前臺調度系統來重寫AAR和Intent調度系統,在NFC標籤被發現時。它容許優先使用前臺的Activity。用這種方法,Activity必須是在前臺來重寫AAR和Intent調度系統。.net
若是你依然想要過濾掃描到的沒有包含AAR的NFC標籤,一般,你可以聲明Intent過濾器。若是你的應用程序對不包含AAR的其餘NFC標籤感興趣,這種作法是有用的。例如,你可能想要保證你的應用程序處理你部署的專用NFC標籤,以及由第三方部署的普通的NFC標籤。要記住AAR是在Android4.0之後才指定的,所以部署NFC標籤時,你極可能但願使用可以普遍支持AAR和MIME類型/URI的是設備。另外,在你部署NFC標籤時,還要想如何編寫你的NFC標籤,以便讓大多數設備(Android設備和其餘設備)支持。同過定義相對惟一的MIME類型或URI,讓應用程序更容易的區分,就能夠作到這一點。code
Android提供了簡單的建立AAR的API:createApplicationRecord()。你須要作的全部工做就是把AAR嵌入到你的NdefMessage中。除非AAR是NdefMessage中的惟一記錄,不然不要把使用NdefMessage的第一條記錄。這是由於,Android系統會檢查NdefMessage的第一條記錄來判斷NFC標籤的MIME類型或URI,這些信息被用於建立對應應用程序的Intent對象。如下代碼演示瞭如何建立一個AAR:
NdefMessage msg = new NdefMessage(
new NdefRecord[] {
...,
NdefRecord.createApplicationRecord("com.example.android.beam")}
把NDEF消息發射到其餘設備上
Android Beam容許在兩個Android設備之間進行簡單的對等數據交換,想要把數據發送給另外一個設備的應用程序必須是在前臺,而且接收數據的設備必須不被鎖定。當發射設備跟接收設備的距離足夠近的時候,發射設備會顯示「Touch to Beam(觸摸發射)」的UI。而後,用戶可以選擇是否把消息發射給接收設備。
注意:在API Level 10中能夠利用前臺的NDEF推送,它提供了與Android Beam相似的功能。這些API已通過時了,可是在一些老舊設備上還有效。更多的信息請看enableForegroundNdefPush()。
經過調用下列兩個方法中的任意一個,就可以爲你的應用程序啓用Android Beam:
1. setNdefPushMessage():這個方法把接收到的NdefMessage對象做爲一個消息設置給Beam。當兩個設備足夠近的時候,就會自動的發送消息。
2. setNdefPushMessageCallback():接收包含createNdefMessage()方法的回調,當設備在發射數據的範圍內時,這個回調方法會被調用。回調會讓你只在須要的時候建立NDEF消息。
一個Activity一次只能推送一條NDEF消息,所以若是同時使用了這兩種方法,那麼setNdefPushMessageCallback()方法的優先級要高於setNdefPushMessage()方法。要使用Android Beam,一般必須知足如下條件:
1. 發射數據的Activity必須是在前臺。兩個設備的屏幕都必須沒有被鎖定;
2. 必須發要發射的數據封裝到一個NdefMessage對象中;
3. 接收發射數據的NFC設備必須支持com.android.npp NDEF推送協議或是NFC組織的SNEP協議(簡單的NDEF交換協議)。在API Level9(Android2.3)到API Level 13(Android3.2)的設備上須要com.android.npp協議。在API Level 14(Android4.0)和之後的設備上,com.android.npp和SNEP都須要。
注意:若是在前臺的Activity啓用了Android Beam,那麼標準的Intent調度系統就會被禁用。可是,若是該Activity還啓用了前臺調度,那麼在前臺調度系統中,它依然可以掃描到跟Intent過濾器匹配的NFC標籤。
啓用Android Beam:
1. 建立一個準備推送到另外一個設備上的包含NdefRecord的NdefMessage對象。
2. 調用帶有NdefMessage類型參數的setNdefPushMessage()方法,或者是在Activity的onCreate()方法中調用setNdefPushMessageCallback方法來傳遞實現NfcAdapter.CreateNdefMessageCallback接口的對象。這兩個方法都至少須要一個準備要啓用Android Beam的Activity,以及一個可選的其餘的活躍的Activity列表。
一般,若是你的Activity在任什麼時候候都值推送相同的NDEF消息,那麼當兩個設備在通訊範圍內的時候,使用setNdefPushMessage()就能夠了。當你的應用程序要關注應用程序的當前內容,並想要根據用戶在你的應用程序中的行爲來推送NDEF消息時,就要使用setNdefPushMessageCallback方法。
下列示例代碼演示瞭如何在activity的onCreate()方法中調用NfcAdapter.CreateNdefMessageCallback方法(完整的示例請看AndroidBeamDemo)。這個示例中還有幫助建立MIME記錄的方法:
package com.example.android.beam;
import android.app.Activity;
import android.content.Intent;
import android.nfc.NdefMessage;
import android.nfc.NdefRecord;
import android.nfc.NfcAdapter;
import android.nfc.NfcAdapter.CreateNdefMessageCallback;
import android.nfc.NfcEvent;
import android.os.Bundle;
import android.os.Parcelable;
import android.widget.TextView;
import android.widget.Toast;
import java.nio.charset.Charset;
public class Beam extends Activity implements CreateNdefMessageCallback {
NfcAdapter mNfcAdapter;
TextView textView;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
TextView textView = (TextView) findViewById(R.id.textView);
// Check for available NFC Adapter
mNfcAdapter = NfcAdapter.getDefaultAdapter(this);
if (mNfcAdapter == null) {
Toast.makeText(this, "NFC is not available", Toast.LENGTH_LONG).show();
finish();
return;
}
// Register callback
mNfcAdapter.setNdefPushMessageCallback(this, this);
}
@Override
public NdefMessage createNdefMessage(NfcEvent event) {
String text = ("Beam me up, Android!\n\n" +
"Beam Time: " + System.currentTimeMillis());
NdefMessage msg = new NdefMessage(
new NdefRecord[] { createMime(
"application/vnd.com.example.android.beam", text.getBytes())
/**
* The Android Application Record (AAR) is commented out. When a device
* receives a push with an AAR in it, the application specified in the AAR
* is guaranteed to run. The AAR overrides the tag dispatch system.
* You can add it back in to guarantee that this
* activity starts when receiving a beamed message. For now, this code
* uses the tag dispatch system.
*/
//,NdefRecord.createApplicationRecord("com.example.android.beam")
});
return msg;
}
@Override
public void onResume() {
super.onResume();
// Check to see that the Activity started due to an Android Beam
if (NfcAdapter.ACTION_NDEF_DISCOVERED.equals(getIntent().getAction())) {
processIntent(getIntent());
}
}
@Override
public void onNewIntent(Intent intent) {
// onResume gets called after this to handle the intent
setIntent(intent);
}
/**
* Parses the NDEF Message from the intent and prints to the TextView
*/
void processIntent(Intent intent) {
textView = (TextView) findViewById(R.id.textView);
Parcelable[] rawMsgs = intent.getParcelableArrayExtra(
NfcAdapter.EXTRA_NDEF_MESSAGES);
// only one message sent during the beam
NdefMessage msg = (NdefMessage) rawMsgs[0];
// record 0 contains the MIME type, record 1 is the AAR, if present
textView.setText(new String(msg.getRecords()[0].getPayload()));
}
}
注意:上例代碼把AAR給註釋掉了,你能夠刪除它。若是你啓用了AAR,那麼該應用程序就會始終接收在AAR中指定的Android Beam消息。若是該應用程序不存在,Google Play就會啓動下載程序。所以,若是使用AAR,對於Android4.0之後的設備,下列的Intent過濾器,在技術上不是必須的:
<intent-filter>
<action android:name="android.nfc.action.NDEF_DISCOVERED"/>
<category android:name="android.intent.category.DEFAULT"/>
<data android:mimeType="application/vnd.com.example.android.beam"/>
</intent-filter>
有了這個Intent過濾器,com.example.android.beam應用就可以在如下狀況下被啓動:
1. 掃描到NFC標籤;
2. 接收到com.example.android.beam類型的AAR或NDEF消息中包含一條application/vnd.com.example.android.beam類型的MIME記錄的Android beam的時候。
即便經過AAR可以保證了一個應用程序被啓動或下載,可是仍是推薦使用Intent過濾器,由於它會讓你選擇啓動應用程序中Activity,而不是總啓動AAR中指定的應用程序包的主Activity。AAR沒有Activity級別的粒度。並且還有一些android設備不支持AAR,你還應該在NDEF消息的第一條NDEF記錄中嵌入標識信息,以及對應的過濾器。