转自 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记录中嵌入标识信息,以及对应的过滤器。