AI
产品服务
解决方案
文档与支持
定价
更新时间: 2026/03/23 15:54
引擎初始化
下载开发文档

在使用步骑行导航功能前,需要对步骑行导航引擎进行初始化。初始化成功后可调用步骑行导航其他功能。

1. 初始化之前,需要先创建步骑行导航服务对象。(通过入参可选择创建的对象为 步行/骑行)
let service: BDNaviService = new BDNaviService(NaviType.WALK)
2. 切换服务类型(可选)
// 设置步骑行服务对象类型为 骑行
service.setNaviType(NaviType.RIDE)
3. 引擎初始化(需传入上下文和底图控制器)
service.initializer().init(Context, MapController)
.then(() =>{
// todo
})
.catch((reason: string) =>{
console.error('error',reason)
})
4. 注册 TTS 语音播报插件(可选)

步骑行导航 SDK 本身不直接提供语音播报功能。可通过 TTS 插件在导航过程中获取播报文本,再结合鸿蒙原生 textToSpeech 或自定义 TTS 能力实现语音播报,TTS 插件需在 引擎初始化之前 注册。

4.1 实现ITTSPlugin接口

SDK 提供 ITTSPlugin 接口,核心方法如下:

export interface ITTSPlugin {
37
/** 引擎初始化时调用 */
init(): void
/** 引擎销毁时调用 */
unInit(): void
/**
* 导航过程中获取播报文本
* @param speech 播报语音文本
* @param bPreempt 是否抢占播报
* @returns 播报状态码
*/
playTTSText(speech: string, bPreempt: boolean): number
}
4.2 注册插件并获取播报文本

在调用 init() 之前,通过 setTTsPlugin() 注册实现类实例:

// 注册 TTS 插件(需在 init 之前)
this.service.initializer().setTTsPlugin(this._ttsPlugin)
// 随后执行初始化
this.service.initializer().init(Context, MapController)

上一篇

路线规划

下一篇

导航控制
本篇文章对您是否有帮助?