使用场景

开发者可通过特定的业务类型如导航、金融等,调用startAbilityByType接口拉起对应的垂域面板,该面板将展示目标方接入的垂域应用,由用户选择打开指定应用以实现相应的垂类意图。垂域面板为调用方提供统一的安全、可信的目标方应用,同时降低调用方的接入成本。

接口说明

接口startAbilityByType11+ 是 UIAbilityContext 和 UIExtensionContentSession 提供的支持基于垂域业务类型拉起垂域面板,调用方通过指定特定的垂域业务类型即可拉起对应的垂域面板,在垂域面板上将展示目标方接入的垂域应用。

type为navigation导航对应的wantParam:

属性名称含义数据类型是否必填
destinationLatitude终点纬度numbersceneType=1或2时必填
destinationLongitude终点经度numbersceneType=1或2时必填
sceneType意图取值 :1:路线规划 2:导航 3: 地点搜索number否,缺省时默认为1
destinationName终点名称stringsceneType=3时必填
originName起点名称(路线规划场景有效)string
originLatitude起点纬度(路线规划场景有效)number
originLongitude起点经度(路线规划场景有效)number
vehicleType交通出行工具:0:驾车 1:步行 2:骑行 3:公交(路线规划场景有效)number否,缺省时由应用自行处理

说明
本文中的经纬度均采用GCJ-02坐标系统。

接入步骤

调用方接入步骤

  1. 导入ohos.app.ability.common模块。
import { common } from '@kit.AbilityKit';
  1. 构造接口参数并调用startAbilityByType接口。
import { common } from '@kit.AbilityKit';

let context = getContext(this) as common.UIAbilityContext;
let wantParam: Record<string, Object> = {
  'sceneType': 1,
  'destinationLatitude': 32.060844,
  'destinationLongitude': 118.78315,
  'destinationName': 'xx市xx路xx号',
  'originName': 'xx市xx公园',
  'originLatitude': 31.060844,
  'originLongitude': 120.78315,
  'vehicleType': 0
};
let abilityStartCallback: common.AbilityStartCallback = {
  onError: (code: number, name: string, message: string) => {
    console.log(`code:` + code + `name:` + name + `message:` + message);
  }
}

context.startAbilityByType("navigation", wantParam, abilityStartCallback, (err) => {
  if (err) {
    console.error(`startAbilityByType fail, err: ${JSON.stringify(err)}`);
  } else {
    console.log(`success`);
  }
});

效果示例图:

目标方接入步骤

  1. 导入ohos.app.ability.UIAbility模块。
import { UIAbility } from '@kit.AbilityKit';
  1. 在module.json5中新增 linkFeature 属性并设置声明当前应用支持的特性功能,从而系统可以从设备已安装应用中找到当前支持该特性的应用。
 {
 "abilities": [
     {
     "skills": [
         {
         "uris": [
             {
             "scheme": "maps", // 这里仅示意,应用需确保这里声明的的uri能被外部正常拉起
             "host": "navigation",
             "path": "",
             "linkFeature": "Navigation" // 声明应用支持导航功能
             },
             {
             "scheme": "maps", // 这里仅示意,应用需确保这里声明的的uri能被外部正常拉起
             "host": "routePlan",
             "path": "",
             "linkFeature": "RoutePlan" // 声明应用支持路线规划功能
             },
             {
             "scheme": "maps", // 这里仅示意,应用需确保这里声明的的uri能被外部正常拉起
             "host": "search",
             "path": "",
             "linkFeature": "PlaceSearch" // 声明应用支持位置搜索功能
             }
         ]
         }
     ]
     }
 ]
 }
  1. 解析参数并做对应处理。
UIAbility::onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void

在参数want.parameters中会携带Caller方传入的参数(与调用方传入的有些差异),如下表所示:

属性名称含义数据类型是否必填
destinationLatitude终点纬度numbersceneType=1或2时必填
destinationLongitude终点经度numbersceneType=1或2时必填
destinationName终点名称stringsceneType=3时必填
originName起点名称string否,存在时可用于展示路线规划页面
originLatitude起点纬度number否,存在时可用于展示路线规划页面
originLongitude起点经度number否,存在时可用于展示路线规划页面
vehicleType交通出行工具:0:驾车 1:步行 2:骑行 3:公交(路线规划场景有效)number否,缺省时由应用自行处理

应用可根据 linkFeature 中定义的特性功能,比如路线规划和导航结合接收到的参数开发不同的样式页面。

示例:

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window } from '@kit.ArkUI';

let destinationLatitude: number;
let destinationLongitude: number;
let originLatitude: number | undefined;
let originLongitude: number | undefined;

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');

    destinationLatitude = want.parameters?.destinationLatitude as number;
    destinationLongitude = want.parameters?.destinationLongitude as number;
    originLatitude = want.parameters?.originLatitude as number | undefined;
    originLongitude = want.parameters?.originLongitude as number | undefined;
  }

  onWindowStageCreate(windowStage: window.WindowStage) {
    hilog.info(0x0000, 'testTag', '%{public}s', `Ability onWindowStageCreate: ${JSON.stringify(this.context)}`);

    const storage: LocalStorage = new LocalStorage({
      "destinationLatitude": destinationLatitude,
      "destinationLongitude": destinationLongitude,
      "originLatitude": originLatitude,
      "originLongitude": originLongitude
    } as Record<string, number>);

    if (originLatitude !== undefined && originLongitude !== undefined) {
      windowStage.loadContent('pages/IndexForNavigation', storage);
    } else {
      windowStage.loadContent('pages/IndexForRoutePlan', storage);
    }
  }
}

鸿蒙全栈开发全新学习指南

为了积极培养鸿蒙生态人才,让大家都能学习到鸿蒙开发最新的技术,针对一些在职人员、0基础小白、应届生/计算机专业、鸿蒙爱好者等人群,整理了一套纯血版鸿蒙(HarmonyOS Next)全栈开发技术的学习路线【包含了大厂APP实战项目开发】

本路线共分为四个阶段

第一阶段:鸿蒙初中级开发必备技能

在这里插入图片描述

gitee.com/MNxiaona/733GH

第三阶段:应用开发中高级就业技术

gitee.com/MNxiaona/733GH

gitee.com/MNxiaona/733GH

写在最后

  • 如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:
  • 点赞,转发,有你们的 『点赞和评论』,才是我创造的动力。
  • 关注小编,同时可以期待后续文章ing,不定期分享原创知识。
  • 想要获取更多完整鸿蒙最新学习资源,请移步前往小编:gitee.com/MNxiaona/733GH

点赞(0) 打赏

评论列表 共有 0 条评论

暂无评论

微信公众账号

微信扫一扫加关注

发表
评论
返回
顶部