[华为近距离通信服务](https://developer.huawei.com/consumer/en/doc/development/HMSCore-Guides-V5/introduction-0000001050040566-V5)（Nearby Service）使用华为自研协议，应用集成Nearby Service后，即可实现智能设备之间文件的免流量高速快传，并且集成过程简单易懂。

随着智能手机普及率越来越高，人们对智能手机依赖性也越来越强。常用的大多数手机应用具备文件传输功能，如：社交类应用（传图片、传文件、传聊天记录等）、文件管理应用（传文件、备份、手机克隆等）、音视频类应用（分享歌曲、视频等）。这几类应用的传输文件功能主要是借助网盘、云服务器将文件传输到另一个设备上。这类方式都需要使用用户流量或者需要在有Wi-Fi的场景下进行传输，并不具备免流量面对面传输的能力。有一些开发者可能试图尝试通过蓝牙或者Wi-Fi来实现近场数据传输，但这需要和复杂的网络协议、硬件设备打交道，且传输速度不尽人意。

## Nearby Service四大优点
- **轻松集成**：仅2个文件传输API，无需和复杂的网络协议打交道。

- **极速传输**：最高传输速率可超60MB/s，1GB文件传输仅需20秒。

- **无需联网**：无需借助路由器或其他网络设备，通过蓝牙、Wi-Fi实现数据传输，不花费用户自己的流量。

- **平台支持**：支持全安卓平台（华为设备和非华为设备），其他平台将陆续开放。

## Demo应用介绍（NearbyFileTransfer）
为了让开发者更好的了解如何集成Nearby Service，这里提供了一个扫码传文件的Demo以供参考。**NearbyFileTransfer**集成了#HMS Core# Nearby Service和Scan Kit，在两个智能设备（手机、Pad等）之间通过扫码即可完成数据传输。

## 开发实战
NearbyFileTransfer项目开源地址：[GitHub](https://github.com/HMS-Core/hms-nearby-demo/tree/master/NearbyFileTransfer)。下面为您介绍如何根据源代码将这个Demo运行起来，以便于您了解实现细节。

## 开发准备
**工具准备**

1. 两台华为手机（效果最佳）。

2. 开发工具 Android Studio(3.X或更高版本)。

**注册成为开发者**

注册成为[华为开发者](https://developer.huawei.com/consumer/cn/)。

**创建一个应用**

参考[Nearby Service 开发准备](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides-V5/development-process-0000001051068158-V5)在华为应用市场创建一个您的应用。

**构建Demo应用**

- 参考[Nearby Service 开发准备](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides-V5/android-integrating-sdk-0000001050126093-V5)将您的应用对应的agconnect-services.json文件下载到本地，并将其放在示例代码的app目录下。

- 同步工程，构建您的应用。

**运行示例应用**

1. 将Demo应用分别安装到测试机A和B。

2. 在测试机A上选择"Send File", 挑选需要传输的文件，生成二维码

3. 在测试机B上选择"Receive File"

4. 等待文件传输结束

![在这里插入图片描述](https://img-blog.csdnimg.cn/20201023161554450.gif#pic_center)

## 关键代码说明
**在项目级gradle里添加华为maven仓**

Android Studio项目级build.gradle文件，增量添加如下maven地址：

```java
buildscript {
    repositories {
        maven { url 'http://developer.huawei.com/repo/'}
    }    }allprojects {
    repositories {
        maven { url 'http://developer.huawei.com/repo/'}
    }}
```
**在应用级的build.gradle里面加上SDK依赖**

```java
dependencies {
    implementation 'com.huawei.hms:nearby:5.1.0.300'
    implementation 'com.huawei.hms:scan:1.2.3.300'
}
```
请参考Nearby Service的[版本更新说明](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides-V5/version-change-history-0000001050040574-V5)，使用最新的SDK版本。

**在AndroidManifest.xml文件里面声明系统权限**

该示例代码工程需要蓝牙、Wi-Fi、存储以及位置信息权限来实现文件传输；需要相机权限来实现扫码。

```java
    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    
    <uses-permission android:name="android.permission.CAMERA" />
```
由于ACCESS_FINE_LOCATION，WRITE_EXTERNAL_STORAGE和READ_EXTERNAL_STORAGE是危险的系统权限，因此，您需要动态的申请这些权限，详情请查看示例代码中NearbyAgent.java文件中的requestPermissions函数。

## 关键代码

文件发送和接收的关键代码在 FileMainActivity.java文件中。
如果您的应用需要集成Nearby Service传输文件，仅仅需要参考FileMainActivity.java文件调用nearbyAgent.sendFile函数和nearbyAgent.receiveFile函数，即可实现扫码传文件。

**1. 发送文件**
发送方选择文件后调用 **nearbyAgent.sendFile ** 准备发送文件

```java
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    switch (requestCode) {
        case FILE_SELECT_CODE:
            if (resultCode == RESULT_OK) {
                // Get the Uri of the selected file
                Uri uri = data.getData();
                nearbyAgent.sendFile(new File(uri.getPath()));
            }
            break;
        case NearbyAgent.REQUEST_CODE_SCAN_ONE:
            nearbyAgent.onScanResult(data);
        default:
            break;
    }
  
    super.onActivityResult(requestCode, resultCode, data);
}
```
**2. 接收文件**
接收方调用 **nearbyAgent.onScanResult(data)** 接收文件

```java
  recvBtn.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            nearbyAgent.receiveFile();
        }
    });

```
欲了解更多详情，请参阅：

•	华为开发者联盟官网：
[https://developer.huawei.com/consumer/cn/hms/huawei-nearbyservice?ha_source=hms1](https://developer.huawei.com/consumer/cn/hms/huawei-nearbyservice?ha_source=hms1)

•	获取开发指导文档：
[https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides-V5/connection-preparations-0000001050040586-V5](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides-V5/connection-preparations-0000001050040586-V5)

•	参与开发者讨论请到Reddit社区：[https://www.reddit.com/r/HuaweiDevelopers/](https://www.reddit.com/r/HuaweiDevelopers/)

•	下载demo和示例代码请到Github：[https://github.com/HMS-Core](https://github.com/HMS-Core)

•	解决集成问题请到Stack Overflow：
[https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest](https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest)

---
原文链接：https://developer.huawei.com/consumer/cn/forum/topicview?tid=0203382449995050417&fid=18
作者：胡椒

ITPub博客

教你如何集成HMS Nearby Service 实现智能设备间文件的高速、免流量传输！

最新文章