流轉(zhuǎn)在 HarmonyOS 中泛指多設(shè)備分布式操作，也是 HarmonyOS 的亮點之一。

流轉(zhuǎn)按體驗可以分為跨端遷移和多端協(xié)同，這里主要跟大家講一下如何進(jìn)行跨端遷移，以及我在項目開發(fā)過程中，所遇到的問題與解決方法。

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/hop-overview-0000001092995092

開發(fā)步驟

在開發(fā)過程中，我們可以根據(jù)業(yè)務(wù)需求分為以下兩種場景：

• 同個 FA 之間的遷移（Ability1—Ability1）

• 不同 FA 之間的遷移（Ability1—Ability2）

并且將 Ability 中實現(xiàn)的 onStartContinuation()、onSaveData（IntentParams intentParams）、onRestoreData（IntentParams intentParams）的返回值，都設(shè)為 true。

publicclassMainAbilityextendsAbilityimplementsIAbilityContinuation{

@Override
publicbooleanonStartContinuation(){
returntrue;
}

@Override
publicbooleanonSaveData(IntentParamsintentParams){
returntrue;
}

@Override
publicbooleanonRestoreData(IntentParamsintentParams){
returntrue;
}
//省略部分代碼
...
}

"reqPermissions":[
{
"name":"ohos.permission.DISTRIBUTED_DATASYNC"},
{
"name":"ohos.permission.DISTRIBUTED_DEVICE_STATE_CHANGE"},
{
"name":"ohos.permission.GET_DISTRIBUTED_DEVICE_INFO"},
{
"name":"ohos.permission.GET_BUNDLE_INFO"}
]

if(canRequestPermission(SystemPermission.DISTRIBUTED_DATASYNC)){
//是否可以申請彈框授權(quán)(首次申請或者用戶未選擇禁止且不再提示)
requestPermissionsFromUser(
newString[]{SystemPermission.DISTRIBUTED_DATASYNC},PERMISSIONS_REQUEST_DISTRIBUTED);
}

定義相關(guān)參數(shù)、設(shè)置流轉(zhuǎn)任務(wù)管理服務(wù)回調(diào)函數(shù)、注冊流轉(zhuǎn)任務(wù)管理服務(wù)、管理流轉(zhuǎn)的目標(biāo)設(shè)備，同時需要在流轉(zhuǎn)結(jié)束時解注冊流轉(zhuǎn)任務(wù)管理服務(wù)。

//流轉(zhuǎn)應(yīng)用包名
privateStringBUNDLE_NAME="XXX.XXX.XXX";
//注冊流轉(zhuǎn)任務(wù)管理服務(wù)后返回的Abilitytoken
privateintabilityToken;
//用戶在設(shè)備列表中選擇設(shè)備后返回的設(shè)備ID
privateStringselectDeviceId;
//獲取流轉(zhuǎn)任務(wù)管理服務(wù)管理類
privateIContinuationRegisterManagercontinuationRegisterManager;
//設(shè)置流轉(zhuǎn)任務(wù)管理服務(wù)設(shè)備狀態(tài)變更的回調(diào)
privateIContinuationDeviceCallbackcontinuationDeviceCallback=newIContinuationDeviceCallback(){
@Override
publicvoidonDeviceConnectDone(StringdeviceId,StringdeviceType){
selectDeviceId=deviceId;
continuationRegisterManager.updateConnectStatus(abilityToken,selectDeviceId,DeviceConnectState.CONNECTING.getState(),null);
...
}

@Override
publicvoidonDeviceDisconnectDone(Strings){
getUITaskDispatcher().asyncDispatch(()->{
continuationRegisterManager.updateConnectStatus(abilityToken,selectDeviceId,DeviceConnectState.DIS_CONNECTING.getState(),null);
});
unRegisterContinuation();
}
};
//設(shè)置注冊流轉(zhuǎn)任務(wù)管理服務(wù)回調(diào)
privateRequestCallbackrequestCallback=newRequestCallback(){
@Override
publicvoidonResult(intresult){
abilityToken=result;
}
};
...

@Override
publicvoidonStart(Intentintent){
...
continuationRegisterManager=getContinuationRegisterManager();
}

@Override
publicvoidonStop(){
super.onStop();
//解注冊流轉(zhuǎn)任務(wù)管理服務(wù)
continuationRegisterManager.unregister(abilityToken,null);
//斷開流轉(zhuǎn)任務(wù)管理服務(wù)連接
continuationRegisterManager.disconnect();
}

注冊流轉(zhuǎn)服務(wù)之后我們便可以調(diào)起系統(tǒng)流轉(zhuǎn)選擇設(shè)備彈窗，可以通過 ExtraParams 對設(shè)備進(jìn)行過濾，如不需要過濾，可不傳。

ExtraParamsparams=newExtraParams();
String[]devTypes=newString[]{ExtraParams.DEVICETYPE_SMART_PHONE,ExtraParams.DEVICETYPE_SMART_WATCH,ExtraParams.DEVICETYPE_SMART_PAD};
params.setDevType(devTypes);
registerContinuation();
//顯示選擇設(shè)備列表
continuationRegisterManager.showDeviceList(abilityToken,params,newRequestCallback(){
@Override
publicvoidonResult(intresult){
}
});

之后通過 continueAbility 方法傳入目標(biāo)設(shè)備的 DeviceID，將運行的 FA 遷移到目標(biāo)設(shè)備，實現(xiàn)業(yè)務(wù)在設(shè)備間無縫遷移。

//設(shè)置流轉(zhuǎn)任務(wù)管理服務(wù)設(shè)備狀態(tài)變更的回調(diào)
privateIContinuationDeviceCallbackcontinuationDeviceCallback=newIContinuationDeviceCallback(){
@Override
publicvoidonDeviceConnectDone(StringdeviceId,StringdeviceType){
selectDeviceId=deviceId;
getUITaskDispatcher().asyncDispatch(()->{
continuationRegisterManager.updateConnectStatus(abilityToken,selectDeviceId,DeviceConnectState.CONNECTING.getState(),null);
});
if(selectDeviceId!=null){
continueAbility(selectDeviceId);
}
...
}

@Override
publicvoidonDeviceDisconnectDone(Strings){
...
unRegisterContinuation();
}

};

主要代碼如下：

@Override
publicbooleanonSaveData(IntentParamssaveData){
//根據(jù)業(yè)務(wù)需求，在這里去設(shè)置需要傳遞的數(shù)據(jù)
saveData.setParam("continueParam",continueParam);
returntrue;
}
@Override
publicbooleanonRestoreData(IntentParamsrestoreData){
//遠(yuǎn)端FA遷移傳來的狀態(tài)數(shù)據(jù)，開發(fā)者可以按照自身業(yè)務(wù)對這些數(shù)據(jù)進(jìn)行處理
Objectdata=restoreData.getParam("continueParam");
getUITaskDispatcher().asyncDispatch(()->{

});
returntrue;
}

首先我們先在選擇設(shè)備成功后的回調(diào) IContinuationDeviceCallback 初始化分布式環(huán)境。

//設(shè)置流轉(zhuǎn)任務(wù)管理服務(wù)設(shè)備狀態(tài)變更的回調(diào)
privateIContinuationDeviceCallbackcontinuationDeviceCallback=newIContinuationDeviceCallback(){
@Override
publicvoidonDeviceConnectDone(StringdeviceId,StringdeviceType){
selectDeviceId=deviceId;
//省略部分代碼
...
try{
//初始化分布式環(huán)境
DeviceManager.initDistributedEnvironment(selectDeviceId,newIInitCallback(){
@Override
publicvoidonInitSuccess(Stringsuccess){

}

@Override
publicvoidonInitFailure(Stringfailure,intresult){
}
});
}catch(RemoteExceptione){
e.printStackTrace();
}
...
}
....
};

之前我們是通過 continueAbility() 方法進(jìn)行跳轉(zhuǎn)，而現(xiàn)在我們需要通過 Intent 方法進(jìn)行跳轉(zhuǎn)。

Intentintent=newIntent();
Operationoperation=newIntent.OperationBuilder()
.withDeviceId(deviceId)
.withBundleName(bundleName)
.withAbilityName(abilityName)
.withFlags(Intent.FLAG_ABILITYSLICE_MULTI_DEVICE)
.build();
intent.setOperation(operation);
IntentParamsintentParams=newIntentParams();
//通過IntentParams傳遞參數(shù)
...
startAbility(intent);

官方 API提供了 DeviceManager.getDeviceList() 來獲取遠(yuǎn)端設(shè)備，具體代碼如下。

publicstaticListgetDeviceList(){
//調(diào)用DeviceManager的getDeviceList接口，通過FLAG_GET_ONLINE_DEVICE標(biāo)記獲得在線設(shè)備列表
ListonlineDevices=DeviceManager.getDeviceList(DeviceInfo.FLAG_GET_ONLINE_DEVICE);
//判斷組網(wǎng)設(shè)備是否為空
if(onlineDevices==null){
LogUtil.e(TAG,"onlinedevicesisnull");
returnnewArrayList<>();
}
returnonlineDevices;
}

結(jié)語

https://harmonyos.51cto.com/posts/9013