本课介绍了如何设计应用，以使用 Android Beam 文件传输功能将大型文件发送到其他设备。如需发送文件，您需要请求使用 NFC 和外部存储空间的权限，进行测试以确保您的设备支持 NFC，然后向 Android Beam 文件传输功能提供相应 URI。

使用 Android Beam 文件传输功能的要求如下：

仅 Android 4.1(API 级别 16)及更高版本支持使用 Android Beam 文件传输功能传输大型文件。

您要传输的文件必须位于外部存储空间中。如需详细了解如何使用外部存储空间，请阅读使用外部存储空间。

您要传输的每个文件都必须为全局可读文件。您可以通过调用

您必须提供待传输文件的 URI。Android Beam 文件传输功能无法处理由

在清单中声明功能

首先，修改您的应用清单，以声明您的应用所需的权限和功能。

请求权限

如需允许您的应用使用 Android Beam 文件传输功能通过 NFC 从外部存储空间发送文件，您必须在应用清单中请求以下权限：

允许您的应用通过 NFC 发送数据。如需指定此权限，请将以下元素添加为

允许您的应用从外部存储空间读取数据。如需指定此权限，请将以下元素添加为

android:name="android.permission.READ_EXTERNAL_STORAGE" />

注意：从 Android 4.2.2(API 级别 17)开始，系统不会强制执行此权限。对于要从外部存储空间读取数据的应用，该平台的未来版本可能需要此权限。为了确保向前兼容性，请立即请求此权限(在需要使用它之前)。

指定 NFC 功能

通过将 android:required 属性设置为 true，以指明您的应用只有在存在 NFC 时才会正常工作。

以下代码段展示了如何指定

android:name="android.hardware.nfc"

android:required="true" />

请注意，如果您的应用仅将 NFC 作为一个选项，但在不存在 NFC 时仍然正常工作，则应将 android:required 设置为 false，并在代码中测试 NFC。

指定 Android Beam 文件传输功能

由于仅 Android 4.1(API 级别 16)及更高版本支持 Android Beam 文件传输功能，如果您的应用将 Android Beam 文件传输作为其关键功能，则您必须指定具有

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

如需在应用清单中指定 NFC 是可选项，您可以使用以下元素：

如果您设置属性

如需在代码中测试是否支持 Android Beam 文件传输功能，请先通过调用具有

Kotlin

class MainActivity : Activity() {

...

private lateinit var nfcAdapter: NfcAdapter

// Flag to indicate that Android Beam is available

private var androidBeamAvailable = false

...

override fun onCreate(savedInstanceState: Bundle?) {

...

androidBeamAvailable = if (!packageManager.hasSystemFeature(PackageManager.FEATURE_NFC)) {

// NFC isn't available on the device

/*

* Disable NFC features here.

* For example, disable menu items or buttons that activate

* NFC-related features

*/

false

// 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.

androidBeamAvailable = false

/*

* Disable Android Beam file transfer features here.

*/

...

false

} else {

// Android Beam file transfer is available, continue

nfcAdapter = NfcAdapter.getDefaultAdapter(this)

...

true

}

}

...

}Java

public class MainActivity extends Activity {

...

NfcAdapter nfcAdapter;

// Flag to indicate that Android Beam is available

boolean androidBeamAvailable = false;

...

@Override

protected void onCreate(Bundle savedInstanceState) {

...

// NFC isn't available on the device

if (!getPackageManager().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.

androidBeamAvailable = false;

/*

* Disable Android Beam file transfer features here.

*/

...

// Android Beam file transfer is available, continue

} else {

androidBeamAvailable = true;

nfcAdapter = NfcAdapter.getDefaultAdapter(this);

...

}

}

...

}

创建可提供文件的回调方法

确认设备支持 Android Beam 文件传输功能后，添加一个回调方法，系统会在 Android Beam 文件传输功能检测到用户要将文件发送到其他支持 NFC 的设备时调用该方法。此回调方法会返回

Kotlin

public class MainActivity : Activity() {

...

// List of URIs to provide to Android Beam

private val fileUris = mutableListOf()

...

/**

* Callback that Android Beam file transfer calls to get

* files to share

*/

private inner class FileUriCallback : NfcAdapter.CreateBeamUrisCallback {

/**

* Create content URIs as needed to share with another device

*/

override fun createBeamUris(event: NfcEvent): Array {

return fileUris.toTypedArray()

}

}

...

}Java

public class MainActivity extends Activity {

...

// List of URIs to provide to Android Beam

private Uri[] fileUris = 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 fileUris;

}

}

...

}

实现该接口后，通过调用

Kotlin

class MainActivity : Activity() {

...

private lateinit var nfcAdapter: NfcAdapter

// Flag to indicate that Android Beam is available

private var androidBeamAvailable = false

...

override fun onCreate(savedInstanceState: Bundle?) {

...

// Android Beam file transfer is available, continue

nfcAdapter = NfcAdapter.getDefaultAdapter(this).apply {

/*

* Instantiate a new FileUriCallback to handle requests for

* URIs

*/

fileUriCallback = FileUriCallback()

// Set the dynamic callback for URI requests.

nfcAdapter.setBeamPushUrisCallback(fileUriCallback, this@MainActivity)

}

...

}

...

}Java

public class MainActivity extends Activity {

...

// Instance that returns available files from this app

private FileUriCallback fileUriCallback;

...

@Override

protected void onCreate(Bundle savedInstanceState) {

...

// Android Beam file transfer is available, continue

...

nfcAdapter = NfcAdapter.getDefaultAdapter(this);

/*

* Instantiate a new FileUriCallback to handle requests for

* URIs

*/

fileUriCallback = new FileUriCallback();

// Set the dynamic callback for URI requests.

nfcAdapter.setBeamPushUrisCallback(fileUriCallback,this);

...

}

...

}

注意：您还可以通过应用的

指定要发送的文件

如需将一个或多个文件传输到其他支持 NFC 的设备，请获取每个文件的 URI(架构为 file 的 URI)，然后将相应的 URI 添加到

Kotlin

/*

* Create a list of URIs, get a File,

* and set its permissions

*/

val fileUris = mutableListOf()

val transferFile = "transferimage.jpg"

val extDir = getExternalFilesDir(null)

val requestFile = File(extDir, transferFile).apply {

setReadable(true, false)

}

// Get a URI for the File and add it to the list of URIs

Uri.fromFile(requestFile)?.also { fileUri ->

fileUris += fileUri

} ?: Log.e("My Activity", "No File URI available for file.")Java

/*

* Create a list of URIs, get a File,

* and set its permissions

*/

private Uri[] fileUris = 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) {

fileUris[0] = fileUri;

} else {

Log.e("My Activity", "No File URI available for file.");

}

如需了解其他相关信息，请参阅存储选项