配置项

功能介绍

EHServiceOption.Builder 用于配置 EH 服务行为。
本文汇总常用配置项、默认值与建议。

创建方式

val option = EHServiceOption.Builder()
    .setServiceMode(EHServiceMode.STANDALONE)
    .setMainPathLength(4000)
    .setSubPathLevel(0)
    .setIntersectionDetectDistance(1000)
    .build()

基础与模式配置

方法	说明	默认
`setServiceMode(mode)`	工作模式：`STANDALONE` / `AFFILIATE`	`STANDALONE`
`enableSelfPropellingUponWeakGPS(enabled)`	弱 GPS 时自推进（隧道场景）	`false`
`enableAddonLaunchAutoMode(enabled)`	是否自动拉起 addon 服务	`true`

EH 范围与输出配置

方法	说明	默认 / 建议
`setMainPathLength(length)`	主路径长度（米）	默认 `2000`，范围建议 `0~100000`
`setTrailingLength(length)`	轨迹尾部保留长度（米）	默认 `100`，范围建议 `0~500`
`setSubPathLevel(level)`	分支路径级别	默认 `0`，建议 `0~1`
`setSubPathLength(length)`	分支路径最大长度（米）	默认 `100`，建议 `100~800`
`setCandidatePathLength(length)`	候选路径长度（米）	默认 `0`，建议不超过 `mainPathLength`
`setIntersectionDetectDistance(distance)`	路口检测距离（米），`0` 表示关闭	默认 `0`
`enableTraffic(enabled)`	是否输出 EH 交通信息	默认 `false`

消息服务相关配置

方法	说明	默认 / 建议
`setPositionMessagePeriod(milliseconds)`	位置消息派发周期（ms）	默认 `1000`，建议 `100~1000`

该项主要用于 EHMessageService 场景。

日志与同步配置

方法	说明	默认
`enableLog(enabled)`	开启 EH 日志	`false`
`setLogStorePath(path)`	日志目录（需存在）	空
`setLogLevel(level)`	`SIMPLIFIED` / `FULL`	`SIMPLIFIED`
`enableLogCompressed(enabled)`	压缩日志	`false`
`setNavigationSyncAddress(address)`	跨进程导航内容同步地址（`tcp://ip:port`）	空
`enableAnalyticsCollection(enabled)`	数据采集开关	`true`

跨进程协同完整接入流程见跨进程协同。

路径限制策略

方法	说明	默认
`enablePathAvoidRestriction(enabled)`	开启非结构化限制规避	`true`
`enablePathBeyondRestriction(enabled)`	开启非结构化限制穿越策略	`false`

配置建议

先以默认值上线，再按场景逐项调优，避免一次性打开全部开关。
setIntersectionDetectDistance 会增加计算负载，仅在路口能力确有需求时启用。
enableTraffic(true) 建议与消费侧限流/异步处理配套使用。
enableSelfPropellingUponWeakGPS(true) 建议在无外部 DR 的场景谨慎启用。