Android官方开发文档Training系列课程中文版:通过NFC共享文件之发送文件到另一台设备-阿里云开发者社区

开发者社区> sahadev> 正文

Android官方开发文档Training系列课程中文版:通过NFC共享文件之发送文件到另一台设备

简介: 原文地址:http://android.xsoftlab.net/training/beam-files/index.html 导言 Android允许你通过Android Beam文件传输特性在两台设备之间传送大文件。
+关注继续查看

原文地址:http://android.xsoftlab.net/training/beam-files/index.html

导言

Android允许你通过Android Beam文件传输特性在两台设备之间传送大文件。这个特性拥有一个简单的API,允许用户通过简单的设备接触来启动一个传输进程。在响应端,Android Beam文件传输系统会自动的将文件从一台设备拷贝到另一台设备上,并且会在拷贝结束时通知用户。

虽然Android Beam文件传输API可以处理大量的数据,但在Android 4.0之后,出现了Android Beam NDEF传输API,它可以用来处理少量的数据,比如URI,或者其它的小型消息。Android Beam是Android NFC框架的唯一可用特性,它可以允许你从NFC标签中读取NDEF消息。有关学习更多Android Beam的相关信息,请参见话题Beaming NDEF Messages to Other Devices。有关学习更多NFC框架的相关知识,请参见 Near Field Communication API指南。

向其它设备发送文件

这节课展示了如何设计APP通过Android Beam文件传输系统来发送一个大文件给另一台设备。为了发送文件,你需要请求权限来使用NFC以及外部存储器,测试确保你的设备支持NFC,以及提供URI给Android Beam文件传输系统。

Android Beam文件传输特性有以下要求:

  • 1.对于大文件的Android Beam文件传输只在Android 4.1及以上设备可用。
  • 2.要传输的文件必须存储于外部存储器上。有关学习更多关于使用外部存储器,请参见Using the External Storage
  • 3.每一个要传输的文件必须是全局可读。你可以通过调用File.setReadable(true,false)方法来设置这个权限。
  • 4.你必须要提供一个被传输文件的URI。Android Beam文件传输系统不可以处理由FileProvider.getUriForFile方法产生的URI。

在清单文件中声明特性

首先,需要在APP的清单文件中声明APP所需的权限以及特性。

请求权限

为了允许用户使用Android Beam文件传输系统使用NFC来发送外部存储器上的文件,你必须在清单文件中请求以下权限:

NFC

允许APP通过NFC来发送数据。为了指明该权限,需要在< manifest>元素下添加如下的子元素:

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

READ_EXTERNAL_STORAGE

允许APP读取外部存储器上的文件。为了指明该权限,在< manifest>元素下添加如下的子元素:

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

Note:在Android 4.2.2上,该权限不是强制要求的。未来的平台版本可能需要它。为了确保向后兼容的完整性,在要求它之前添上它。

指明NFC特性

通过在< manifest>元素中添加子元素< uses-feature>来指明APP要使用NFC。设置其android:required属性的值为true来指示APP不会运行,除非NFC功能出现。

下面的代码展示了如何指定< uses-feature>元素:

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

注意,如果APP只是将NFC功能作为一个选项,但是在NFC没有出现的时候还仍然可用,你应该设置android:required为false,并且在代码中测试NFC。

指明Android Beam文件传输系统

Android Beam文件传输系统只是在Android 4.1及以上的版本可用,如果APP的关键部分使用了Android Beam文件传输系统,你必须在< uses-sdk>元素中指明属性android:minSdkVersion=”16”。
否则,如果有必要的话,你可以设置android:minSdkVersion的值为其它值,并在代码中测试它的平台版本,下节将会描述这部分。

测试是否支持Android Beam文件传输

为了在APP的清单文件中指明NFC功能是可选的,你需要使用以下元素:

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

如果设置了android:required=”false”,你必须在代码中测试是否支持NFC,以及是否支持Android Beam文件传输系统。

为了在代码中测试Android Beam文件传输系统是否支持,首先需要通过PackageManager.hasSystemFeature()加参数FEATURE_NFC来判断设备是否支持NFC。接下来,通过测试SDK_INT的值来判断该平台版本是否支持Android Beam文件传输系统。如果支持的话,则可以获取NFC的控制器实例,该实例允许与NFC硬件设备进行通信:

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);
        ...
        }
    }
    ...
}

对传送的文件创建一个回调方法

一旦验证了设备支持Android Beam文件传输系统,那么需要添加一个回调方法,以便当Android Beam文件传输系统检查出用户想要发送文件给另一台NFC设备的时候系统可以调用这个方法。在这个回调方法中,需要返回一组Uri对象。Android Beam文件传输系统则会拷贝由这些Uri所指向的文件到接收端设备上。

为了添加这个回调方法,需要实现NfcAdapter.CreateBeamUrisCallback接口以及其中的方法createBeamUris()。下面这段代码展示了如何实现:

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;
        }
    }
    ...
}

一旦你实现了该接口,通过调用setBeamPushUrisCallback()方法将该回调提供给Android Beam文件传输系统。下面这段代码展示了如何完成:

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:你也可以通过APP的NfcAdapter实例直接给NFC框架提供Uri数组。如果在NFC靠近事件发生之前你可以对传输系统定义URI的话,就可以选择这种方式。有关学习更多关于这种方式的相关知识,请参见:NfcAdapter.setBeamPushUris()

指明发送的文件

为了给其它NFC设备传输文件,需要获取每个文件的URI地址,然后将地址添加到Uri对象数组中去。为了传输单个文件,你还必须拥有文件的永久读取权限。举个例子,下面这段代码展示了如何根据文件名来获取文件的URI地址,并将该URI添加到数组中:

        /*
         * 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.");
        }

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
Android官方开发文档Training系列课程中文版:OpenGL绘图之响应触摸事件
原文地址:http://android.xsoftlab.net/training/graphics/opengl/touch.html 使图形按照程序设计的轨迹旋转对OpenGL来说还是不能发挥出它应有的实力。
854 0
在silverlight中利用socket发送图片或文件
silverlight中的socket通讯支持,让sl开发基于web的聊天工具成为了可能,后来OpenFileDialog,SaveFileDialog的出现,更使得边聊天边传送图片(文件)得以实现,最新的SL4中又加入了摄像头支持,也许不久真的可以用silverlight开发出功能强大的视频聊天系统,目前唯一还没有解决的是p2p问题,根据sl3的sdk文档所述:    Socket 类为网络通信提供了一组方法和属性。
827 0
Android官方开发文档Training系列课程中文版:连接无线设备之网络服务搜索功能
原文地址:http://android.xsoftlab.net/training/connect-devices-wirelessly/index.html 引言 Android设备除了可以与服务器建立连接之外,Android无线API还允许处于同一网段下的两台设备建立连接,或者是物理距离相近的两台设备建立连接。
825 0
Android官方开发文档Training系列课程中文版:通知用户之构建通知
原文地址:http://android.xsoftlab.net/training/notify-user/index.html 引言 通知用于在有事件发生时,将事情以更便捷的方式展示给用户。
671 0
Android官方开发文档Training系列课程中文版:网络操作之网络管理
原文地址:http://android.xsoftlab.net/training/basics/network-ops/managing.html 这节课将会学习如何对网络资源的使用情况拥有更细粒度的控制力。
597 0
Android官方开发文档Training系列课程中文版:通知用户之更新或移除通知
原文地址:http://android.xsoftlab.net/training/notify-user/managing.html#Removing 当需要在不同时段发布同一事件类型的通知时,应当避免创建新的通知。
637 0
Android官方开发文档Training系列课程中文版:通知用户之创建不同导航方式的Activity
原文地址:http://android.xsoftlab.net/training/notify-user/navigation.html 设计通知时要考虑到用户所预想的导航体验。
670 0
+关注
sahadev
移动开发方向专家
183
文章
0
问答
文章排行榜
最热
最新
相关电子书
更多
《2021云上架构与运维峰会演讲合集》
立即下载
《零基础CSS入门教程》
立即下载
《零基础HTML入门教程》
立即下载