关于hms-core:教你如何集成HMS-Nearby-Service-实现智能设备间文件的高速免流量传输

华为近距离通信服务（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 运行起来，以便于您理解实现细节。

开发筹备

工具筹备

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

注册成为开发者

注册成为华为开发者。

创立一个利用

参考 Nearby Service 开发筹备在华为利用市场创立一个您的利用。

构建 Demo 利用

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

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

运行示例利用

1. 将 Demo 利用装置到测试机 A,B
2. 在测试机 A 上抉择 ”Send File”, 筛选须要传输的文件，生成二维码
3. 在测试机 B 上抉择 ”Receive File”
4. 期待文件传输完结

要害代码阐明

在我的项目级 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 将会回绝为您的利用开启播送或者扫描。

要害代码

次要代码门路：comhuaweihmssimpleNearbyDemoMainActivity.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/…
作者：胡椒