HarmonyOS7 分布式流转:手机到平板无缝接续案例 文章目录前言流转 vs 同步别搞混流转能做什么实现思路以页面流转为例代码实现核心代码完整示例关键点总结常见误区小白必踩完整可运行示例分布式流转代码解析写在最后前言“我在手机上看视频躺到沙发上拿起平板视频自动续上”——这种跨设备接续就是分布式流转Continuation。上篇文章讲了数据同步原理这篇直接上一个可感知的实战案例把手机上正在看的页面一键流转到平板继续。重点讲清楚流转和数据同步的区别以及怎么实现。流转 vs 同步别搞混概念含义例子数据同步数据在多处都存在备忘录多端可见流转接续任务从 A 设备搬到 B 设备手机看视频→平板接着看流转的核心是当前任务状态迁移到另一台设备原设备退出。不是复制是搬家。流转能做什么典型场景视频/音乐播放位置接续导航从手机转到车机文档编辑从手机转到平板游戏从手机转到智慧屏本质是把当前的页面 状态交给另一台设备重建。实现思路以页面流转为例流转 API 围绕continuationManager流转管理展开。核心三步第一步注册可流转能力在 Ability 里声明自己支持流转并注册回调代码实现import{continuationManager}fromkit.DeviceAwarenessKit// 在 Ability 的 onContinue 里把要带走的状态打包onContinue(wantParam:Recordstring,Object){// 把当前播放进度、页面参数写进 wantParamwantParam[playPosition]this.currentPosition wantParam[videoId]this.videoIdreturn{resultCode:0,wantParam}}onContinue在流转发起时被调你往wantParam里塞需要带走的状态如播放进度。这一步等于告诉系统“要搬走的话带上这些状态”。第二步发起流转选设备核心代码continuationManager.startContinuationDeviceChooser(getContext(),// 用户选了目标设备后的回调(deviceId:string){console.info(用户选择流转到设备deviceId)})系统弹出可选设备列表同账号互信设备。用户选一个触发流转。第三步目标设备重建目标设备的同名 Ability 收到wantParam在onCreate/onNewWant里取出状态恢复界面完整示例onNewWant(want:Want){constposwant.parameters?.[playPosition]asnumberthis.currentPositionpos// 用传来的进度续播this.startPlayFrom(pos)}关键点总结流转 “状态打包带走 目标重建”不是简单同步。必须同一账号 互信设备否则选不到设备。要带走的只有必要状态进度、ID别把整个大对象塞进去。原设备流转后通常要主动finish()退出避免两端同时跑。常见误区小白必踩误区说明把流转当同步流转是任务搬家原设备退出、目标重建不是数据多端共存两码事。不带必要状态只带videoId不带playPosition目标设备没法续播。原设备不finish()流转后两端同时跑应该原设备退出。选不到设备检查是否同账号、已互信。下面这段代码可以直接复制到 DevEco Studio 里运行。建议你边读边敲改一改文末「动手改一改」里的参数亲眼看看效果。完整可运行示例分布式流转把正在看的页面「流转」到平板继续。代码解析// 流转把当前任务无缝迁移到附近设备import{continuationManager}fromkit.ContinuousTaskKitEntryComponentstruct Continuation{Statetip:string在手机上阅读build(){Column({space:16}){Text(this.tip).fontSize(20)Button(流转到平板).onClick((){continuationManager.startContinuation({deviceId:target-device-id,// 目标设备拉起同页面并带入当前状态want:{bundleName:com.example.app,abilityName:ReaderAbility}})this.tip已流转到平板继续阅读})}.padding(20)}}你会看到什么点按钮后当前阅读进度被带到平板平板自动打开同一页面并定位到相同位置手机端提示已流转。动手改一改用continuationManager.on(deviceConnect)自动发现附近设备。把要流转的状态序列化成want.parameters传递。在目标设备onNewWant里恢复状态。写在最后流转听着玄乎拆开就三步onContinue 打包状态 → 选设备发起 → 目标 onNewWant 重建。它解决的是任务搬家和数据多端共存是两套思路别混。想练手从视频进度流转做起最直观手机暂停时记进度流转到平板后用进度续播——用户能立刻感知到哇真的续上了。