接入“扫码直达”服务

业务流程

1. 开发者参考App Linking指导完成域名注册。

2. 用户通过HarmonyOS扫码入口发起扫码请求。

3. HarmonyOS扫码入口调用系统能力解析码值，查询码值对应的应用信息后拉起应用。

4. 解析码值结果跳转应用服务页。

开发步骤

1. 参考开发准备完成必要的准备工作。

2. 处理接收到的码值，完成应用内页面跳转逻辑。

   收起

   自动换行

   深色代码主题

   复制

   import { UIAbility, Want } from '@kit.AbilityKit';
   import { BusinessError } from '@kit.BasicServicesKit';
   import { hilog } from '@kit.PerformanceAnalysisKit';
   import { router, window } from '@kit.ArkUI';
   
   export default class EntryAbility extends UIAbility {
     private page: string = 'pages/Index';
     private uiContext?: UIContext;
   
     // 冷启动场景通过onCreate回调获取码值信息
     onCreate(want: Want): void {
       hilog.info(0x0001, '[Scan Access]', 'Succeeded in getting want in onCreate');
   
       // 从want中获取传入的链接信息。如传入的url为：https://www.example.com/scan
       this.getRouterUri(want);
     }
   
     // 热启动场景通过onNewWant回调获取码值信息
     onNewWant(want: Want): void {
       hilog.info(0x0001, '[Scan Access]', 'Succeeded in getting want in onNewWant');
       // 从want中获取传入的链接信息
       this.getRouterUri(want);
     }
   
     onWindowStageCreate(windowStage: window.WindowStage): void {
       hilog.info(0x0001, '[Scan Access]', 'Ability onWindowStageCreate');
       try {
         windowStage.getMainWindow().then((windowObj: window.Window) => {
           try {
             windowStage.loadContent(this.page).then(() => {
               hilog.info(0x0001, '[Scan Access]', 'Succeeded in loading the content.');
               try {
                 this.uiContext = windowObj.getUIContext();
                 hilog.info(0x0001, '[Scan Access]', 'Succeeded in getting UIContext.');
               } catch (err) {
                 hilog.error(0x0001, '[Scan Access]', `Failed to get UIContext by windowObj. Code: ${err.code}.`);
               }
             }).catch((err: BusinessError) => {
               hilog.error(0x0001, '[Scan Access]', `Failed to load the content. Code: ${err.code}.`);
             })
           } catch (err) {
             hilog.error(0x0001, '[Scan Access]', `Failed to load the content. Code: ${err.code}.`);
           }
         }).catch((err: BusinessError) => {
           hilog.error(0x0001, '[Scan Access]', `Failed to get MainWindow. Code: ${err.code}.`);
         })
       } catch (err) {
         hilog.error(0x0001, '[Scan Access]', `Failed to get MainWindow. Code: ${err.code}.`);
       }
     }
   
     // 解析扫码结果，跳转相应页面
     private getRouterUri(want: Want): void {
       const uri: string | undefined = want?.uri;
       if (!uri) {
         return;
       }
       this.page = 'pages/Access';
   
       if (this.uiContext) {
         // 开发者根据解析的uri跳转至相应页面，例如需要跳转页面：pages/Access
         const status: router.RouterState = this.uiContext.getRouter().getState();
         if (status && status.name !== 'Access') {
           try {
             // 根据uri参数做业务处理
             this.uiContext.getRouter().pushUrl({
               url: 'pages/Access'
             }).catch((err: BusinessError) => {
               hilog.error(0x0001, '[Scan Access]', `Failed to pushUrl by getRouter. Code: ${err.code}.`);
             });
           } catch (err) {
             hilog.error(0x0001, '[Scan Access]', `Failed to pushUrl by getRouter. Code: ${err.code}.`);
           }
         }
       }
     }
   }

   EntryAbility.ets

3. 验证“扫码直达”服务。

   1. 将配置好域名映射关系的测试应用安装到本地。
   2. 打开HarmonyOS扫码入口（控制中心扫码入口），扫描应用发行的二维码。
   3. 确认能否拉起应用并跳转目标服务页。

集成效果，以美团单车场景为例：

开发后验证

集成扫码直达能力应用用户体验质量建议

应用完成开发后，可参照以下标准检查集成扫码直达后的用户体验是否符合预期：