Skip to content

工作模式

功能介绍

EHService 支持两种模式：

  • EHServiceMode.STANDALONE：独立地平线，基于当前位置与地图推断路径。
  • EHServiceMode.AFFILIATE：与导航联动，EH 路径可受当前导航路线影响。

模式对比

模式 典型场景 关键接入动作
STANDALONE 无导航会话、仅需前方地平线 直接创建 EH 服务并消费回调
AFFILIATE 导航进行中、希望 EH 与导航路线一致 创建 EH 服务后调用 NavigationService.addExtension(ehService)

STANDALONE 示例

1
2
3
4
5
val ehDataService = EHService.Factory.createEHDataService(
    EHServiceOption.Builder()
        .setServiceMode(EHServiceMode.STANDALONE)
        .build()
)

AFFILIATE 示例

1
2
3
4
5
6
7
8
9
val navigationService = NavigationService.Factory.createInstance()

val ehDataService = EHService.Factory.createEHDataService(
    EHServiceOption.Builder()
        .setServiceMode(EHServiceMode.AFFILIATE)
        .build()
)

navigationService.addExtension(ehDataService)

AFFILIATE 典型流程

1
2
3
4
5
6
7
8
9
创建 NavigationService
   ↓
创建 EHService（AFFILIATE）
   ↓
navigationService.addExtension(ehService)
   ↓
启动导航会话（startNavigation）
   ↓
消费 EH 输出（Path/Position 或 Message/Feedback）

注意事项

  • AFFILIATE 模式建议在导航启动前完成 extension 绑定。
  • 若 EH 与导航都需要长期运行，生命周期管理建议统一在同一个组件中处理。
  • 若不需要导航联动，请使用 STANDALONE 减少集成复杂度。