通過(guò)Android發(fā)送文件給其他設(shè)備

編寫:jdneo - 原文:http://developer.android.com/training/beam-files/sending-files.html

這節(jié)課將展示如何通過(guò)Android Beam文件傳輸向另一臺(tái)設(shè)備發(fā)送大文件。要發(fā)送文件，首先應(yīng)聲明使用NFC和外部存儲(chǔ)的權(quán)限，我們需要測(cè)試一下自己的設(shè)備是否支持NFC，這樣才能夠?qū)⑽募腢RI提供給Android Beam文件傳輸。

使用Android Beam文件傳輸功能必須滿足以下要求：

1. Android Beam文件傳輸功能傳輸大文件必須在Android 4.1（API Level 16）及以上版本的Android系統(tǒng)中使用。
2. 希望傳送的文件必須放置于外部存儲(chǔ)。更多關(guān)于外部存儲(chǔ)的知識(shí)，請(qǐng)參考：Using the External Storage。
3. 希望傳送的文件必須是全局可讀的。我們可以通過(guò)File.setReadable(true,false)來(lái)為文件設(shè)置相應(yīng)的讀權(quán)限。
4. 必須提供待傳輸文件的File URI。Android Beam文件傳輸無(wú)法處理由FileProvider.getUriForFile生成的Content URI。

在清單文件中聲明

首先，編輯Manifest清單文件來(lái)聲明應(yīng)用程序所需要的權(quán)限和功能。

聲明權(quán)限

為了允許應(yīng)用程序使用Android Beam文件傳輸控制NFC從外部存儲(chǔ)發(fā)送文件，必須在應(yīng)用程序的Manifest清單文件中聲明下面的權(quán)限：

NFC

允許應(yīng)用程序通過(guò)NFC發(fā)送數(shù)據(jù)。為聲明該權(quán)限，要添加下面的標(biāo)簽作為一個(gè)<manifest>標(biāo)簽的子標(biāo)簽：

<uses-permission android:name="android.permission.NFC" />

READ_EXTERNAL_STORAGE

允許應(yīng)用讀取外部存儲(chǔ)。為聲明該權(quán)限，要添加下面的標(biāo)簽作為一個(gè)<manifest>標(biāo)簽的子標(biāo)簽：

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

Note：對(duì)于Android 4.2.2（API Level 17）及之前版本的系統(tǒng)，這個(gè)權(quán)限不是必需的。在后續(xù)版本的系統(tǒng)中，若應(yīng)用程序需要讀取外部存儲(chǔ)，可能會(huì)需要申明該權(quán)限。為保證將來(lái)程序穩(wěn)定性，建議在該權(quán)限申明變成必需的之前，先在清單文件中聲明。

指定NFC功能

通過(guò)添加<uses-feature>標(biāo)簽作為一個(gè)<manifest>標(biāo)簽的子標(biāo)簽，指定我們的應(yīng)用程序使用NFC。設(shè)置android:required屬性字段為true，使得我們的應(yīng)用程序只有在NFC可以使用時(shí)才能運(yùn)行。

下面的代碼展示了如何指定<uses-feature>標(biāo)簽：

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

注意，如果應(yīng)用程序?qū)FC作為一個(gè)可選的功能，期望在NFC不可使用時(shí)程序還能繼續(xù)執(zhí)行，我們就應(yīng)該將android:required屬性字段設(shè)為false，然后在代碼中測(cè)試NFC的可用性。

指定Android Beam文件傳輸

由于Android Beam文件傳輸只能在Android 4.1（API Level 16）及以上的平臺(tái)使用，如果應(yīng)用將Android Beam文件傳輸作為一個(gè)不可缺少的核心模塊，那么我們必須指定<uses-sdk>標(biāo)簽為：android:minSdkVersion="16"?；蛘呖梢詫?a rel="external nofollow" target="_blank" rel="external nofollow" target="_blank" target="_blank">android:minSdkVersion設(shè)置為其它值，然后在代碼中測(cè)試平臺(tái)版本，這部分內(nèi)容將在下一節(jié)中展開(kāi)。

測(cè)試設(shè)備是否支持Android Beam文件傳輸

應(yīng)使用以下標(biāo)簽使得在Manifest清單文件中指定NFC是可選的：

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

如果設(shè)置了android:required="false"，則我們必須在代碼中測(cè)試設(shè)備是否支持NFC和Android Beam文件傳輸。

為在代碼中測(cè)試是否支持Android Beam文件傳輸，我們先通過(guò)PackageManager.hasSystemFeature()和參數(shù)FEATURE_NFC測(cè)試設(shè)備是否支持NFC。下一步，通過(guò)SDK_INT的值測(cè)試系統(tǒng)版本是否支持Android Beam文件傳輸。如果設(shè)備支持Android Beam文件傳輸，那么獲得一個(gè)NFC控制器的實(shí)例，它能允許我們與NFC硬件進(jìn)行通信，如下所示：

public class MainActivity extends Activity {
    ...
    NfcAdapter mNfcAdapter;
    // Flag to indicate that Android Beam is available
    boolean mAndroidBeamAvailable  = false;
    ...
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        ...
        // NFC isn't available on the device
        if (!PackageManager.hasSystemFeature(PackageManager.FEATURE_NFC)) {
            /*
             * Disable NFC features here.
             * For example, disable menu items or buttons that activate
             * NFC-related features
             */
            ...
        // Android Beam file transfer isn't supported
        } else if (Build.VERSION.SDK_INT <
                Build.VERSION_CODES.JELLY_BEAN_MR1) {
            // If Android Beam isn't available, don't continue.
            mAndroidBeamAvailable = false;
            /*
             * Disable Android Beam file transfer features here.
             */
            ...
        // Android Beam file transfer is available, continue
        } else {
        mNfcAdapter = NfcAdapter.getDefaultAdapter(this);
        ...
        }
    }
    ...
}

創(chuàng)建一個(gè)提供文件的回調(diào)函數(shù)

一旦確認(rèn)了設(shè)備支持Android Beam文件傳輸，那么可以添加一個(gè)回調(diào)函數(shù)，當(dāng)Android Beam文件傳輸監(jiān)測(cè)到用戶希望向另一個(gè)支持NFC的設(shè)備發(fā)送文件時(shí)，系統(tǒng)就會(huì)調(diào)用該函數(shù)。在該回調(diào)函數(shù)中，返回一個(gè)Uri對(duì)象數(shù)組，Android Beam文件傳輸會(huì)將URI對(duì)應(yīng)的文件拷貝給要接收這些文件的設(shè)備。

要添加這個(gè)回調(diào)函數(shù)，需要實(shí)現(xiàn)NfcAdapter.CreateBeamUrisCallback接口，和它的方法：createBeamUris()，下面是一個(gè)例子：

public class MainActivity extends Activity {
    ...
    // List of URIs to provide to Android Beam
    private Uri[] mFileUris = new Uri[10];
    ...
    /**
     * Callback that Android Beam file transfer calls to get
     * files to share
     */
    private class FileUriCallback implements
            NfcAdapter.CreateBeamUrisCallback {
        public FileUriCallback() {
        }
        /**
         * Create content URIs as needed to share with another device
         */
        @Override
        public Uri[] createBeamUris(NfcEvent event) {
            return mFileUris;
        }
    }
    ...
}

一旦實(shí)現(xiàn)了這個(gè)接口，通過(guò)調(diào)用setBeamPushUrisCallback()將回調(diào)函數(shù)提供給Android Beam文件傳輸。下面是一個(gè)例子：

public class MainActivity extends Activity {
    ...
    // Instance that returns available files from this app
    private FileUriCallback mFileUriCallback;
    ...
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        ...
        // Android Beam file transfer is available, continue
        ...
        mNfcAdapter = NfcAdapter.getDefaultAdapter(this);
        /*
         * Instantiate a new FileUriCallback to handle requests for
         * URIs
         */
        mFileUriCallback = new FileUriCallback();
        // Set the dynamic callback for URI requests.
        mNfcAdapter.setBeamPushUrisCallback(mFileUriCallback,this);
        ...
    }
    ...
}

Note：我們也可以將Uri對(duì)象數(shù)組通過(guò)應(yīng)用程序的NfcAdapter實(shí)例，直接提供給NFC框架。如果能在NFC觸碰事件發(fā)生之前，定義這些URI，那么可以選擇使用這個(gè)方法。更多關(guān)于這個(gè)方法的知識(shí)，請(qǐng)參考：NfcAdapter.setBeamPushUris()。

指定要發(fā)送的文件

為了將一或多個(gè)文件發(fā)送給其他支持NFC的設(shè)備，需要為每一個(gè)文件獲取一個(gè)File URI（一個(gè)具有文件格式（file scheme）的URI），然后將它們添加至一個(gè)Uri對(duì)象數(shù)組中。此外，要傳輸一個(gè)文件，我們必須也擁有該文件的讀權(quán)限。下例展示了如何根據(jù)文件名獲取其File URI，然后將URI添加至數(shù)組當(dāng)中：

    /*
     * Create a list of URIs, get a File,
     * and set its permissions
     */
    private Uri[] mFileUris = new Uri[10];
    String transferFile = "transferimage.jpg";
    File extDir = getExternalFilesDir(null);
    File requestFile = new File(extDir, transferFile);
    requestFile.setReadable(true, false);
    // Get a URI for the File and add it to the list of URIs
    fileUri = Uri.fromFile(requestFile);
    if (fileUri != null) {
        mFileUris[0] = fileUri;
    } else {
        Log.e("My Activity", "No File URI available for file.");
    }