评价算法类¶
5.1 EvaluationAPI¶
5.1.1 评价 API 功能介绍¶
SimOne 支持用户自定义评价功能，EvaluationAPI 用于获取和存储评价所需的数据，主要包括两类：
（1）仿真过程数据：主车及障碍物的位姿数据等（由 SimOne 自动采集）
（2）算法内部信号：状态机信号、控制信号等（由用户通过 AddEvaluationRecord 主动上报）
5.1.2 初始化方式：数据库存储 vs 本地文件存储¶
InitEvaluationService |
InitEvaluationServiceWithLocalData |
|
|---|---|---|
| 存储位置 | 评价服务数据库 | 本地 JSON 文件 |
| 适用场景 | 需要在线评价报告、对接 SimOne 评价平台 | 离线分析、无评价服务环境 |
| 额外参数 | 需填写 serviceIP 和 port |
无需网络配置 |
两个初始化函数只需调用其一，不可同时调用。
5.1.3 用户算法内部信号上报¶
通过 AddEvaluationRecord 以 JSON 格式上报自定义信号，例如：
{"category": "signal", "timestamp": 1648363819335, "ACC": "on", "ACCSpeed": 20}
category 字段标识数据类别，timestamp 为毫秒级时间戳，其余字段由用户自定义。调用 SaveEvaluationRecord 触发本地持久化。
5.1.4 场景判定接口¶
判定接口用于在仿真运行过程中接收或主动发送场景判定事件，与 SimOne 评价报告系统对接。
| 使用场景 | API |
|---|---|
| 被动接收：注册回调，获取 SimOne 产生的场景判定事件 | SetJudgeEventCB |
| 主动发送：向评价服务广播判定事件（用于生成报告） | AddJudgeEvent |
AddJudgeEvent 的 terminate 参数设为 true 时，会在发送事件的同时终止当前场景。
完整 API 签名、参数说明及
SimOne_Data_JudgeEvent结构体定义，参见： -InitEvaluationService-InitEvaluationServiceWithLocalData-SetJudgeEventCB-AddJudgeEvent