# 接入“扫码直达”服务

扫码直达能力仅支持中国境内（香港特别行政区、澳门特别行政区、中国台湾除外）接入使用。

在日常生活中，人们会使用各种应用扫各式各样的码，而“扫码直达”服务则为用户带来一种全新的扫码体验。

开发者将域名注册到“扫码直达”服务后，用户可通过控制中心等系统级的常驻入口，扫应用的二维码、条形码并跳转到应用对应服务页，实现一步直达服务的体验。

开发者接入“扫码直达”服务，能为应用带来：

*   更浅层的扫码入口和更便捷的“扫码直达”服务体验。
    
*   HarmonyOS强大的扫码能力。
    
*   更容易触达用户的全新渠道。
    

#### 业务流程

1.  开发者参考App Linking指导完成域名注册。
    
2.  用户通过HarmonyOS扫码入口发起扫码请求。
    
3.  HarmonyOS扫码入口调用系统能力解析码值，查询码值对应的应用信息后拉起应用。
    
4.  解析码值结果跳转应用服务页。
    

#### 开发步骤

1.  参考开发准备完成必要的准备工作。
    
2.  处理接收到的码值，完成应用内页面跳转逻辑。
    
    ```
    import { router, window } from '@kit.ArkUI';
    import { hilog } from '@kit.PerformanceAnalysisKit';
    import { UIAbility, Want } from '@kit.AbilityKit';
    import { BusinessError } from '@kit.BasicServicesKit';
    
    
    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为：
        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) {
        const uri: string | undefined = want?.uri;
        if (uri && this.uiContext) {
          // 开发者根据解析的uri跳转至相应页面，例如需要跳转页面为：pages/Access
          const status: router.RouterState = this.uiContext.getRouter().getState();
          if (status && status.name !== 'Access' && uri) {
            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}.`);
            }
          }
        }
      }
    }
    ```
    
3.  验证“扫码直达”服务。
    
    1.  将配置好域名映射关系的测试应用安装到本地。
    2.  打开HarmonyOS扫码入口（控制中心扫码入口），扫描应用发行的二维码。
    3.  确认能否拉起应用并跳转目标服务页。

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

#### 开发后验证

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

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

| 标准编号 | 标准项名称 | 类型 | 标准详细描述 |
| --- | --- | --- | --- |
| 1 | 应用已安装跳转体验 | 规则 | 通过系统扫一扫扫描码图可以跳转到履约页面。履约页面指的是扫码后的目标服务页面，例如，扫支付码跳转到应用的支付页面，而非首页。 |
| 2 | 应用未安装跳转体验 | 建议 | 通过系统扫一扫扫描码图会拉起浏览器加载码值所对应的网页，请设计网页满足用户诉求、指导用户安装应用等。 |