HarmonyOS学习路之开发篇—流转(多端协同 一)

这篇具有很好参考价值的文章主要介绍了HarmonyOS学习路之开发篇—流转(多端协同 一)。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

多端协同开发

场景介绍

开发者在应用FA中通过调用流转任务管理服务、分布式任务调度的接口,实现多端协同。

HarmonyOS学习路之开发篇—流转(多端协同 一),HarmonyOS 学习(java开发篇),harmonyos,学习,华为,多端协同,搜索融合

主要流程如下:

  1. 设备A上的应用FA向流转任务管理服务注册一个流转回调。
    • Alt1-系统推荐流转:系统感知周边有可用设备后,主动为用户提供可选择流转的设备信息,并在用户完成设备选择后回调onConnected通知应用FA开始流转,将用户选择的设备B的设备信息提供给应用FA。
    • Alt2-用户手动流转:系统在用户手动点击流转图标后,通过showDeviceList通知流转任务管理服务,被动为用户提供可选择交互的设备信息,并在用户完成设备选择后回调onConnected通知应用FA开始流转,将用户选择的设备B的设备信息提供给应用FA。
  2. 设备A上的应用FA需要初始化分布式任务调度能力。
  3. 设备A上的应用FA通过调用分布式任务调度的能力,向设备B的应用发起多端协同。应用FA需要自己管理流转状态,将流转状态从IDLE迁移到CONNECTING,并上报到流转任务管理服务。
  4. 开发者根据Ability模板及意图的不同,通过组合以下能力生成多端协同的业务:启动远程FA、启动远程PA、连接远程PA。这些能力都需要指定待连接设备的信息。

    下面以设备A(本地设备)和设备B(远端设备)为例,进行场景介绍:

    1. startAbility设备A启动设备B的FA:在设备A上通过本地应用提供的启动按钮,启动设备B上对应的FA。例如:设备A控制设备B打开相册,只需开发者在启动FA时指定打开相册的意图即可。
    2. startAbility设备A启动设备B的PA:在设备A上通过本地应用提供的启动按钮,启动设备B上指定的PA。例如:开发者在启动远程服务时通过意图指定音乐播放服务,即可实现设备A启动设备B音乐播放的能力。
    3. connectAbility设备A连接设备B的PA:在设备A上通过本地应用提供的连接按钮,连接设备B上指定的PA。连接后,通过其他功能相关按钮实现控制对端PA的能力。通过连接关系,开发者可以实现跨设备的同步服务调度,实现如大型计算任务互助等价值场景。
  5. 设备A上的应用FA启动或连接设备B的应用FA/PA后,应用将流转状态从CONNECTING迁移到CONNECTED,并上报到流转任务管理服务。
  6. 用户通过设备A的流转任务管理界面结束流转。用户点击结束任务后,流转任务管理服务回调onDisconnected通知应用FA取消流转。
  7. 设备A上的应用通过调用分布式任务调度的能力,终止和设备B的多端协同。
    1. disconnectAbility设备A与设备B的PA断开连接:将之前已连接的PA断开连接。
    2. stopAbility设备A关闭设备B的PA:关闭设备B上指定的PA。
  8. 应用关闭分布式任务调度能力。
  9. 应用将流转状态从CONNECTED迁移到IDLE,并上报到流转任务管理服务。
  10. 应用向流转任务管理服务注销流转回调。

接口说明

流转任务管理服务提供的注册、解注册、显示设备列表、上报业务状态是实现多端协同的前提。开发者使用分布式服务平台提供的连接和断开连接PA、启动远程FA、启动和关闭PA的能力,可实现自定义的多端协同体验。

表1 IContinuationRegisterManager接口功能介绍

接口名

描述

void register(String bundleName, ExtraParams parameter, IContinuationDeviceCallback deviceCallback, RequestCallback requestCallback)

注册并连接到流转任务管理服务,并获取对应的注册token。

参数说明:

  • bundleName,必填,String类型,本应用包名。
  • params,可选,ExtraParams类型,系统推荐流转时所需的过滤条件。如对智能推荐无特殊要求,可与showDeviceList接口的过滤条件保持一致。若需关闭系统推荐流转,ExtraParams中jsonParams传入{"isTurnOffRecommend":true}即可。
  • deviceCallback,可选,设备选择列表中选择设备后的回调,返回选择设备ID。
  • requestCallback,可选,注册请求回调,返回应用注册后的token。

ExtraParams说明:

  • devType,可选,待连接的设备类型。可取值("00E"手机、"011"平板、"06D"手表、"09C"智慧屏),如"devType":["011"]。若为空,则支持则待连接的设备类型为手机、平板、手表和智慧屏。
  • targetBundleName,可选,目标应用包名。若为空,则目标应用包名与方法入参bundleName本应用包名相同。
  • description,可选,ability描述,用于在设备列表页面展示
  • jsonParams,可选,拓展参数。用于设备过滤等。示例:

    {"filter":{"commonFilter": {"system":{"harmonyVersion":"2.0.0"},"groupType": "1","curComType": 0x00000004, "faFilter":"{\"targetBundleName\":\"com.xxx.yyy\"}"}},"transferScene":0,"isTurnOffRecommend":false,"remoteAuthenticationDescription": "拉起HiVision扫描弹框描述","remoteAuthenticationPicture":""}

jsonParams说明:

  • system:可选,String类型,待连接设备的HarmonyOS版本号,目标设备对应的harmonyVersion>=该值,如"system":{"harmonyVersion":"2.0.0"}。
  • groupType:可选,String类型。为空时,不要求是否同帐号。本设备和待连接设备的帐号是否要求一致,可取值(1要求同帐号、1|256不要求同帐号),如"groupType":"1"。
  • curComType:可选,int类型。为空时,不要求在同一局域网下。本设备和待连接设备是否需要在同一局域网下,可取值(0x00000004需要在同一局域网下,0x00030004不需要在同一局域网下),如"curComType":0x00000004。
  • faFilter:可选,String类型,目标应用包名。为空时,不做版本兼容性检查。要做版本兼容性检查时,需要传入目标应用包名。使用faFilter,设备需登录帐号。多端设备可使用不同帐号,但不支持无账号使用faFilter。
  • transferScene:可选,int类型,默认值为0。可取值为:0-单选协同场景,设备选择面板为单选面板,设备间互斥,流转成功设备面板自动消失,流转失败设备面板不消失,且系统会维护设备的流转状态,如流转成功设备面板消失后再打开设备面板,会显示之前设备流转成功的状态;1-单选迁移场景,设备选择面板为单选面板,设备间互斥,流转成功设备面板自动消失,流转失败设备面板不消失,且系统不会维护设备的流转状态,如流转成功设备面板消失后再打开设备面板,设备流转状态为未流转;2-多选协同场景,设备选择面板为多选面板,流转成功或失败设备面板不消失,设备间不互斥,系统会维护设备的流转状态。
  • isTurnOffRecommend:可选,boolean类型,默认为false,true:关闭系统推荐流转,false:开启系统推荐流转。
  • remoteAuthenticationDescription:可选,String类型,跨账号/无账号设备进行扫码认证时,拉起对端HiVision扫描弹框描述。register接口无需传该参数,showDeviceList可按需传参。
  • remoteAuthenticationPicture:可选,String类型,跨账号/无账号设备进行扫码认证时,拉起对端HiVision扫描弹框显示的图片。需将图片对应的byte[]转String, Base64.encodeToString(mBuff,Base64.DEFAULT)。register接口无需传该参数,showDeviceList可按需传参。

注册后,通过RequestCallback的onResult回调知道执行是否成功,返回值为<0时为失败;其他情况,表示成功,并返回本次流转任务的唯一标识token。

当用户选择设备后,通过deviceCallback定义的onConnected回调获取设备的deviceID、类型、名称。

void unregister(int token, RequestCallback requestCallback)

从流转任务管理服务解注册,传入注册时获取的token进行解注册。

执行后,通过RequestCallback的onResult回调知道执行是否成功。

void updateConnectStatus(int token, String deviceId, int status, RequestCallback requestCallback)

通知流转任务管理服务更新当前用户程序的连接状态,并在流转任务管理服务界面展示给用户。token、deviceId参数来自于注册流转任务管理服务的回调。status参数可以为IDLE、CONNECTING、CONNECTED、DIS_CONNECTING。如果有错误,需要上报errorCode。

执行后,通过RequestCallback的onResult回调知道执行是否成功。

void showDeviceList(int token, ExtraParams parameter, RequestCallback requestCallback)

显示组网内可选择设备列表信息。该接口提供手动显示设备列表的能力,parameter参数可以指定设备过滤的条件,用于手动多端协同,支持的过滤条件与register接口相同。token参数来自于注册流转任务管理服务的回调。

执行后,通过RequestCallback的onResult回调知道执行是否成功。

void disconnect()

在应用退出时,主动调用断开和流转任务管理服务的连接。

表2 IContinuationDeviceCallback接口功能介绍

接口名

描述

void onConnected(ContinuationDeviceInfo deviceInfo)

当用户从选择设备列表选择设备时调用,返回设备ID、设备类型和设备名称供开发者使用。

void onDisconnected(String deviceId)

当流转任务管理服务断开连接设备时调用。

表3 RequestCallback接口功能介绍

接口名

描述

void onResult(int result)

与流转任务管理服务交互成功时调用。当作为注册流转任务管理服务的回调对象时,注册成功后给用户程序返回对应的token。

表4 Ability/AbilitySlice接口功能介绍

接口名

描述

IContinuationRegisterManager getContinuationRegisterManager()

获取流转任务管理服务注册服务管理类,可以与流转任务管理服务进行交互,包括注册/解注册,更新设备连接状态,显示可选择设备列表等。

void startAbility(Intent intent)

提供启动指定设备上FA和PA的能力,Intent中指定待启动FA/PA的设备deviceId、bundleName和abilityName。若不指定设备deviceId,则无法跨设备调用PA。类似地,在启动FA时,也需要开发者指定启动FA的设备deviceId、bundleName和abilityName。

分布式服务平台还会提供与上述功能相对应的断开远程PA的连接和关闭远程PA的接口,相关的参数与连接、启动的接口类似。

boolean connectAbility(Intent intent, IAbilityConnection conn)

提供连接指定设备上PA的能力,Intent中指定待连接PA的设备deviceId、bundleName和abilityName。当连接成功后,通过在conn定义的onAbilityConnectDone回调中获取对端PA的服务代理,两者的连接关系则由conn维护。

boolean stopAbility(Intent intent)

提供关闭远程PA的能力,Intent中指定待关闭PA的设备deviceId、bundleName和abilityName。

void terminateAbility()

提供关闭当前FA/PA的能力,调用该接口将开始销毁调用的FA/PA。

void disconnectAbility​(IAbilityConnection conn)

提供断开远程PA连接能力,conn需要指定为connectAbility连接指定设备上PA时,传入的IAbilityConnection对象。

表5 IAbilityConnection接口功能介绍

接口名

描述

void onAbilityConnectDone(ElementName element, IRemoteObject remote, int resultCode)

当连接Service服务成功时调用,可使用返回的IRemoteObject对象与连接的Service服务通信。

void onAbilityDisconnectDone(ElementName element, int resultCode)

当已连接的Service服务被异常关闭时调用。

表6 DeviceManager接口功能介绍

接口名

描述

void initDistributedEnvironment(String deviceId, IInitCallBack callback)

初始化分布式服务平台。其中deviceId指明设备Id;callback指明初始化分布式环境状态回调,参考IInitCallBack接口描述。

void unInitDistributedEnvironment(String deviceId, IInitCallBack callback)

不再使用分布式服务平台。

表7 IInitCallBack接口功能介绍

接口名

描述

void onInitSuccess(String deviceId)

成功回调。

void onInitFailure(String deviceId, int errorCode)

失败回调。文章来源地址https://www.toymoban.com/news/detail-555392.html

约束与限制

  • 每个应用注册流转任务管理服务的Ability数量上限为5个,后续新增注册的Ability会将最开始注册的覆盖。
  • startAbility、connectAbility中跨设备传递的intent数据大小限制200KB以内。
  • 不支持使用connectAbility触发远端PA的免安装。
  • connectAbility中跨设备传递的remoteObject数据大小限制200KB以内。
  • 多端协同要求HarmonyOS 2.0以上版本才能支持,注册到流转任务管理服务时jsonParams中需要增加{"harmonyVersion":"2.0.0"}过滤条件。
  • stopAbility不支持两个设备之间分别登录不同的帐号,也就是要求多个设备是同帐号。

到了这里,关于HarmonyOS学习路之开发篇—流转(多端协同 一)的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • HarmonyOS学习路之开发篇—Java UI框架(TableLayout)

    TableLayout使用表格的方式划分子组件。 TableLayout的共有XML属性继承自:Component TableLayout的自有XML属性见下表: 属性名称 中文描述 取值 取值说明 使用案例 alignment_type 对齐方式 align_edges 表示TableLayout内的组件按边界对齐。 ohos:alignment_type=\\\"align_edges\\\" align_contents 表示TableLayout内的

    2024年02月09日
    浏览(29)
  • HarmonyOS学习路之开发篇—Java UI框架(PositionLayout&&AdaptiveBoxLayout)

    在PositionLayout中,子组件通过指定准确的x/y坐标值在屏幕上显示。(0, 0)为左上角;当向下或向右移动时,坐标值变大;允许组件之间互相重叠。 PositionLayout示意图 PositionLayout以坐标的形式控制组件的显示位置,允许组件相互重叠。 在layout目录下的XML文件中创建PositionLayout并添

    2024年02月09日
    浏览(26)
  • HarmonyOS学习路之开发篇—Java UI框架(自定义组件与布局 一)

    HarmonyOS提供了一套复杂且强大的Java UI框架,其中Component提供内容显示,是界面中所有组件的基类。ComponentContainer作为容器容纳Component或ComponentContainer对象,并对它们进行布局。 Java UI框架也提供了一部分Component和ComponentContainer的具体子类,即常用的组件(比如:Text、Button、

    2024年02月09日
    浏览(29)
  • HarmonyOS学习路之开发篇—Java UI框架(JS FA调用Java PA)

    使用兼容JS的类Web开发范式的方舟开发框架提供了JS FA(Feature Ability)调用Java PA(Particle Ability)的机制,该机制提供了一种通道来传递方法调用、处理数据返回以及订阅事件上。 当前提供Ability和Internal Ability两种调用方式。 Ability:拥有独立的Ability生命周期,FA使用远端进程

    2024年02月09日
    浏览(32)
  • HarmonyOS学习路之开发篇—AI功能开发(分词)

    随着信息技术的发展,网络中的信息量成几何级增长逐步成为当今社会的主要特征。准确提取文本关键信息,是搜索引擎等领域的技术基础,而分词作为文本信息提取的第一步则尤为重要。 分词作为自然语言处理领域的基础研究,衍生出各类不同的文本处理相关应用。 分词

    2024年02月11日
    浏览(40)
  • HarmonyOS学习路之开发篇—设备管理(位置开发)

    移动终端设备已经深入人们日常生活的方方面面,如查看所在城市的天气、新闻轶事、出行打车、旅行导航、运动记录。这些习以为常的活动,都离不开定位用户终端设备的位置。 当用户处于这些丰富的使用场景中时,系统的位置能力可以提供实时准确的位置数据。对于开发

    2024年02月16日
    浏览(28)
  • HarmonyOS学习路之开发篇—AI功能开发(实体识别)

    实体识别能够从自然语言中提取出具有特定意义的实体,并在此基础上完成搜索等一系列相关操作及功能。 实体识别覆盖范围大,能够满足日常开发中对实体识别的需求,让应用体验更好。识别准确率高,能够准确地提取到实体信息,对应用基于信息的后续服务形成关键影响

    2024年02月11日
    浏览(28)
  • HarmonyOS学习路之开发篇—AI功能开发(语音播报)

    语音播报(Text to Speech,下文简称TTS),基于华为智慧引擎(HUAWEI HiAI Engine)中的语音播报引擎,向开发者提供人工智能应用层API。该技术提供将文本转换为语音并进行播报的能力。 支持超长文本播报,最大文本长度为100000个字符。 语音播报不支持多线程调用。 实时语音交

    2024年02月11日
    浏览(58)
  • HarmonyOS学习路之开发篇—多媒体开发(相机开发 二)

    Camera操作类,包括相机预览、录像、拍照等功能接口。 接口名 描述 triggerSingleCapture​(FrameConfig frameConfig) 启动相机帧的单帧捕获。 triggerMultiCapture​(ListFrameConfig frameConfigs) 启动相机帧的多帧捕获。 configure​(CameraConfig config) 配置相机。 flushCaptures​() 停止并清除相机帧的捕获

    2024年02月11日
    浏览(32)
  • HarmonyOS学习路之开发篇—多媒体开发(图像开发 二)

    图像编码就是将PixelMap图像编码成不同存档格式图片,用于后续其他处理,比如保存、传输等。当前仅支持JPEG格式。 ImagePacker主要用于图像编码。 接口名 描述 create() 创建图像打包器实例。 initializePacking(byte[] data, PackingOptions opts) 初始化打包任务,将字节数组设置为打包后输

    2024年02月11日
    浏览(32)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包