[華為近距離通訊服務](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>
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"></uses-permission>
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission>
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"></uses-permission>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"></uses-permission>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>
    
    <uses-permission android:name="android.permission.CAMERA"></uses-permission>
```
由於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
作者：胡椒

教你如何整合HMS Nearby Service 實現智慧裝置間檔案的高速、免流量傳輸！

相關文章