本文主要是介绍教你如何集成HMS Nearby Service 实现智能设备间文件的高速、免流量传输!,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
华为近距离通信服务(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。下面为您介绍如何根据源代码将这个Demo运行起来,以便于您了解实现细节。
开发准备
工具准备
-
两台华为手机(效果最佳)。
-
开发工具 Android Studio(3.X或更高版本)。
注册成为开发者
注册成为华为开发者。
创建一个应用
参考Nearby Service 开发准备在华为应用市场创建一个您的应用。
构建Demo应用
-
参考Nearby Service 开发准备将您的应用对应的agconnect-services.json文件下载到本地,并将其放在示例代码的app目录下。
-
同步工程,构建您的应用。
运行示例应用
-
将Demo应用分别安装到测试机A和B。
-
在测试机A上选择"Send File", 挑选需要传输的文件,生成二维码
-
在测试机B上选择"Receive File"
-
等待文件传输结束
关键代码说明
在项目级gradle里添加华为maven仓
Android Studio项目级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.1.0.300'implementation 'com.huawei.hms:scan:1.2.3.300'
}
请参考Nearby Service的版本更新说明,使用最新的SDK版本。
在AndroidManifest.xml文件里面声明系统权限
该示例代码工程需要蓝牙、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是危险的系统权限,因此,您需要动态的申请这些权限,详情请查看示例代码中NearbyAgent.java文件中的requestPermissions函数。
关键代码
文件发送和接收的关键代码在 FileMainActivity.java文件中。
如果您的应用需要集成Nearby Service传输文件,仅仅需要参考FileMainActivity.java文件调用nearbyAgent.sendFile函数和nearbyAgent.receiveFile函数,即可实现扫码传文件。
1. 发送文件
发送方选择文件后调用 **nearbyAgent.sendFile ** 准备发送文件
@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 fileUri 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) 接收文件
recvBtn.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {nearbyAgent.receiveFile();}});
欲了解更多详情,请参阅:
• 华为开发者联盟官网:
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
• 参与开发者讨论请到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
作者:胡椒
这篇关于教你如何集成HMS Nearby Service 实现智能设备间文件的高速、免流量传输!的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!