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

Huawei-HMS Core

于 2020-11-06 12:44:13 发布

阅读量576

点赞数

CC 4.0 BY-SA版权

分类专栏： HMS Core 文章标签：开发开发工具

本文链接：https://blog.youkuaiyun.com/m0_47756434/article/details/109529441

HMS Core 专栏收录该内容

13 篇文章

订阅专栏

华为NearbyService采用自研协议，让设备间免流量高速传输文件。仅需2个API即可集成，最高传输速率达60M/秒。支持蓝牙、Wi-Fi传输，无需额外流量。适用于全安卓平台。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

华为近距离通信服务（Nearby Service）使用华为自研协议，应用集成Nearby Service后，即可实现智能设备之间文件的免流量高速快传，并且集成过程简单易懂。

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

Nearby Service四大优点

•轻松集成：仅2个文件传输API，无需和复杂的网络协议打交道。

•极速传输：最高传输速率可超60M/秒，1GB文件传输仅需20秒。

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

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

Demo应用介绍（NearbyTransfer）

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

开发实战

NearbyTransfer 开源项目的Github链接：

https://github.com/HMS-Core/hms-nearby-demo/tree/master/NearbySimpleconnection

下面为您介绍如何根据源代码将这个Demo运行起来，以便于您了解实现细节。

开发准备

工具准备

两台华为手机（效果最佳）
开发工具 Android Studio(3.X or later)

注册成为开发者

注册成为华为开发者。

创建一个应用

参考Nearby Service 开发准备在华为应用市场创建一个您的应用。

构建Demo应用

◦导入源代码到Android Studio(3.X or later)

◦将华为应用市场上新建应用的agconnect-services.json文件下载到本地，并将其放在示例代码的app目录下（\app）。

运行示例应用

将Demo应用安装到测试机A,B
在测试机A上选择"Send File", 挑选需要传输的文件，生成二维码
在测试机B上选择"Receive File"
等待文件传输结束

关键代码说明

在项目级gradle里添加华为maven仓

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

buildscript {

repositories {

    maven { url 'http://developer.huawei.com/repo/'}

}    }allprojects {

repositories {

    maven { url 'http://developer.huawei.com/repo/'}

}}

在应用级的build.gradle里面加上SDK依赖

dependencies {

implementation 'com.huawei.hms:nearby:5.0.2.300'

implementation 'com.huawei.hms:scan:1.2.3.300'

}

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

因Nearby Service是基于蓝牙、Wi-Fi、存储等能力实现，这里需要声明蓝牙、Wi-Fi、存储以及位置信息权限。（待增加扫码权限）

<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是危险的系统权限，因此，您需要动态的申请这些权限。如果权限不足，Nearby Service将会拒绝为您的应用开启广播或者扫描。

关键代码

主要代码路径：com\huawei\hms\simpleNearbyDemo\MainActivity.java

如果您的应用需要集成Nearby Service传输文件，仅仅需要参考MainActivity将nearbyAgent.sendFile()和nearbyAgent.receiveFile()集成到您的应用中，即可实现扫码传文件。

发送文件
发送方选择文件后调用 nearbyAgent.sendFile(uri) 准备发送文件

@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(uri);

        }

        break;

    case NearbyAgent.REQUEST_CODE_SCAN_ONE:

        nearbyAgent.onScanResult(data);

    default:

        break;

}



super.onActivityResult(requestCode, resultCode, data);

}

2. 接收文件
接收方调用 nearbyAgent.onScanResult(data) 接收文件

recvBtn.setOnClickListener(new View.OnClickListener() {

    @Override

    public void onClick(View v) {

        nearbyAgent.receiveFile();

    }

});