如何用HMS Nearby Service給自己的App添加近距離數(shù)據(jù)傳輸功能
當(dāng)你給朋友發(fā)送手機(jī)資料時(shí),過(guò)了很久進(jìn)度條卻動(dòng)也不動(dòng);當(dāng)你想發(fā)送大文件給同事時(shí),僅一個(gè)文件就用光了你所有流量;當(dāng)你跟朋友乘坐飛機(jī)時(shí)想一起玩游戲時(shí),卻因沒(méi)有網(wǎng)絡(luò)無(wú)奈放棄。

們生活中似乎經(jīng)常能遇到這種尷尬的場(chǎng)景,近距離數(shù)據(jù)傳輸功能是用戶的一個(gè)痛點(diǎn)?,F(xiàn)在,只需要接入華為近距離通信服務(wù),通過(guò)Nearby Connection便可以輕松實(shí)現(xiàn)設(shè)備間的數(shù)據(jù)傳輸,傳輸類型支持短文本、流數(shù)據(jù)和文件數(shù)據(jù)等類型,可幫助app實(shí)現(xiàn)本地多人游戲、實(shí)時(shí)協(xié)作、多屏游戲和離線文件傳輸?shù)裙δ堋O聢D是功能演示:

如果你對(duì)實(shí)現(xiàn)方式感興趣,可以在Github上下載源碼:
https://github.com/HMS-Core/hms-nearby-demo/tree/master/NearbyConnection
首先需要了解Nearby Connection 開(kāi)發(fā)流程

1. 業(yè)務(wù)流程
整體流程可以劃分為4個(gè)階段。
廣播掃描階段:廣播端啟動(dòng)廣播,發(fā)現(xiàn)端啟動(dòng)掃描以發(fā)現(xiàn)廣播端。
- 廣播端調(diào)用startBroadcasting()啟動(dòng)廣播。
- 發(fā)現(xiàn)端調(diào)用startScan()啟動(dòng)掃描以發(fā)現(xiàn)附近的設(shè)備。
- 由onFound()方法通知掃描結(jié)果。
建立連接階段:發(fā)現(xiàn)端發(fā)起連接并啟動(dòng)對(duì)稱的身份驗(yàn)證流程,雙端獨(dú)立接受或拒絕連接請(qǐng)求。
- 發(fā)現(xiàn)端調(diào)用requestConnect()向廣播端發(fā)起連接請(qǐng)求。
- 兩端由onEstablish()通知連接啟動(dòng)后,均可以調(diào)用acceptConnect()接受連接或調(diào)用rejectConnect()拒絕連接。
- 兩端由onResult()通知連接結(jié)果。僅當(dāng)兩端都接受連接時(shí),連接才能建立。
傳輸數(shù)據(jù)階段:建立連接后,雙端進(jìn)行數(shù)據(jù)交換。
- 連接建立后,雙端均可以調(diào)用sendData()發(fā)送數(shù)據(jù)給對(duì)端。
- 接收數(shù)據(jù)的一端由onReceived()通知接收到數(shù)據(jù);兩端由onTransferUpdate()通知當(dāng)前的傳輸狀態(tài)。
斷開(kāi)連接階段:雙端任意一端發(fā)起斷開(kāi)連接,通知對(duì)端連接斷開(kāi)。
- 主動(dòng)斷開(kāi)連接的一端調(diào)用disconnect()斷開(kāi)連接,對(duì)端由onDisconnected()通知連接斷開(kāi)。
2. 開(kāi)發(fā)步驟
2.1 開(kāi)發(fā)準(zhǔn)備
如果你以前沒(méi)有集成華為移動(dòng)服務(wù)的經(jīng)驗(yàn),那么需要先配置AppGallery Connect,開(kāi)通近距離通信服務(wù)并集成HMS SDK。相關(guān)步驟請(qǐng)參考官方文檔。
2.2 聲明系統(tǒng)權(quán)限
Nearby Connection開(kāi)發(fā)場(chǎng)景需要使用Nearby Discovery API和Nearby Transfer API,你的應(yīng)用必須根據(jù)所使用的策略聲明適當(dāng)?shù)臋?quán)限。例如:使用POLICY_STAR策略開(kāi)發(fā)文件傳輸?shù)膽?yīng)用,需要添加特定的權(quán)限到AndroidManifest.xml:
<!-- Required for Nearby Discovery and Nearby Transfer --> <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" /> <!-- Required for FILE payloads --> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
由于ACCESS_FINE_LOCATION,WRITE_EXTERNAL_STORAGE和READ_EXTERNAL_STORAGE 是危險(xiǎn)的系統(tǒng)權(quán)限,因此,必須動(dòng)態(tài)的申請(qǐng)這些權(quán)限。如果權(quán)限不足,近距離通信服務(wù)(Nearby Service)將會(huì)拒絕應(yīng)用開(kāi)啟廣播或者開(kāi)啟發(fā)現(xiàn)。
2.3 選擇策略
Nearby Discovery支持3種不同的連接策略:POLICY_MESH,POLICY_STAR和POLICY_P2P??梢愿鶕?jù)應(yīng)用場(chǎng)景優(yōu)選策略。
策略選擇并創(chuàng)建BroadcastOption對(duì)象的示例代碼如下:
Policy policy = Policy.POLICY_STAR; BroadcastOption broadcastOption = new BroadcastOption.Builder().setPolicy (policy).build();
2.4 廣播和掃描
一旦授予應(yīng)用所需的權(quán)限,并為應(yīng)用選擇一個(gè)策略,就可以開(kāi)始廣播和掃描以發(fā)現(xiàn)附近的設(shè)備。
2.4.1 啟動(dòng)廣播
廣播端以選定的policy和serviceId為參數(shù),調(diào)用startBroadcasting()啟動(dòng)廣播。其中serviceId應(yīng)該唯一標(biāo)識(shí)的應(yīng)用。建議使用應(yīng)用的包名作為serviceId(例如:com.huawei.example.myapp)。示例代碼如下:
private void doStartBroadcasting() {
Policy policy = Policy.POLICY_STAR;
BroadcastOption broadcastOption = new BroadcastOption.Builder().setPolicy(policy).build();
Nearby.getDiscoveryEngine(getApplicationContext())
.startBroadcasting(name, serviceId, connectCallback, broadcastOption)
.addOnSuccessListener(
new OnSuccessListener<Void>() {
@Override
public void onSuccess(Void aVoid) {
/* We are broadcasting. */
}
})
.addOnFailureListener(
new OnFailureListener() {
@Override
public void onFailure(Exception e) {
/* Fail to start broadcasting. */
}
});
}
參數(shù)connectCallback是一個(gè)連接監(jiān)聽(tīng)回調(diào)類實(shí)例,用于通知連接狀態(tài)信息。有關(guān)ConnectCallback類的詳細(xì)信息及示例代碼,參見(jiàn)確認(rèn)連接章節(jié)。
2.4.2 啟動(dòng)掃描
發(fā)現(xiàn)端以選定的policy和serviceId為參數(shù),調(diào)用startScan()啟動(dòng)掃描以發(fā)現(xiàn)附近的設(shè)備。示例代碼如下:
private void doStartScan() {
Policy policy = Policy.POLICY_STAR;
ScanOption scanOption = new ScanOption.Builder().setPolicy(policy).build();
Nearby.getDiscoveryEngine(getApplicationContext())
.startScan(serviceId, scanEndpointCallback, scanOption)
.addOnSuccessListener(
new OnSuccessListener<Void>() {
@Override
public void onSuccess(Void aVoid) {
/* Start scan success. */
}
})
.addOnFailureListener(
new OnFailureListener() {
@Override
public void onFailure(Exception e) {
/* Fail to start scan. */
}
});
}
參數(shù)scanEndpointCallback是一個(gè)掃描監(jiān)聽(tīng)回調(diào)類實(shí)例,通知發(fā)現(xiàn)端掃描結(jié)果,發(fā)現(xiàn)設(shè)備或者已發(fā)現(xiàn)設(shè)備丟失。
private ScanEndpointCallback scanEndpointCallback =
new ScanEndpointCallback() {
@Override
public void onFound(String endpointId, ScanEndpointInfo discoveryEndpointInfo) {
mEndpointId = endpointId;
mDiscoveryEngine.requestConnect(myNameStr, mEndpointId, mConnCb);
}
@Override
public void onLost(String endpointId) {
Log.d(TAG, "Nearby Connection Demo app: Lost endpoint: " + endpointId);
}
};
2.4.3 停止廣播
當(dāng)需要停止廣播時(shí),調(diào)用stopBroadcasting()。停止廣播后,廣播端不可以接收來(lái)自發(fā)現(xiàn)端的連接請(qǐng)求。
2.4.4 停止掃描
當(dāng)需要停止掃描時(shí),調(diào)用stopScan()。停止掃描后,發(fā)現(xiàn)端仍可以向已發(fā)現(xiàn)的設(shè)備請(qǐng)求連接。一種常見(jiàn)的做法是:一旦發(fā)現(xiàn)需要連接的設(shè)備,就調(diào)用stopScan()停止掃描。
2.5 建立連接
2.5.1 請(qǐng)求連接
當(dāng)附近的設(shè)備被發(fā)現(xiàn),發(fā)現(xiàn)端可以調(diào)用requestConnect()發(fā)起連接。示例代碼如下:
private void doStartConnect(String name, String endpointId) throws RemoteException {
Nearby.getDiscoveryEngine(getApplicationContext())
.requestConnect(name, endpointId, connectCallback)
.addOnSuccessListener(
new OnSuccessListener<Void>() {
@Override
public void onSuccess(Void aVoid) {
/* Request success. */
}
})
.addOnFailureListener(
new OnFailureListener() {
@Override
public void onFailure(Exception e) {
/* Fail to request connect. */
}
});
}
當(dāng)然,根據(jù)需要,可以向用戶展示發(fā)現(xiàn)的設(shè)備列表,并允許他們選擇連接哪些設(shè)備。
2.5.2 確認(rèn)連接
發(fā)現(xiàn)端發(fā)起連接后,通過(guò)回調(diào)connectCallback的onEstablish()方法將連接建立事件通知給雙方。雙方必須通過(guò)調(diào)用acceptConnect()接受連接或者通過(guò)調(diào)用rejectConnect()拒絕連接。僅當(dāng)雙方都接受連接時(shí),連接才會(huì)建立成功。如果一方或雙方都選擇拒絕,則連接失敗。無(wú)論哪種方式,連接結(jié)果都會(huì)通過(guò)onResult()方法通知。示例代碼如下:
private final ConnectCallback connectCallback =
new ConnectCallback() {
@Override
public void onEstablish(String endpointId, ConnectInfo connectInfo) {
/* Accept the connection request without notifying user. */
Nearby.getDiscoveryEngine(getApplicationContext())
.acceptConnect(endpointId, dataCallback);
}
@Override
public void onResult(String endpointId, ConnectResult result) {
switch (result.getStatus().getStatusCode()) {
case StatusCode.STATUS_SUCCESS:
/* The connection was established successfully, we can exchange data. */
break;
case StatusCode.STATUS_CONNECT_REJECTED:
/* The Connection was rejected. */
break;
default:
/* other unknown status code. */
}
}
@Override
public void onDisconnected(String endpointId) {
/* The connection was disconneted. */
}
};
此示例顯示了一種雙方自動(dòng)接受連接的確認(rèn)連接方式。根據(jù)需要,可以使用其他的確認(rèn)連接方式。
2.5.3 驗(yàn)證連接
應(yīng)用程序可以提供一種讓用戶確認(rèn)連接到指定設(shè)備的方法,例如:通過(guò)驗(yàn)證token(token可以是一個(gè)短隨機(jī)字符串或者數(shù)字)。通常這涉及在兩個(gè)設(shè)備上顯示token并要求用戶手動(dòng)輸入或者確認(rèn),類似于藍(lán)牙配對(duì)對(duì)話框。
下面演示一種通過(guò)彈窗確認(rèn)配對(duì)碼的方式驗(yàn)證連接。示例代碼如下:
@Override
public void onEstablish(String endpointId, ConnectInfo connectInfo) {
AlertDialog.Builder builder = new AlertDialog.Builder(getApplicationContext());
builder.setTitle(connectInfo.getEndpointName() + " request connection")
.setMessage("Please confirm the match code is: " + connectInfo.getAuthCode())
.setPositiveButton(
"Accept",
(DialogInterface dialog, int which) ->
/* Accept the connection. */
Nearby.getDiscoveryEngine(getApplicationContext())
.acceptConnect(endpointId, dataCallback))
.setNegativeButton(
"Reject",
(DialogInterface dialog, int which) ->
/* Reject the connection. */
Nearby.getDiscoveryEngine(getApplicationContext())
.rejectConnect(endpointId))
.setIcon(android.R.drawable.ic_dialog_alert);
AlertDialog alert = builder.create();
alert.show();
}
2.6 傳輸數(shù)據(jù)
設(shè)備間建立連接后,可以使用該連接傳輸Data對(duì)象。Data對(duì)象的類型包括字節(jié)序列、文件和流。通過(guò)調(diào)用sendData()方法發(fā)送數(shù)據(jù),通過(guò)DataCallback類實(shí)例的onReceived()方法接收數(shù)據(jù)。
2.6.1 數(shù)據(jù)類型
1.BYTES
通過(guò)調(diào)用Data.fromBytes()創(chuàng)建Data.Type.BYTES類型的Data對(duì)象。
發(fā)送BYTES類型的數(shù)據(jù),示例代碼如下:
Data bytesData = Data.fromBytes(new byte[] {0xA, 0xA, 0xA, 0xA, 0xA});
Nearby.getTransferEngine(getApplicationContext()).sendData(toEndpointId, bytesData);
注意:BYTES類型數(shù)據(jù)的長(zhǎng)度大小不能超過(guò)32KB。
接收BYTES類型的數(shù)據(jù),示例代碼如下:
static class BytesDataReceiver extends DataCallback {
@Override
public void onReceived(String endpointId, Data data) {
/* BYTES data is sent as a single block, so we can get complete data. */
if (data.getType() == Data.Type.BYTES) {
byte[] receivedBytes = data.asBytes();
}
}
@Override
public void onTransferUpdate(String endpointId, TransferStateUpdate update) {
/* We will receive TRANSFER_STATE_SUCCESS update after onReceived() called. */
}
}
注意:BYTES與FILE和STREAM類型不同,BYTES是以單個(gè)數(shù)據(jù)塊發(fā)送的,因此接收端不用等待BYTES類型的狀態(tài)更新為T(mén)RANSFER_STATE_SUCCESS,當(dāng)onReceived()被調(diào)用時(shí)候,你就可以調(diào)用data.asBytes()以獲取全部數(shù)據(jù)。
2.FILE
通過(guò)調(diào)用Data.fromFile()創(chuàng)建Data.Type.FILE類型的Data對(duì)象。
發(fā)送FILE類型數(shù)據(jù)的示例代碼如下:
File fileToSend = new File(getApplicationContext().getFilesDir(), "fileSample.txt");
try {
Data fileData = Data.fromFile(fileToSend);
Nearby.getTransferEngine(getApplicationContext())
.sendData(endpointList, fileData);
} catch (FileNotFoundException e) {
/* Exception handle. */
}
一種更高效方法是使用ParcelFileDescriptor創(chuàng)建FILE類型,可以最大程度地減少文件的復(fù)制。示例代碼如下:
ParcelFileDescriptor pfd = getContentResolver().openFileDescriptor(uri, "r"); Data fileData = Data.fromFile(pfd);
接收設(shè)備收到文件后,文件保存在Download目錄,并且將以fileData.getId()轉(zhuǎn)化后的字符串命名。傳輸完成后,可以獲取FILE對(duì)象。示例代碼如下:
/* We can get the received file in the Download folder. */ File payloadFile = fileData.asFile().asJavaFile(); )
3.STREAM
通過(guò)調(diào)用Data.fromStream()創(chuàng)建Data.Type.STREAM類型的Data對(duì)象。發(fā)送流的示例代碼如下:
URL url = new URL("https://developers.huawei.com");
Data streamData = Data.fromStream(url.openStream());
Nearby.getTransferEngine(getApplicationContext()).sendData(toEndpointId, streamData);
接收端,當(dāng)onTransferUpdate()回調(diào)成功時(shí),可以調(diào)用streamData.asStream().asInputStream()或者 streamData.asStream().asParcelFileDescriptor()獲取流對(duì)象。示例代碼如下:
static class StreamDataReceiver extends DataCallback {
private final HashMap<Long, Data> incomingData = new HashMap<>();
@Override
public void onTransferUpdate(String endpointId, TransferStateUpdate update) {
if (update.getStatus() == TransferStateUpdate.Status.TRANSFER_STATE_SUCCESS) {
Data data = incomingData.get(update.getDataId());
InputStream inputStream = data.asStream().asInputStream();
/* Further processing... */
}
}
@Override
public void onReceived(String endpointId, Data data) {
incomingData.put(data.getId(), data);
}
}
2.6.2 進(jìn)度更新
DataCallBack回調(diào)類onTransferUpdate()方法提供數(shù)據(jù)發(fā)送或接收的進(jìn)度更新,基于此可以向用戶顯示傳輸進(jìn)度,例如:進(jìn)度條。
2.6.3 取消傳輸
如果需要在接收或發(fā)送過(guò)程中取消傳輸,調(diào)用TransferEngine類實(shí)例方法cancelDataTransfer()。
2.7 斷開(kāi)連接
如果需要斷開(kāi)與對(duì)端的連接,調(diào)用DiscoveryEngine類實(shí)例方法disconnect()。一旦調(diào)用此接口,將不能從此endpoint收發(fā)數(shù)據(jù)。
結(jié)后語(yǔ)
基于Nearby Connection, 可以幫助你的APP實(shí)現(xiàn)如下相關(guān)功能:
本地多人游戲:自組網(wǎng),提供低延時(shí)、穩(wěn)定可靠的傳輸體驗(yàn)。離線文件傳輸:無(wú)需流量,可達(dá)80MB/S的傳輸速度。
更詳細(xì)的開(kāi)發(fā)指南參考華為開(kāi)發(fā)者聯(lián)盟官網(wǎng):https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/introduction-0000001050040566
到此這篇關(guān)于如何用HMS Nearby Service給自己的App添加近距離數(shù)據(jù)傳輸功能的文章就介紹到這了,更多相關(guān)HMS Nearby Service App數(shù)據(jù)傳輸內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Android Service中使用Toast無(wú)法正常顯示問(wèn)題的解決方法
這篇文章主要介紹了Android Service中使用Toast無(wú)法正常顯示問(wèn)題的解決方法,分析了Service中Toast無(wú)法正常顯示的原因與相關(guān)的解決方法,具有一定參考借鑒價(jià)值,需要的朋友可以參考下2016-10-10
android實(shí)現(xiàn)widget時(shí)鐘示例分享
這篇文章主要介紹了android實(shí)現(xiàn)widget時(shí)鐘示例,需要的朋友可以參考下2014-03-03
詳解android使用ItemDecoration 懸浮導(dǎo)航欄效果
本篇文章主要介紹了Android 最流行的吸頂效果的實(shí)現(xiàn)及代碼,非常具有實(shí)用價(jià)值,需要的朋友可以參考下。2017-01-01
Android巧用Fragment解耦onActivityResult詳解
這篇文章主要給大家介紹了關(guān)于Android巧用Fragment解耦onActivityResult的相關(guān)資料,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2018-08-08
Android自定義多節(jié)點(diǎn)進(jìn)度條顯示的實(shí)現(xiàn)代碼(附源碼)
這篇文章主要介紹了Android自定義多節(jié)點(diǎn)進(jìn)度條顯示的實(shí)現(xiàn)代碼,非常不錯(cuò),具有參考借鑒價(jià)值,需要的朋友可以參考下2017-03-03
解析Android中Animation動(dòng)畫(huà)的編寫(xiě)要點(diǎn)
這篇文章主要介紹了Android中Animation動(dòng)畫(huà)的編寫(xiě)要點(diǎn),講解了Animation的幾個(gè)常用標(biāo)簽的用法,需要的朋友可以參考下2016-04-04
詳解 Kotlin Reference Basic Types, String, Array and Imports
這篇文章主要介紹了詳解 Kotlin Reference Basic Types, String, Array and Imports的相關(guān)資料,需要的朋友可以參考下2017-06-06

