发送文件给其他设备

    这节课将展示如何通过Android Beam文件传输向另一台设备发送大文件。要发送文件，首先应声明使用NFC和外部存储的权限，我们需要测试一下自己的设备是否支持NFC，这样才能够将文件的URI提供给Android Beam文件传输。

    使用Android Beam文件传输功能必须满足以下要求：

    1. Android Beam文件传输功能传输大文件必须在Android 4.1（API Level 16）及以上版本的Android系统中使用。
    2. 希望传送的文件必须放置于外部存储。更多关于外部存储的知识，请参考：Using the External Storage。
    3. 希望传送的文件必须是全局可读的。我们可以通过来为文件设置相应的读权限。
    4. 必须提供待传输文件的File URI。Android Beam文件传输无法处理由FileProvider.getUriForFile生成的Content URI。

    首先，编辑Manifest清单文件来声明应用程序所需要的权限和功能。

    为了允许应用程序使用Android Beam文件传输控制NFC从外部存储发送文件，必须在应用程序的Manifest清单文件中声明下面的权限：

    NFC

    允许应用程序通过NFC发送数据。为声明该权限，要添加下面的标签作为一个标签的子标签：

    1. <uses-permission
    2.             android:name="android.permission.READ_EXTERNAL_STORAGE" />

    通过添加<uses-feature>标签作为一个标签的子标签，指定我们的应用程序使用NFC。设置android:required属性字段为true，使得我们的应用程序只有在NFC可以使用时才能运行。

    下面的代码展示了如何指定<uses-feature>标签：

    注意，如果应用程序将NFC作为一个可选的功能，期望在NFC不可使用时程序还能继续执行，我们就应该将android:required属性字段设为false，然后在代码中测试NFC的可用性。

    由于Android Beam文件传输只能在Android 4.1（API Level 16）及以上的平台使用，如果应用将Android Beam文件传输作为一个不可缺少的核心模块，那么我们必须指定标签为：android:minSdkVersion=”16”。或者可以将设置为其它值，然后在代码中测试平台版本，这部分内容将在下一节中展开。

    1. <uses-feature android:name="android.hardware.nfc" android:required="false" />

    如果设置了android:required=”false”，则我们必须在代码中测试设备是否支持NFC和Android Beam文件传输。

    为在代码中测试是否支持Android Beam文件传输，我们先通过和参数FEATURE_NFC测试设备是否支持NFC。下一步，通过的值测试系统版本是否支持Android Beam文件传输。如果设备支持Android Beam文件传输，那么获得一个NFC控制器的实例，它能允许我们与NFC硬件进行通信，如下所示：

    一旦确认了设备支持Android Beam文件传输，那么可以添加一个回调函数，当Android Beam文件传输监测到用户希望向另一个支持NFC的设备发送文件时，系统就会调用该函数。在该回调函数中，返回一个Uri对象数组，Android Beam文件传输会将URI对应的文件拷贝给要接收这些文件的设备。

    要添加这个回调函数，需要实现接口，和它的方法：createBeamUris()，下面是一个例子：

    1. public class MainActivity extends Activity {
    2.     // List of URIs to provide to Android Beam
    3.     private Uri[] mFileUris = new Uri[10];
    5.     /**
    6.      * Callback that Android Beam file transfer calls to get
    7.      * files to share
    8.      */
    9.     private class FileUriCallback implements
    10.             NfcAdapter.CreateBeamUrisCallback {
    11.         public FileUriCallback() {
    12.         }
    13.         /**
    14.          * Create content URIs as needed to share with another device
    15.          */
    16.         @Override
    17.         public Uri[] createBeamUris(NfcEvent event) {
    18.             return mFileUris;
    19.     }
    21. }

    一旦实现了这个接口，通过调用将回调函数提供给Android Beam文件传输。下面是一个例子：

    为了将一或多个文件发送给其他支持NFC的设备，需要为每一个文件获取一个File URI（一个具有文件格式（file scheme）的URI），然后将它们添加至一个Uri对象数组中。此外，要传输一个文件，我们必须也拥有该文件的读权限。下例展示了如何根据文件名获取其File URI，然后将URI添加至数组当中：

    1.     /*
    2.      * Create a list of URIs, get a File,
    3.      * and set its permissions
    4.      */
    5.     private Uri[] mFileUris = new Uri[10];
    6.     String transferFile = "transferimage.jpg";
    7.     File extDir = getExternalFilesDir(null);
    8.     File requestFile = new File(extDir, transferFile);
    9.     requestFile.setReadable(true, false);
    10.     // Get a URI for the File and add it to the list of URIs
    11.     fileUri = Uri.fromFile(requestFile);
    12.     if (fileUri != null) {
    13.         mFileUris[0] = fileUri;
    14.     } else {