适配摇一摇导航流转

场景说明

摇一摇导航流转是将手机应用界面上的地址信息无缝流转至HiCar车机端，直接开启目的地导航。

当应用界面上存在地址信息时，开发者可以将地址信息设置对应的标签，即可实现摇一摇导航流转功能。

开发步骤

方案一（推荐）：通过Car Kit接口实现

1. 在应用配置中增加导航流转配置和相关权限。
   收起

   自动换行

   深色代码主题

   复制

   {
     "module": {
       "abilities": [
        {
           "name": "xxxx",
           "srcEntry": "xxxx",
           "description": "xxxx",
           "skills": [
             {
               "actions": [
                 "action.navigation.infoservice"
               ]
             },
             {...}
           ],
           "metadata": [
           {
             "name" : "carHopCapability",
             "value" : "carHopNavi"
           },
          ]
         }
       ],
       "requestPermissions": [
         {
           "name": "ohos.permission.ACCESS_SERVICE_NAVIGATION_INFO"
         }
       ]
     }
   }

2. 在应用启动时注册系统监听registerSystemNavigationListener，并实现onQueryNavigationInfo方法回调。
   收起

   自动换行

   深色代码主题

   复制

   try {
     const navInfoController: navigationInfoMgr.NavigationController = navigationInfoMgr.getNavigationController();
     navInfoController.registerSystemNavigationListener({
       onQueryNavigationInfo: (query: navigationInfoMgr.QueryType,
         args: Record<string, Object>) => {
         return new Promise((resolve, reject) => {
           if (query === navigationInfoMgr.QueryType.NAVIGATION_STATUS) {
             const status = {} as navigationInfoMgr.NavigationStatus;
             if (当前处于地址界面) {
               status.status = navigationInfoMgr.MapStatus.POI;
               status.destLocation = {
                 name: 'xxxxx', // 地址名称
                 coordType: navigationInfoMgr.LocationCoordType.GCJ02,
                 longitude: xxx, // 地址经度
                 latitude: xxx, // 地址纬度
                 altitude: 0
               }
             } else {
               status.status = navigationInfoMgr.MapStatus.IDLE;
               status.destLocation = {
                 name: 'xxxxx', // 地址名称
                 coordType: navigationInfoMgr.LocationCoordType.GCJ02,
                 longitude: -999, // 地址经度
                 latitude: -999, // 地址纬度
                 altitude: 0
               }
             }
             let result: navigationInfoMgr.ResultData = {
               code: 0,
               data: JSON.parse(JSON.stringify(status)),
               message: 'success'
             }
             resolve(result);
           } else {
             reject({ code: 0, message: 'Not supported' });
           }
         });
       },
       onReceiveNavigationCmd: (command: navigationInfoMgr.CommandType, args: Record<string, Object>) => {
         return new Promise((resolve, reject) => {
           reject({ code: 0, message: 'Not supported' });
         });
       }
     });
   } catch (err) {
     ......
   }

3. 在应用退出时取消注册系统查询监听。
   收起

   自动换行

   深色代码主题

   复制

   try {
     const navInfoController: navigationInfoMgr.NavigationController = navigationInfoMgr.getNavigationController();
     navInfoController.unregisterSystemNavigationListener();
   } catch (err) {
     ......
   }

方案二：通过ArkUI Text组件地址标签实现

如果应用未接入Car Kit，可通过该方式实现摇一摇导航流转。

1. 配置支持导航流转。
   收起

   自动换行

   深色代码主题

   复制

   {
     "module": {
       "abilities": [
        {
           "name": "xxxx",
           "srcEntry": "xxxx",
           "description": "xxxx",
           "skills": [
             {
               "actions": [
                 "action.navigation.infoservice"
               ]
             },
             {...}
           ],
           "metadata": [
           {
             "name" : "carHopCapability",
             "value" : "carHopAddress"
           },
          ]
         }
       ]
     }
   }

2. 通过ArkUI的accessibilityTextHint属性为显示地址的组件设置地址标签。
   收起

   自动换行

   深色代码主题

   复制

   const hintContent = JSON.stringify({
     type: 'location',
     groupId: 1,
     index: 1,
   });
   
   Text('地址描述')
     .accessibilityTextHint(hintContent)

   表1 字段说明

   展开

   字段名	描述
   type	文本属性，固定为“location”，代表文字是地址信息。
   groupId	文本分组，当地址需要拆分为多个Text组件时，设置为同一个id，则表示是一个地址。
   index	文本组内顺序，标识在同一个groupId中的排序。