注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好。

原文链接:http://developer.android.com/training/beam-files/send-files.html


这节课将向你展示如何通过Android Beam文件传输向另一台设备发送大文件。要发送文件,首先需要申明使用NFC和外部存储的权限,你需要测试一下你的设备是否支持NFC,从而能够向Android Beam文件传输提供文件的URI。

使用Android Beam文件传输功能有下列要求:

  1. Android Beam文件传输功能只能在Android 4.1(API Level 16)及以上使用。
  2. 你希望传送的文件必须放置于外部存储。学习更多关于外部存储的知识,可以阅读:Using the External Storage
  3. 每个你希望传送的文件必须是全局可读的。你可以通过File.setReadable(true,false)来为文件设置相应的读权限。
  4. 你必须提供你要传输文件的URI。Android Beam文件传输无法处理由FileProvider.getUriForFile生成的URI。

一). 在清单文件中申明功能

首先,编辑你的清单文件来申明你应用申明的权限和功能。

需求权限

为了允许你的应用使用Android Beam文件传输使用NFC从外部存储发送文件,你必须在你的应用清单申明下面的权限:

NFC

允许你的应用通过NFC发送数据。为了指定该权限,添加下面的标签作为一个<manifest>标签的子标签:

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

READ_EXTERNAL_STORAGE

允许你的应用读取外部存储。为了指定这个权限,添加下面的标签作为一个<manifest>标签的子标签:

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

Note:

对于Android 4.2.2(API Level 17),这个权限不是必需的。在后续的系统版本中,若应用需要读取外部存储,可能会需要申明该权限。为了保证将来程序稳定性,建议在该权限申明变成必需的之前,就在清单文件中申明好。

指定NFC功能

指定你的应用使用使用NFC,添加<uses-feature>标签作为一个<manifest>标签的子标签。设置“android:required”属性字段为“true”,这样可以使得你的应用只有在NFC可以使用时,才能运行。

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

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

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

指定Android Beam文件传输

由于Android Beam文件传输只能在Android 4.1(API Level 16)及以上的平台使用,如果你的应用将Android Beam文件传输作为一个不可缺少的核心模块,那么你必须指定<uses-sdk>标签为:android:minSdkVersion="16"。或者,你可以将android:minSdkVersion设置为其它值,然后再代码中测试平台版本,这在下一节中将展开。


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

为了在你的应用清单文件中,定义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文件传输。如果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:

你也可以将Uri对象数组通过你应用的NfcAdapter实例,直接提供给NFC框架。如果你能在NFC触碰事件发生之前,定义这些URI,那么你可以选择这个方法。要学习关于这个方法的知识,可以阅读:NfcAdapter.setBeamPushUris()


三). 定义要发送的文件

为了将一个或更多个文件发送给支持NFC的设备,为每一个文件获取一个文件URI(一个具有文件架构(scheme)的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 Developers Training】 41. 向另一台设备发送文件的更多相关文章

  1. 【Android Developers Training】 40. 序言:通过NFC共享文件

    注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好. 原文链接:http://developer ...

  2. 【Android Developers Training】 42. 从另一台设备接收文件

    注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好. 原文链接:http://developer ...

  3. 【Android Developers Training】 2. 运行你的应用

    注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好. 原文链接:http://developer ...

  4. 【Android Developers Training】 96. 运行一个同步适配器

    注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好. 原文链接:http://developer ...

  5. 【Android Developers Training】 94. 创建一个空内容提供器(Content Provider)

    注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好. 原文链接:http://developer ...

  6. 【Android Developers Training】 92. 序言:使用同步适配器传输数据

    注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好. 原文链接:http://developer ...

  7. 【Android Developers Training】 91. 解决云储存冲突

    注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好. 原文链接:http://developer ...

  8. 【Android Developers Training】 9. 覆盖于布局之上的Action Bar

    注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好. 原文链接:http://developer ...

  9. 【Android Developers Training】 8. 定义Action Bar风格

    注:本文翻译自Google官方的Android Developers Training文档,译者技术一般,由于喜爱安卓而产生了翻译的念头,纯属个人兴趣爱好. 原文链接:http://developer ...

随机推荐

  1. 栈的Java简单实现

    关于栈 栈(Stack)是限定只能在一段进行插入和删除操作的线性表. 进行插入和删除操作的一端称为“栈顶”(top),另一端称为“栈底”(bottom). 栈的插入操作称为“入栈”(push),栈的删 ...

  2. FileInputStream和FileOutputStream详解

    一.引子 文件,作为常见的数据源.关于操作文件的字节流就是 FileInputStream & FileOutputStream.它们是Basic IO字节流中重要的实现类.二.FileInp ...

  3. jquery之属性操作

    jQuery之属性操作 相信属性这个词对大家都不陌生.今天我就给大家简单地介绍一下JQuery一些属性的操作 属性一共分三大类 一.基本属性 1.attr 2.removeAttr 3.prop 4. ...

  4. Charles Proxy代理使用简要说明

    1.去官网下载免费试用版: http://www.charlesproxy.com/ (需要机器有Java运行时)或下载破解注册版:http://charles.iiilab.com/,安装后开启默认 ...

  5. 同步文件的利器-rsync

    即使你只是个人用户而不是一个企业,备份你自己的数据也是非常重要的,我不想失去任何这些数据. rsync是同步文件的利器,一般用于多个机器之间的文件同步与备份,同时也支持在本地的不同目录之间互相同步文件 ...

  6. 谈一谈JDK8的函数式编程 (一)

    系列之前我想说的   最近有一段时间没写博客了,这几天回到学校,才闲下来,决定写一写最近学习到的只是,既是为了分享,也是为了巩固.之前看到过一篇调查,文章的数据是学习新知识,光是看只能获得大约5%,然 ...

  7. iOS架构设计-URL缓存

    概览 缓存组件应该说是每个客户端程序必备的核心组件,试想对于每个界面的访问都必须重新请求势必降低用户体验.但是如何处理客户端缓存貌似并没有统一的解决方案,多数开发者选择自行创建数据库直接将服务器端请求 ...

  8. 如何在vuejs中抽出公共代码

    当我们在使用vue构建中大型项目时,通常会遇到某些经常用的方法以及属性,比如说搭建一个员工管理系统,请求的url需要一个共同的前缀,或者在某几个view中需要用到时间,这个时间是通过某方法格式化之后的 ...

  9. iOS中动态注入JavaScript方法。动态给html标签添加事件

    项目中有这样一种需求,给html5网页中图片添加点击事件,并且弹出弹出点击的对应的图片,并且可以保持图片到本地 应对这样的需求你可能会想到很多方法来实现. 1. 最简单的方法就是在html5中添加图片 ...

  10. asp.net core教程 (二)

    Asp.net Core环境设置 Asp.net Core环境设置 安装Microsoft Visual Studio 2015 Asp.Net Core是Asp.Net的一个重大的重新设计. 这个话 ...