Android近场通信---NFC基础（五）

Android应用程序记录（Android Application Record---AAR）

在Android4.0（API Level 14）中引入的Android应用程序记录（AAR），提供了较强的在扫描到NFC标签时，启动应用程序的确定性。AAR有嵌入到NDEF记录内部的应用程序的包名。你能够把一个AAR添加到你的NDEF消息的任何记录中，因为Android会针对AAR来搜索整个NDEF消息。如果它找到一个AAR，它就会基于AAR内部的包名来启动应用程序。如果该应用程序不在当前的设备上，会启动Google Play来下载对应的应用程序。

如果你想要防止其他的应用对相同的Intent的过滤并潜在的处理你部署的特定的NFC标签，那么AAR是有用的。AAR仅在应用程序级被支持，因为包名的约束，并不能在Activity级别来过滤Intent。如果你想要在Activity级处理Intent，请使用Intent过滤器。

如果NFC标签中包含了AAR，则NFC标签调度系统会按照下列方式来调度：

1.  通常，尝试使用Intent过滤器来启动一个Activity。如果跟该Intent匹配的Activity也跟AAR匹配，那么就启动该Activity。

2.  如果跟Intent队形的Activity跟AAR不匹配，或者是有多个Activity能够处理该Intent，或者是没有能够处理该Intent的Activity存在，那么就启动由AAR指定的应用程序。

3.  如果没有跟该AAR对应的应用程序，那么就会启动Google Play来小组基于该AAR的应用程序。

注意：你能够用前台调度系统来重写AAR和Intent调度系统，在NFC标签被发现时。它允许优先使用前台的Activity。用这种方法，Activity必须是在前台来重写AAR和Intent调度系统。

如果你依然想要过滤扫描到的没有包含AAR的NFC标签，通常，你能够声明Intent过滤器。如果你的应用程序对不包含AAR的其他NFC标签感兴趣，这种做法是有用的。例如，你可能想要保证你的应用程序处理你部署的专用NFC标签，以及由第三方部署的普通的NFC标签。要记住AAR是在Android4.0以后才指定的，因此部署NFC标签时，你很可能希望使用能够广泛支持AAR和MIME类型/URI的是设备。另外，在你部署NFC标签时，还要想如何编写你的NFC标签，以便让大多数设备（Android设备和其他设备）支持。同过定义相对唯一的MIME类型或URI，让应用程序更容易的区分，就可以做到这一点。

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