docs: enhance SDK JSON import guidance by clarifying structured configuration requirements

This commit is contained in:
ob-yalian
2026-08-25 17:50:44 +08:00
parent 378595319a
commit 336b3578f8
2 changed files with 4 additions and 0 deletions
@@ -20,6 +20,8 @@ gemini_330_series_sdk_json.launch.py
SDK JSON 支持部分导入。可以从 JSON 中删除不需要配置的模块和参数,只保留本次需要导入的内容。未写入 JSON 的配置项不会由本次 JSON 导入修改,其最终值仍由 launch / YAML 参数、设备当前状态或默认配置决定。
需要注意,`parameters` 下的普通字段可以按需删除;但 ROI、`frame_interleave`、`disparity_search` 等结构化配置按整体单元处理:一旦保留该节点,就必须同时提供该节点要求的全部字段。例如,ROI 必须同时包含 `left`、`right`、`top`、`bottom`,不支持只配置其中一个或两个坐标;如果只想修改右下角,也必须同时提供左上角坐标的当前值。
建议根据实际需求精简 JSON,减少它与 launch / YAML 参数之间的重复配置和覆盖关系。例如,只需要配置 depth preset 和某个深度后处理滤波器时,可以删除其他传感器、点云及无关滤波器的配置。
删除模块或参数后,JSON 必须保持合法格式,保留内容的层级和字段名称也必须符合当前设备及固件支持的 SDK JSON 格式。精简后应重新导入,并按下文方法确认最终生效配置。