共计 3518 个字符，预计需要花费 9 分钟才能阅读完成。
华为近距离通信服务（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/h…
上面为您介绍如何依据源代码将这个 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()集成到您的利用中，即可实现扫码传文件。
1. 发送文件
发送方抉择文件后调用 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();
}
});
欲了解更多详情，请参阅：
华为开发者联盟官网：https://developer.huawei.com/consumer/en/hms/huawei-pushkit
获取开发领导文档：
https://developer.huawei.com/consumer/en/doc/development/HMSCore-Guides/service-introduction-0000001050040060
参加开发者探讨请到 Reddit 社区：
https://www.reddit.com/r/HuaweiDevelopers/
下载 demo 和示例代码请到 Github：https://github.com/HMS-Core
解决集成问题请到 Stack Overflow：https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest
原文链接：
https://developer.huawei.com/consumer/cn/forum/topicview?tid=0203382449995050417&fid=18
作者：胡椒
