百度地图开放平台
更新时间: 2026/07/22 16:54
通用能力
下载开发文档

通用能力 (Common)

通过 BNSDKService.common 访问,提供 SDK 通用能力。

1. 接口定义 BNICommonInterface
export interface BNICommonInterface {
canHandleOpenAPI(url: string): boolean;
setSystemColorMode(newConfig: Configuration): void;
isInNaviPage(): boolean;
}
2. 功能详解
2.1 OpenAPI 拦截 canHandleOpenAPI

检查指定 OpenAPI 是否可在导航中响应。SDK 内部采用白名单策略。

const canHandle = sdkService.common.canHandleOpenAPI('baidumap://...');
if (!canHandle) {
// 当前导航场景不支持此 OpenAPI
}
2.2 系统颜色模式 setSystemColorMode

同步系统颜色模式到 SDK,用于日夜模式切换。

import { Configuration } from '@kit.AbilityKit';
const config = new Configuration();
config.colorMode = ConfigurationConstant.ColorMode.COLOR_MODE_DARK;
sdkService.common.setSystemColorMode(config);
2.3 判断导航页面 isInNaviPage

判断当前是否在导航页面中。

if (sdkService.common.isInNaviPage()) {
// 当前处于导航页面
}

上一篇

定位信息

下一篇

语音播报
本篇文章对您是否有帮助?