JSON 模块总览 - Overview

本分类做什么

JSON 解析、构建、类型读写 与 序列化；并包含 图像识别结果 JSON 的快速解析辅助（ParseMatchImage* 等）。与 图像识别、网络 HTTP 返回体配合使用。

---

一、文档级与释放

接口	差异
JsonParse	字符串 → 句柄（或内部对象 id）。
JsonCreateObject、JsonCreateArray	空 对象/数组 根。
JsonStringify	句柄 → 字符串。
JsonFree	必须 配对释放，防泄漏。

---

二、结构操作

接口	用途
JsonGetSize	对象键数或数组长度。
JsonGetValue、JsonSetValue	通用读写
JsonArrayAppend	数组 追加。
JsonClear	清空对象/数组。
JsonDeleteKey	删除键。

---

三、类型化读写

类型	读	写
字符串	JsonGetString	JsonSetString
数值	JsonGetNumber	JsonSetNumber
布尔	JsonGetBool	JsonSetBool
数组元素	JsonGetArrayItem	—（常配合 Append）

差异：GetValue 为 通用；Get*Number/String/Bool 做 类型断言。

---

四、图像识别专用

接口	用途
ParseMatchImageJson	单结果 JSON → 坐标等字段。
GetMatchImageAllCount	多结果 数量。
ParseMatchImageAllJson	多结果 逐条解析。

与通用 JsonParse 差异：针对 MatchImage 返回格式 做了 字段捷径，减少手写路径。

---

五、快速选型

需求	建议
HTTP 返回 JSON	JsonParse → JsonGetString 等
拼请求体	JsonCreateObject → JsonSet* → JsonStringify
找图结果	ParseMatchImageJson 系列

---

六、注意

• 大 JSON 注意 内存；循环内 JsonFree。
• 浮点精度 与 科学计数法 以插件实现为准。