人工智能強(qiáng)化學(xué)習(xí)計(jì)算機(jī)視覺游戲開發(fā)測試【免費(fèi)下載鏈接】GameAISDK基于圖像的游戲AI自動化框架項(xiàng)目地址https://gitcode.com/gh_mirrors/ga/GameAISDK點(diǎn)擊查看免費(fèi)下載本指南以 GameAISDK 倉庫內(nèi)置的 JsonCpp 源碼Modules/Json/jsoncpp-master為主體系統(tǒng)講解這個 C JSON 庫的核心能力、三種集成方式、完整構(gòu)建流程與測試體系并深入剖析它在 GameAISDK 圖像處理模塊中承擔(dān)的任務(wù)配置解析職責(zé)。讀完本文你將掌握 JsonCpp 的單一源碼文件集成amalgamation、CMake/Conan/SCons 構(gòu)建、Reader/Writer 測試用例編寫以及如何用Json::Reader與Json::Value在真實(shí)項(xiàng)目中讀取 JSON 配置。JsonCpp 是什么輕量級數(shù)據(jù)交換格式的 C 實(shí)現(xiàn)JSONJavaScript Object Notation是一種輕量級的數(shù)據(jù)交換格式它可以表示數(shù)字numbers、字符串strings、有序的值序列ordered sequences of values以及名稱/值對的集合collections of name/value pairs。在 AI 游戲自動化這類需要大量結(jié)構(gòu)化配置任務(wù)列表、識別規(guī)則、動作參數(shù)的項(xiàng)目中JSON 憑借其可讀性與通用性成為配置存儲的首選。JsonCpp 是一個 C 庫允許開發(fā)者操作 JSON 值包括與字符串之間的序列化serialization和反序列化deserialization。它還有一個實(shí)用特性在反序列化/序列化過程中可以保留原有注釋這使得它特別適合用來存儲用戶輸入文件——因?yàn)榕渲梦募械淖⑨屚情_發(fā)者留給后來者的重要說明不應(yīng)在解析重寫后丟失。倉庫中該庫的完整源碼位于 Modules/Json/jsoncpp-master公共頭文件集中在 Modules/Json/jsoncpp-master/include/json其中 json.h 作為總?cè)肟诮y(tǒng)一引入了value.h、reader.h、writer.h、features.h與autolink.h五個核心頭文件即「值模型 讀取器 寫入器 特性開關(guān)」的完整 API 面。版本策略與向后兼容性JsonCpp 的版本策略在其 README 中有明確約定1.y.z系列基于 C11 構(gòu)建0.y.z系列可用于更老舊的編譯器主版本major version之間維持二進(jìn)制兼容binary-compatibility。在倉庫的 CMakeLists.txt 中可以看到實(shí)際版本被定義為1.8.1對應(yīng)的JSONCPP_SOVERSION共享庫版本號為11。構(gòu)建系統(tǒng)還強(qiáng)制要求 C11 標(biāo)準(zhǔn)CMAKE_CXX_STANDARD 11且CMAKE_CXX_STANDARD_REQUIRED ON并關(guān)閉 GNU 擴(kuò)展這與 README 中「1.y.z 基于 C11」的說明完全一致。因此將 JsonCpp 集成進(jìn) GameAISDK 這類使用現(xiàn)代 C 的項(xiàng)目時不存在語言標(biāo)準(zhǔn)層面的兼容障礙。在項(xiàng)目中集成 JsonCpp 的推薦方式方式一使用 amalgamated 單一源碼文件官方推薦README 明確推薦的做法是將amalgamated source一個.cpp文件加兩個.h文件直接加入你的項(xiàng)目像編譯任何普通源文件一樣參與編譯。這樣做的好處是保證編譯標(biāo)志compilation flags的一致性避免共享庫/靜態(tài)庫構(gòu)建時常見的 ABI 兼容性問題。同時需要把include/目錄加入編譯器的 include 路徑并按下述方式包含頭文件#include json/json.h如果在 Windows 上以動態(tài)庫方式構(gòu)建 JsonCpp那么使用方項(xiàng)目還需定義宏JSON_DLL該宏由 autolink.h 配合使用用于處理 Windows 下 DLL 的導(dǎo)入/導(dǎo)出符號標(biāo)記。生成 amalgamated 源碼與頭文件JsonCpp 自帶生成腳本 amalgamate.py。在倉庫頂層目錄即Modules/Json/jsoncpp-master/執(zhí)行以下命令即可隨時生成腳本同時兼容 Python 2.6 與 Python 3.4python amalgamate.py腳本支持通過-h查看全部選項(xiàng)核心參數(shù)如下來自 amalgamate.py 的main()參數(shù)含義默認(rèn)值-s, --source輸出的.cpp源碼路徑dist/jsoncpp.cpp-i, --include生成的頭文件包含路徑用于源碼中 include 該頭json/json.h-t, --top-dir源碼頂層目錄當(dāng)前工作目錄默認(rèn)情況下會生成三個文件dist/jsoncpp.cpp需要加入項(xiàng)目的源文件dist/json/json.h對應(yīng)非 amalgamated 源碼中的json/json.h該頭文件只依賴標(biāo)準(zhǔn)頭文件dist/json/json-forwards.h提供所有 JsonCpp 類型的前置聲明forward declaration適合用來減少編譯依賴。其實(shí)現(xiàn)原理見 amalgamate.py腳本按正確順序拼接 JsonCpp 的各個源文件——依次是src/lib_json/json_tool.h、json_reader.cpp、json_valueiterator.inl、json_value.cpp、json_writer.cpp并定義宏JSON_IS_AMALGAMATION以阻止內(nèi)部再包含其他私有頭文件。如果編譯時未提供該宏amalgamated 源碼會通過#error Compile with -I PATH_TO_JSON_DIRECTORY直接報(bào)錯防止誤用。方式二傳統(tǒng)庫構(gòu)建集成若希望以靜態(tài)庫/共享庫方式鏈接可參考下文「構(gòu)建 JsonCpp」章節(jié)。倉庫內(nèi)Modules/Json/lib/Windows/下已提供預(yù)編譯的 Windows.lib文件而Modules/Json/lib/Linux/目錄為空Linux 平臺需要自行構(gòu)建。構(gòu)建 JsonCpp 的三種方式使用 CMake 構(gòu)建當(dāng)前主推方式CMake 是 C 的 Makefiles/Solution 生成器在大多數(shù) Linux 系統(tǒng)上可作為軟件包安裝Ubuntu 上執(zhí)行sudo apt-get install cmake。注意運(yùn)行 JSON reader/writer 測試還需要 Python若缺失構(gòu)建會跳過這些測試。倉庫根 CMakeLists.txt 提供了豐富的構(gòu)建開關(guān)關(guān)鍵選項(xiàng)整理如下選項(xiàng)默認(rèn)值說明BUILD_SHARED_LIBSOFF構(gòu)建共享庫動態(tài)庫BUILD_STATIC_LIBSON構(gòu)建靜態(tài)庫JSONCPP_WITH_TESTSON編譯 JsonCpp 測試可執(zhí)行文件JSONCPP_WITH_POST_BUILD_UNITTESTON作為構(gòu)建后步驟自動運(yùn)行單元測試JSONCPP_WITH_WARNING_AS_ERROROFF編譯出現(xiàn)警告即失敗JSONCPP_WITH_STRICT_ISOON啟用嚴(yán)格 ISO C/C 警告JSONCPP_WITH_PKGCONFIG_SUPPORTON生成并安裝.pcpkg-config文件JSONCPP_WITH_CMAKE_PACKAGEOFF生成并安裝 CMake 包文件JSONCPP_USE_SECURE_MEMORY0置1時為 STL 啟用清空內(nèi)存的分配器使用cmake-gui的可視化步驟如下將「source code」指向源碼目錄「where to build the binary」指向構(gòu)建目錄勾選「Grouped」分組查看選項(xiàng)按需勾選BUILD_SHARED_LIBS構(gòu)建動態(tài)庫點(diǎn)擊 Configure 再點(diǎn)擊 Generate生成的 Makefiles/Solution 即位于二進(jìn)制目錄。命令行方式在源碼目錄執(zhí)行Unix 環(huán)境mkdir -p build/debug cd build/debug cmake -DCMAKE_BUILD_TYPEdebug -DBUILD_STATIC_LIBSON -DBUILD_SHARED_LIBSOFF -DARCHIVE_INSTALL_DIR. -G Unix Makefiles ../.. make若需要生成規(guī)范的 pkg-config 文件可追加-DCMAKE_INSTALL_INCLUDEDIRinclude/jsoncpp其他實(shí)用提示運(yùn)行cmake -h可查看所有可用的生成器通過-G指定如 Visual Studio 版本、32/64 位解決方案等CMake 默認(rèn)隱藏編譯命令生成 Makefiles 時加-DCMAKE_VERBOSE_MAKEFILEtrue即可顯示從 CMakeLists.txt 可見JSONCPP_WITH_TESTS與JSONCPP_WITH_POST_BUILD_UNITTEST默認(rèn)開啟構(gòu)建時會一并產(chǎn)出測試可執(zhí)行文件。使用 Conan 構(gòu)建Conan 是面向 C/C 的開源包管理器跨平臺且與構(gòu)建系統(tǒng)無關(guān)。它需要 Python可用pip install conan安裝。使用 Conan 需要創(chuàng)建conanfile.txt簡單或conanfile.py更靈活。README 中給出的conanfile.txt示例[requires] jsoncpp/1.8.0theirix/ci [generators] cmake然后在 conanfile 所在目錄執(zhí)行conan install --build missing該命令會嘗試從配方倉庫下載與當(dāng)前設(shè)置OS、編譯器、架構(gòu)匹配的包找不到則本地構(gòu)建。注意cmake 生成器并非必需可換用其他集成方式或通過 virtualenv generators 設(shè)置環(huán)境變量即便不使用 Conan 的 cmake 生成器也不需要手動安裝 cmake——配方會自動下載。使用 SCons 構(gòu)建已棄用README 明確標(biāo)注 SCons 構(gòu)建系統(tǒng)已被棄用建議改用 CMake。SCons 需要 Python。調(diào)用方式為scons platform$PLATFORM [TARGET]其中$PLATFORM可取sunccSolaris、vacppAIX Visual Age C、mingw、msvc6VS6 SP5-6、msvc70VS2002、msvc71VS2003、msvc80VS2005、msvc90VS2008、linux-gccLinux官方稱在 Mac OS X 上也可用。若使用 Visual Studio 2008 構(gòu)建需先運(yùn)行vcvars32.bat配置環(huán)境。測試體系手動測試、測試用例編寫與輸出解讀運(yùn)行測試僅當(dāng)排查問題troubleshooting時才需要手動運(yùn)行測試。以下命令中請將path/to/jsontest替換為你平臺實(shí)際編譯出的jsontest可執(zhí)行文件路徑cd test # 運(yùn)行 Reader/Writer 測試 python runjsontests.py path/to/jsontest # 使用 JSONChecker 測試套件運(yùn)行 Reader/Writer 測試 # 注意并非所有用例都能通過——JsonCpp 目前解析過于寬松 # 例如允許整數(shù)以 0 開頭目標(biāo)是改進(jìn)嚴(yán)格模式解析使全部用例通過 python runjsontests.py --with-json-checker path/to/jsontest # 運(yùn)行單元測試主要是 Value 相關(guān) python rununittests.py path/to/test_lib_json # 使用 valgrind 運(yùn)行單元測試 python rununittests.py --valgrind path/to/test_lib_json使用 SCons 時可通過check目標(biāo)運(yùn)行測試scons platform$PLATFORM check測試腳本位于 Modules/Json/jsoncpp-master/test/包括runjsontests.py、rununittests.py、pyjsontestrunner.py等測試輸入數(shù)據(jù)在test/data/目錄下倉庫共有 94 個.json與 56 個.expected文件。添加一個 reader/writer 測試在test/data下新增測試需要兩個文件TESTNAME.jsonJSON 格式的輸入文檔TESTNAME.expected輸入文檔的扁平化flattened表示。TESTNAME.expected文件格式規(guī)則README 原文要點(diǎn)每一行代表輸入文檔元素樹中的一個 JSON 元素每行由「訪問元素的路徑」 「元素值」兩部分組成數(shù)組和對象的值始終為空即[]或{}元素路徑中.代表根元素同時用于分隔對象成員[N]表示數(shù)組中索引為N的元素。以倉庫中的 test/data/test_complex_01.json 為例它包含嵌套對象、字符串?dāng)?shù)組與混合類型數(shù)組其對應(yīng)的 test/data/test_complex_01.expected 展示了扁平化規(guī)則的實(shí)際效果.{} .attribute[] .attribute[0]random .attribute[1]short .attribute[2]bold .attribute[3]12 .attribute[4]{} .attribute[4].height7 .attribute[4].width64 .count1234 .name{} .name.akaT.E.S.T. .name.id123987 .test{} .test.1{} .test.1.2{} .test.1.2.3{} .test.1.2.3.coord[] .test.1.2.3.coord[0]1 .test.1.2.3.coord[1]2可以看到數(shù)字成員count直接寫出值字符串?dāng)?shù)組每個元素單獨(dú)一行[0]、[1]…嵌套對象如name、test.1.2.3只展開為{}并在下一行繼續(xù)其成員數(shù)組coord則按[0]、[1]展開。理解 reader/writer 測試輸出測試運(yùn)行時會緊鄰輸入文件生成輸出文件README 對各文件的含義說明如下test_complex_01.json輸入 JSON 文檔test_complex_01.expected用于校驗(yàn)解析正確性的扁平化元素樹test_complex_01.actualjsontest讀取test_complex_01.json后生成的扁平化元素樹test_complex_01.rewritejsontest將解析得到的Json::Value用Json::StyledWritter序列化后寫出的 JSON 文檔test_complex_01.actual-rewritejsontest讀取test_complex_01.rewrite后生成的扁平化元素樹test_complex_01.process-outputjsontest的輸出通常用于理解解析錯誤的原因。這一「expected / actual / rewrite / actual-rewrite」的對照設(shè)計(jì)使開發(fā)者既能驗(yàn)證解析正確性又能驗(yàn)證「讀-寫-再讀」的往返一致性round-trip這正是保留注釋特性的測試保障。實(shí)戰(zhàn)佐證JsonCpp 在 GameAISDK 中的配置解析應(yīng)用JsonCpp 在 GameAISDK 中并非僅僅作為第三方依賴存在而是直接支撐了圖像識別模塊的 JSON 配置讀取。核心封裝位于 src/ImgProc/Comm/Utils/JsonConfig.h 與 src/ImgProc/Comm/Utils/JsonConfig.cpp其頭文件頂部即#include json/json.h正是 README 推薦的包含方式。從 JsonConfig.cpp 可以看到典型的 JsonCpp 讀取流程bool CJsonConfig::loadFile(const char *pstrConfName) { if (NULL pstrConfName) { LOGE(input config file is null); return false; } Json::Reader reader; std::ifstream in(std::string(pstrConfName), std::ios::binary); if (!in.is_open()) { LOGE(Error opening file, format is wrong.); return false; } return reader.parse(in, m_root); }即實(shí)例化Json::Reader→ 打開二進(jìn)制輸入流 →reader.parse(in, m_root)將 JSON 文檔解析進(jìn)成員Json::Value m_root。這與 README 描述的「反序列化到字符串/流」能力完全對應(yīng)。隨后的讀取接口展示了Json::Value的典型用法GetDataJsonConfig.cpp通過JsonRoot[strKey]按鍵取值并用pval-isNull()判斷鍵是否存在GetConfValue與GetArrayValue將 JSON 路徑按/拆分為關(guān)鍵字序列逐層下鉆token(pData, /, ...)最終按ConfigDataType類型DATA_INT/DATA_UINT/DATA_BOOL/DATA_STR/DATA_FLOAT/DATA_DOUBLE調(diào)用asInt()、asUInt()、asBool()、asString()、asFloat()、asDouble()完成類型轉(zhuǎn)換并拷貝結(jié)果GetArraySize返回?cái)?shù)組元素個數(shù)JsonVal.size()GetJosnValue直接返回Json::Value供上層進(jìn)一步處理。從源碼結(jié)構(gòu)看GameAISDK 將 JsonCpp 的底層 API 二次封裝為「路徑式」配置讀取上層只需給出形如task/xxx/count的/分隔路徑即可取數(shù)兼顧了 JsonCpp 的靈活性與業(yè)務(wù)層的易用性。這種模式同樣被src/ImgProc/UI、src/ImgProc/GameRecognize等多個子模塊采用其構(gòu)建文件如 src/ImgProc/GameRecognize/Makefile.am、src/ImgProc/GameRecognize/Windows/GameReg.vcxproj 均顯式引用 jsoncpp說明 JsonCpp 是貫穿整個圖像處理管線的公共基礎(chǔ)設(shè)施。構(gòu)建文檔與許可說明如需生成 JsonCpp 的 Doxygen 文檔在頂層目錄運(yùn)行python doxybuild.py --doxygen$(which doxygen) --open --with-dot詳細(xì)選項(xiàng)可查看doxybuild.py --help。倉庫中 Modules/Json/jsoncpp-master/doc 目錄已包含部分文檔構(gòu)建產(chǎn)物.dox、.html等。許可方面JsonCpp 采用 MIT 許可證在司法轄區(qū)認(rèn)可的情況下也可按公共領(lǐng)域public domain使用。完整條款見 Modules/Json/jsoncpp-master/LICENSE。在 GameAISDK 中該庫作為內(nèi)置第三方模塊存放于 Modules/Json與 boost、darknet、opencv、protobuf 等模塊并列均為項(xiàng)目依賴體系的一部分。贊分享人工智能強(qiáng)化學(xué)習(xí)計(jì)算機(jī)視覺游戲開發(fā)測試【免費(fèi)下載鏈接】GameAISDK基于圖像的游戲AI自動化框架項(xiàng)目地址https://gitcode.com/gh_mirrors/ga/GameAISDK點(diǎn)擊查看免費(fèi)下載相關(guān)推薦使用 VoltOps Deploy 零配置部署 VoltAgent 應(yīng)用GitHub 集成、自動構(gòu)建與托管基礎(chǔ)設(shè)施實(shí)戰(zhàn)指南使用 VoltOps Deploy 零配置部署 VoltAgent 應(yīng)用GitHub 集成、自動構(gòu)建與托管基礎(chǔ)設(shè)施實(shí)戰(zhàn)指南 VoltOps Deploy 是人工智能AI AgentAgent 框架后端多智能體RAG工具調(diào)用Agent 記憶Agent 工作流AI 評測MCP 服務(wù)MCP Clients語音xhyve與Kubernetes集成構(gòu)建容器化基礎(chǔ)設(shè)施的完整指南xhyve與Kubernetes集成構(gòu)建容器化基礎(chǔ)設(shè)施的完整指南 在現(xiàn)代云原生環(huán)境中 xhyve輕量級虛擬機(jī)管理程序 與Kubernetes的結(jié)合為開發(fā)者和虛擬化B站會員購搶票終極指南如何用Python自動化工具高效搶到熱門活動門票B站會員購搶票終極指南如何用Python自動化工具高效搶到熱門活動門票 當(dāng)Bilibili World、BML等熱門活動門票開售時你是否經(jīng)歷過 手動搶票失電商RPA上一篇gsy_github_app_flutter 的 AI 協(xié)作入口導(dǎo)航按任務(wù)類型路由到正確文檔路徑的工程實(shí)踐下一篇Bash-it 持續(xù)集成指南GitHub Actions CI 工作流與本地質(zhì)量檢查全解析創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考