一、功能简介

本篇讲解如何在 HarmonyOS 中使用**分布式任务迁移（Continuation）**实现应用从一个设备无缝切换至另一个设备继续运行，适用于文档接力编辑、视频跨屏播放、扫码登录等多设备协同场景。

二、核心能力模块

✅ 模块说明

• @ohos.continuationRegisterManager：任务注册与迁移管理器

• @ohos.continuationManager：控制迁移行为

• 仅支持 Stage 模型 + 真机 + API 10+ + 多设备同账号登录

三、页面结构

entry/src/main/ets/pages/ContinuationDemo.ets

四、代码演示

import continuationRegisterManager from '@ohos.continuationRegisterManager'
import continuationManager from '@ohos.continuationManager'

@Entry
@Component
struct ContinuationDemo {
  @State content: string = ''
  @State deviceId: string = ''
  private token: number = -1

  async registerAbility() {
    try {
      this.token = await continuationRegisterManager.register({
        onConnect: () => {
          prompt.showToast({ message: '设备连接成功' })
        },
        onDisconnect: () => {
          prompt.showToast({ message: '设备已断开' })
        },
        onCompleteContinuation: () => {
          prompt.showToast({ message: '接续完成' })
        },
        onFail: (code: number) => {
          prompt.showToast({ message: '接续失败，错误码：' + code })
        },
        onSaveData: () => {
          // 接力数据写入
          return { content: this.content }
        },
        onRestoreData: (data: Record<string, any>) => {
          // 接收接力数据
          this.content = data.content ?? ''
        }
      })
    } catch (err) {
      prompt.showToast({ message: '注册失败' })
    }
  }

  async startContinuation() {
    try {
      const result = await continuationManager.startContinuation(this.token)
      if (!result) {
        prompt.showToast({ message: '未找到可接续设备' })
      }
    } catch (err) {
      prompt.showToast({ message: '启动接续失败' })
    }
  }

  build() {
    Column() {
      Text('分布式任务迁移演示')
        .fontSize(20)
        .margin({ bottom: 12 })

      TextArea({
        text: this.content,
        onChange: val => this.content = val
      })
        .placeholder('输入内容后点击接续，即可迁移到其他设备继续编辑')
        .height(140)
        .padding(10)
        .borderRadius(8)
        .backgroundColor('#f7f7f7')
        .fontSize(16)
        .margin({ bottom: 12 })

      Row() {
        Button('注册接续')
          .onClick(() => this.registerAbility())
        Button('启动接续')
          .type(ButtonType.Outline)
          .onClick(() => this.startContinuation())
      }
      .space(16)
    }
    .width('100%')
    .padding(20)
  }
}

五、运行效果

1. 设备 A 输入文本 → 点击【注册接续】；

2. 点击【启动接续】 → 出现附近设备列表；

3. 选择设备 B → 自动在设备 B 启动并恢复内容；

4. 支持跨设备「一键接续」体验。

六、常见易错点与解决方法

七、拓展建议

• 可实现接续前数据加密与校验；

• 搭配 distributedKVStore 实现“接续+同步”全闭环；

• 使用 DeviceManager 显式控制目标设备接续。