devbox
IT小白
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

HarmonyOS学习路之开发篇—流转（跨端迁移 二）_harmonyos 跨设备迁移

作者：IT小白 | 2024-02-21 14:58:51

赞

踩

harmonyos 跨设备迁移

开发步骤

完成环境搭建，在DevEco Studio中，选择手机设备，Empty Feature Ability(Java)模板创建项目，在项目自动创建的MainAbility中实现IAbilityContinuation接口。

  1. public class MainAbility extends Ability implements IAbilityContinuation {
  2.     private static final int DOMAIN_ID = 0xD001100;   
  3.     private static final HiLogLabel LABEL_LOG = new HiLogLabel(3, DOMAIN_ID, "MainAbility");
  4.  
  5.     @Override
  6.     public void onStart(Intent intent) {
  7.         super.onStart(intent);
  8.         super.setMainRoute(MainAbilitySlice.class.getName());
  9.     }
  10.  
  11.     // 为了方便演示，不在Ability实现流转逻辑，具体逻辑在AbilitySlice中实现
  12.     @Override
  13.     public boolean onStartContinuation() {
  14.         HiLog.info(LABEL_LOG, "onStartContinuation called");
  15.         return true;
  16.     }
  17.  
  18.     @Override
  19.     public boolean onSaveData(IntentParams saveData) {
  20.         HiLog.info(LABEL_LOG, "onSaveData called");
  21.         return true;
  22.     }
  23.  
  24.     @Override
  25.     public boolean onRestoreData(IntentParams restoreData) {
  26.         HiLog.info(LABEL_LOG, "onRestoreData called");
  27.         return true;
  28.     }
  29.  
  30.     @Override
  31.     public void onCompleteContinuation(int result) {
  32.         HiLog.info(LABEL_LOG, "onCompleteContinuation called");
  33.     }
  34.  
  35.     @Override
  36.     public void onFailedContinuation(int errorCode) {
  37.         HiLog.info(LABEL_LOG, "onFailedContinuation called");
  38.     }
  39. }

在AbilitySlice中实现一个用于控制基础功能的页面，以下演示代码逻辑都将在AbilitySlice中实现，代码示例如下：

  1. public class MainAbilitySlice extends AbilitySlice {
  2.     @Override
  3.     public void onStart(Intent intent) {
  4.         super.onStart(intent);
  5.         // 开发者可以自行进行界面设计
  6.         // 为按钮设置统一的背景色
  7.         // 例如通过PositionLayout可以实现简单界面
  8.         PositionLayout layout = new PositionLayout(this);
  9.         LayoutConfig config = new LayoutConfig(LayoutConfig.MATCH_PARENT, LayoutConfig.MATCH_PARENT);
  10.         layout.setLayoutConfig(config);
  11.         ShapeElement buttonBg = new ShapeElement();
  12.         buttonBg.setRgbColor(new RgbColor(0, 125, 255));
  13.         super.setUIContent(layout);
  14.     }
  15.  
  16.     @Override
  17.     public void onInactive() {
  18.         super.onInactive();
  19.     }
  20.  
  21.     @Override
  22.     public void onActive() {
  23.         super.onActive();
  24.     }
  25.  
  26.     @Override
  27.     public void onBackground() {
  28.         super.onBackground();
  29.     }
  30.  
  31.     @Override
  32.     public void onForeground(Intent intent) {
  33.         super.onForeground(intent);
  34.     }
  35.  
  36.     @Override
  37.     public void onStop() {
  38.         super.onStop();
  39.     }
  40. }

在MainAbility对应的config.json中声明跨端迁移访问的权限：ohos.permission.DISTRIBUTED_DATASYNC。在config.json中的配置如下：

  1. {
  2.     "module": {
  3.         "reqPermissions": [
  4.             {
  5.                 "name": "ohos.permission.DISTRIBUTED_DATASYNC",
  6.                 "reason": "need",
  7.                 "usedScene": {
  8.                     "ability": [
  9.                         "MainAbility"
  10.                     ],
  11.                     "when": "inuse"
  12.                 }
  13.             }
  14.         ],
  15.         ...
  16.     }
  17.     ...
  18. }

此外，还需要在MainAbility的onStart()中，调用requestPermissionsFromUser()方法向用户申请权限，代码示例如下：

  1. public class MainAbility extends Ability implements IAbilityContinuation {
  2.     @Override
  3.     public void onStart(Intent intent) {
  4.         super.onStart(intent); 
  5.         // 开发者显示声明需要使用的权限
  6.         requestPermissionsFromUser(new String[]{"ohos.permission.DISTRIBUTED_DATASYNC"}, 0);
  7.         ...
  8.     }
  9.     ...
  10. }

设置流转任务管理服务回调函数，注册流转任务管理服务，管理流转的目标设备，同时需要在流转结束时解注册流转任务管理服务。

  1. public class MainAbilitySlice extends AbilitySlice {
  2.     // 流转应用包名
  3.     private String BUNDLE_NAME = "XXX.XXX.XXX"; 
  4.     // 注册流转任务管理服务后返回的Ability token
  5.     private int abilityToken; 
  6.     // 用户在设备列表中选择设备后返回的设备ID
  7.     private String selectDeviceId;
  8.     // 用户是否已发起可拉回流转流程
  9.     private boolean isReversibly = false;
  10.     // 获取流转任务管理服务管理类
  11.     private IContinuationRegisterManager continuationRegisterManager;
  12.     // 设置流转任务管理服务设备状态变更的回调
  13.     private IContinuationDeviceCallback callback = new IContinuationDeviceCallback() {
  14.         @Override
  15.         public void onConnected(ContinuationDeviceInfo deviceInfo) {
  16.             // 在用户选择设备后设置设备ID
  17.             selectDeviceId = deviceInfo.getDeviceId();
  18.  
  19.             //更新选择设备后的流转状态
  20.             continuationRegisterManager.updateConnectStatus(abilityToken, selectDeviceId, DeviceConnectState.CONNECTED.getState(), null);
  21.         }
  22.  
  23.         @Override
  24.         public void onDisconnected(String deviceId) {
  25.         }
  26.     };
  27.     // 设置注册流转任务管理服务回调
  28.     private RequestCallback requestCallback = new RequestCallback() {
  29.         @Override
  30.         public void onResult(int result) {
  31.             abilityToken = result;
  32.         }
  33.     };
  34.     ...
  35.  
  36.     @Override
  37.     public void onStart(Intent intent) {
  38.         ...
  39.         continuationRegisterManager = getContinuationRegisterManager();
  40.     }
  41.  
  42.     @Override
  43.     public void onStop() {
  44.         super.onStop();
  45.         // 解注册流转任务管理服务
  46.         continuationRegisterManager.unregister(abilityToken, null);
  47.         // 断开流转任务管理服务连接
  48.         continuationRegisterManager.disconnect();
  49.     }

为不同功能设置相应的控制按钮。

  1. // 建议开发者按照自己的界面进行按钮设计,示例代码仅供参考
  2. private static final int OFFSET_X = 100;
  3. private static final int OFFSET_Y = 100;
  4. private static final int ADD_OFFSET_Y = 150;
  5. private static final int BUTTON_WIDTH = 800;
  6. private static final int BUTTON_HEIGHT = 100;
  7. private static final int TEXT_SIZE = 50;
  8. private int offsetY = 0;
  9.  
  10. private Button createButton(String text, ShapeElement buttonBg) {
  11.     Button button = new Button(this);
  12.     button.setContentPosition(OFFSET_X, OFFSET_Y + offsetY);
  13.     offsetY += ADD_OFFSET_Y;
  14.     button.setWidth(BUTTON_WIDTH);
  15.     button.setHeight(BUTTON_HEIGHT);
  16.     button.setTextSize(TEXT_SIZE);
  17.     button.setTextColor(Color.YELLOW);
  18.     button.setText(text);
  19.     button.setBackground(buttonBg);
  20.     return button;
  21. }
  22.  
  23. // 按照顺序在PositionLayout中依次添加按钮的示例
  24. private void addComponents(PositionLayout linear, ShapeElement buttonBg) {
  25.     // 构建显示注册流转任务管理服务的按钮
  26.     Button btnRegister = createButton("register", buttonBg);
  27.     btnRegister.setClickedListener(mRegisterListener);
  28.     linear.addComponent(btnRegister);
  29.  
  30.     // 构建显示设备列表的按钮
  31.     Button btnShowDeviceList = createButton("ShowDeviceList", buttonBg);
  32.     btnShowDeviceList.setClickedListener(mShowDeviceListListener);
  33.     linear.addComponent(btnShowDeviceList);
  34.  
  35.     // 构建跨端迁移FA的按钮
  36.     Button btnContinueRemoteFA = createButton("ContinueRemoteFA", buttonBg);
  37.     btnContinueRemoteFA.setClickedListener(mContinueAbilityListener);
  38.     linear.addComponent(btnContinueRemoteFA);
  39.  
  40.     // 构建可拉回迁移FA的按钮
  41.     Button btnContinueReversibly = createButton("ContinueReversibly", buttonBg);
  42.     btnContinueReversibly.setClickedListener(mContinueReversiblyListener);
  43.     linear.addComponent(btnContinueReversibly);
  44.  
  45.     // 构建拉回FA的按钮
  46.     Button btnReverseContinue = createButton("ReverseContinuation", buttonBg);
  47.     btnReverseContinue.setClickedListener(mReverseContinueListener);
  48.     linear.addComponent(btnReverseContinue);
  49. }
  50.  
  51. @Override
  52. public void onStart(Intent intent) {
  53.     ...
  54.     //添加功能按钮布局
  55.     addComponents(layout, buttonBg);
  56.     super.setUIContent(layout);
  57. }

注册流转任务管理服务。

  1. // 注册流转任务管理服务
  2. private Component.ClickedListener mRegisterListener = new Component.ClickedListener() {
  3.     @Override
  4.     public void onClick(Component arg0) {
  5.         HiLog.info(LABEL_LOG, "register call.");
  6.         //增加过滤条件
  7.         ExtraParams params = new ExtraParams();
  8.         String[] devTypes = new String[]{ExtraParams.DEVICETYPE_SMART_PAD, ExtraParams.DEVICETYPE_SMART_PHONE};
  9.         params.setDevType(devTypes);
  10.         String jsonParams = "{'filter':{'commonFilter':{'system':{'harmonyVersion':'2.0.0'},'groupType':'1|256','curComType': 0x00030004,'faFilter':'{\"localVersionCode\":1,\"localMinCompatibleVersionCode\":2,\"targetBundleName\": \"com.xxx.yyy\"}'}},'transferScene':0,'remoteAuthenticationDescription': '拉起HiVision扫描弹框描述','remoteAuthenticationPicture':''}"; 
  11.         params.setJsonParams(jsonParams);
  12.         continuationRegisterManager.register(BUNDLE_NAME, params, callback, requestCallback);
  13.     }
  14. };

通过流转任务管理服务提供的showDeviceList()接口获取选择设备列表，用户选择设备后在IContinuationDeviceCallback回调中获取设备ID。

  1. // 显示设备列表，获取设备信息
  2. private ClickedListener mShowDeviceListListener = new ClickedListener() {
  3.     @Override
  4.     public void onClick(Component arg0) {
  5.         // 设置过滤设备类型
  6.         ExtraParams params = new ExtraParams();
  7.         String[] devTypes = new String[]{ExtraParams.DEVICETYPE_SMART_PAD, ExtraParams.DEVICETYPE_SMART_PHONE};
  8.         params.setDevType(devTypes);
  9.         String jsonParams = "{'filter':{'commonFilter':{'system':{'harmonyVersion':'2.0.0'},'groupType':'1|256','curComType': 0x00030004,'faFilter':'{\"localVersionCode\":1,\"localMinCompatibleVersionCode\":2,\"targetBundleName\": \"com.xxx.yyy\"}'}},'transferScene':0,'remoteAuthenticationDescription': '拉起HiVision扫描弹框描述','remoteAuthenticationPicture':''}";
  10.         params.setJsonParams(jsonParams);
  11.  
  12.         // 显示选择设备列表
  13.         continuationRegisterManager.showDeviceList(abilityToken, params, null);
  14.     }
  15. };

可使用两种方法实现FA的迁移。

  • 方法一：直接迁移FA，迁移后不可回迁。
  • 方法二：迁移一个支持回迁的FA，迁移后还可将FA拉回到本端。

将运行时的FA迁移到目标设备，实现业务在设备间无缝迁移。

  1. // 跨端迁移FA
  2. private ClickedListener mContinueAbilityListener = new ClickedListener() {
  3.     @Override
  4.     public void onClick(Component arg0) {
  5.         if (selectDeviceId != null) {
  6.             // 用户点击后发起迁移流程
  7.             continueAbility(selectDeviceId);
  8.         }
  9.     }
  10. };

设置一个支持回迁FA的迁移功能按钮，以及拉回该FA的功能按钮。

  1. // 设置支持回迁FA的迁移按钮
  2. private Component.ClickedListener mContinueReversiblyListener = new Component.ClickedListener() {
  3.     @Override
  4.     public void onClick(Component arg0) {
  5.         if (selectDeviceId != null) {
  6.             // 用户选择设备后实现可拉回迁移
  7.             continueAbilityReversibly(selectDeviceId);
  8.             isReversibly = true;
  9.         }
  10.     }
  11. };
  12.  
  13. // 设置拉回已迁移FA的按钮
  14. private Component.ClickedListener mReverseContinueListener = new Component.ClickedListener() {
  15.     @Override
  16.     public void onClick(Component arg0) {
  17.         // 用户拉回迁移FA
  18.         if (isReversibly) {
  19.             reverseContinueAbility();
  20.             isReversibly = false;
  21.         }
  22.     }
  23. };

FA的迁移还涉及到状态数据的传递，需要实现IAbilityContinuation接口，供开发者实现迁移过程中特定事件的管理能力，代码示例如下：

  1. public class MainAbilitySlice extends AbilitySlice implements IAbilityContinuation {
  2.     private void showMessage(String msg) {
  3.         ToastDialog toastDialog = new ToastDialog(this);
  4.         toastDialog.setText(msg);
  5.         toastDialog.show();
  6.     }
  7.  
  8.     @Override
  9.     public boolean onStartContinuation() {
  10.         showMessage("ContinueAbility Start");
  11.         return true;
  12.     }
  13.  
  14.     @Override
  15.     public boolean onSaveData(IntentParams saveData) {
  16.         String exampleData = String.valueOf(System.currentTimeMillis());
  17.         saveData.setParam("continueParam", exampleData);
  18.         return true;
  19.     }
  20.  
  21.     @Override
  22.     public boolean onRestoreData(IntentParams restoreData) {
  23.         // 远端FA迁移传来的状态数据，开发者可以按照特定的场景对这些数据进行处理
  24.         Object data = restoreData.getParam("continueParam");
  25.         return true;
  26.     }
  27.  
  28.     @Override
  29.     public void onCompleteContinuation(int result) {
  30.         // 开发者可以根据业务需要，提示用户迁移完成，关闭本端FA
  31.         showMessage("ContinueAbility Done");
  32.         if (!isReversibly) {
  33.             terminateAbility();
  34.         }
  35.     }
  36.  
  37.     @Override
  38.     public void onFailedContinuation(int errorCode) {
  39.         // 开发者可以根据业务需要，提示用户迁移失败
  40.         showMessage("ContinueAbility failed");
  41.         if (!isReversibly) {
  42.             terminateAbility();
  43.         }
  44.     }
  45. }

通过自定义迁移事件相关的行为，最终实现对FA的迁移。此处主要以较为常用的两个事件，包括迁移发起端完成迁移的回调onCompleteContinuation(int result)，以及接收到远端迁移行为传递数据的回调onRestoreData(IntentParams restoreData)。其他还包括用于本端迁移发起时保存状态数据的回调onSaveData(IntentParams saveData)和本端发起迁移的回调onStartContinuation()。按照实际应用自定义特定场景对应的回调，可以完成多种场景下FA的迁移任务。

本文内容由网友自发贡献，转载请注明出处：【wpsshop博客】
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号