常见接续最佳实践

接续是一种用户体验优化技术。在个人设备数量激增的当代，若用户在使用应用时附近有合适的设备，可通过该功能将应用无缝切换至新设备继续操作。本文主要针对长列表进度、媒体播放进度和Web浏览进度三个场景，实现了浏览进度的高效接续。用户切换设备时可轻松恢复之前的浏览进度，极大提升使用便捷性与连贯性，提供设备无缝切换的流畅体验。

• 长列表进度接续：允许用户从上次离开位置继续浏览，精准定位到目标条目附近，避免重复滚动，节省时间并减少操作成本，提升浏览体验。
• 媒体播放进度接续：从源设备当前播放位置继续视频播放，保持播放进度、画面质量及音频设置的一致性，确保用户观影体验不被打断。支持在线视频平台的剧集、电影以及本地存储的视频文件，实现流畅接续播放。
• Web浏览进度接续：可快速定位至源设备浏览的网页位置，确保用户浏览连续性，避免重复查找信息的不便，提升信息获取效率。

进度接续的核心在于确保进度数据在不同设备间的精确传输与同步。在实际开发过程中，开发者会遇到各类复杂的接续需求，首要任务是深入分析对接续控制至关重要的数据。源设备启动接续时应保存数据，目标设备接续时需准确恢复数据，以确保进度的连续性与设备间数据的一致性。本章节将介绍如何配置应用以使用接续能力，以及如何保存和恢复数据以实现应用的无缝接续。具体开发流程如下：

1. 启用接续

   在module.json5文件的abilities中，需将continuable标签配置为"true"，以表示该UIAbility可被迁移。该配置默认值为"false"，未配置或显式配置为"false"的UIAbility将被系统识别为不可迁移。

   {
     "module": {
       // ...
       "abilities": [
         {
           // ...
           "continuable": true
         }
       ],
       // ...
     }
   }

   module.json5
2. 源端保存迁移数据

   当对端点击接续图标时，源端将触发UIAbility中的onContinue()接口。在此接口中，开发者可将需要迁移的数据以键值对形式保存至wantParam中，并返回AbilityConstant.OnContinueResult.AGREE，标识应用同意迁移，从而将数据迁移至对端。

   async onContinue(wantParam: Record<string, Object>): Promise<AbilityConstant.OnContinueResult> {
     // 1.1 Retrieve the data to be connected and transmit it via wantParam.
     let continueIndex = AppStorage.get('continueIndex') as number;
     wantParam.continueIndex = continueIndex;
     let currentOffset = AppStorage.get('currentOffset') as number;
     wantParam.currentOffset = currentOffset;
     let continueHeight = AppStorage.get('listItemHeight') as number;
     wantParam.continueHeight = continueHeight;
     let currentTime = AppStorage.get('currentTime') as number;
     wantParam.continueTime = currentTime;
     let videoIndex = AppStorage.get('videoIndex') as number;
     wantParam.continueItem = videoIndex;
     let flag = AppStorage.get('flag') as boolean;
     wantParam.flag = flag;
     let url = AppStorage.get('pageUrl') as string;
     wantParam.pageUrl = url;
     let distance = AppStorage.get('scrollDistance') as number;
     wantParam.scrollDistance = distance;
     let breakpoint = AppStorage.get(BreakpointConstants.BREAKPOINT_NAME) as string;
     wantParam.breakpoint = breakpoint;
     let pageInfos = AppStorage.get('pageInfos') as NavPathStack;
     let pageArr = pageInfos.getAllPathName();
     let currentPage = '';
     if (pageArr.length > 0) {
       currentPage = pageArr[pageArr.length - 1];
     }
     AppStorage.setOrCreate('continue', false);
     wantParam.currentPage = currentPage;
   
     return AbilityConstant.OnContinueResult.AGREE;
   }

   EntryAbility.ets
3. 对端恢复数据

   在源端保存数据并同意迁移后，对端可启动应用，开发者可在UIAbility中的onCreate()或onNewWant()生命周期回调中恢复数据。如果Ability的启动原因为LaunchReason.CONTINUATION，可从want.parameters中获取保存的键值对数据。

   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
     GlobalContext.getContext().setObject('abilityWant', want);
     GlobalContext.getContext().setObject('context', this.context);
     if (want.parameters) {
       if (want.parameters.currentTime) {
         GlobalContext.getContext().setObject('currentTime', want.parameters.currentTime);
       }
     }
     try {
       this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
     } catch (e) {
       hilog.error(0x0000, 'progress', `setColorMode error, code is ${e.code}, message is ${e.message}`);
     }
     if (launchParam.launchReason === AbilityConstant.LaunchReason.CONTINUATION) {
       if (want.parameters) {
         this.continueRestore(want);
       }
     }
     hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate');
   }

   EntryAbility.ets

   可将恢复数据的方法提取为公共方法，以便在UIAbility的onCreate()或onNewWant()中调用。

   continueRestore(want: Want) {
     if (!want.parameters) {
       hilog.error(0x0000, 'EntryAbility', 'missing sessionId');
       return;
     }
     let currentPage = want.parameters.currentPage as string;
     AppStorage.setOrCreate('currentPage', currentPage);
     want.parameters.continueIndex && AppStorage.setOrCreate('continueWaterOffset', want.parameters.continueIndex);
     want.parameters.currentOffset && AppStorage.setOrCreate('continueOffset', want.parameters.currentOffset);
     want.parameters.continueHeight && AppStorage.setOrCreate('continueHeight', want.parameters.continueHeight);
     AppStorage.setOrCreate('continueEntry', true);
     AppStorage.setOrCreate('setCurrentOffset', true);
     want.parameters.continueTime && AppStorage.setOrCreate('currentTime', want.parameters.continueTime);
     want.parameters.continueItem && AppStorage.setOrCreate('videoIndex', want.parameters.continueItem);
     want.parameters.continueItem && AppStorage.setOrCreate('videoSelect', want.parameters.continueItem);
     want.parameters.flag && AppStorage.setOrCreate('flag', want.parameters.flag);
     AppStorage.setOrCreate('continue', true);
     AppStorage.setOrCreate('continueRestore', true);
     want.parameters.pageUrl && AppStorage.setOrCreate('pageUrl', want.parameters.pageUrl);
     want.parameters.scrollDistance && AppStorage.setOrCreate('scrollDistance', want.parameters.scrollDistance);
     want.parameters.breakpoint && AppStorage.setOrCreate('continueBreakpoint', want.parameters.breakpoint);
   
     try {
       this.context.restoreWindowStage(new LocalStorage());
     } catch (e) {
       hilog.error(0x0000, 'progress', `restoreWindowStage error, code is ${e.code}, message is ${e.message}`);
     }
   }

   EntryAbility.ets

WaterFlow({ footer: this.footStyle, scroller: this.waterFlowScroller }) {
  // ...
}
.restoreId(1)