华为近距离通信服务(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) 筹备发送文件
@Overridepublic 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
作者:胡椒