人工智能強(qiáng)化學(xué)習(xí)計(jì)算機(jī)視覺(jué)游戲開(kāi)發(fā)測(cè)試【免費(fèi)下載鏈接】GameAISDK基于圖像的游戲AI自動(dòng)化框架項(xiàng)目地址https://gitcode.com/gh_mirrors/ga/GameAISDK點(diǎn)擊查看免費(fèi)下載本指南以 GameAISDK 倉(cāng)庫(kù)內(nèi)置的 JsonCpp 源碼Modules/Json/jsoncpp-master為主體系統(tǒng)講解這個(gè) C JSON 庫(kù)的核心能力、三種集成方式、完整構(gòu)建流程與測(cè)試體系并深入剖析它在 GameAISDK 圖像處理模塊中承擔(dān)的任務(wù)配置解析職責(zé)。讀完本文你將掌握 JsonCpp 的單一源碼文件集成amalgamation、CMake/Conan/SCons 構(gòu)建、Reader/Writer 測(cè)試用例編寫以及如何用Json::Reader與Json::Value在真實(shí)項(xiàng)目中讀取 JSON 配置。JsonCpp 是什么輕量級(jí)數(shù)據(jù)交換格式的 C 實(shí)現(xiàn)JSONJavaScript Object Notation是一種輕量級(jí)的數(shù)據(jù)交換格式它可以表示數(shù)字numbers、字符串strings、有序的值序列ordered sequences of values以及名稱/值對(duì)的集合collections of name/value pairs。在 AI 游戲自動(dòng)化這類需要大量結(jié)構(gòu)化配置任務(wù)列表、識(shí)別規(guī)則、動(dòng)作參數(shù)的項(xiàng)目中JSON 憑借其可讀性與通用性成為配置存儲(chǔ)的首選。JsonCpp 是一個(gè) C 庫(kù)允許開(kāi)發(fā)者操作 JSON 值包括與字符串之間的序列化serialization和反序列化deserialization。它還有一個(gè)實(shí)用特性在反序列化/序列化過(guò)程中可以保留原有注釋這使得它特別適合用來(lái)存儲(chǔ)用戶輸入文件——因?yàn)榕渲梦募械淖⑨屚情_(kāi)發(fā)者留給后來(lái)者的重要說(shuō)明不應(yīng)在解析重寫后丟失。倉(cāng)庫(kù)中該庫(kù)的完整源碼位于 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五個(gè)核心頭文件即「值模型 讀取器 寫入器 特性開(kāi)關(guān)」的完整 API 面。版本策略與向后兼容性JsonCpp 的版本策略在其 README 中有明確約定1.y.z系列基于 C11 構(gòu)建0.y.z系列可用于更老舊的編譯器主版本major version之間維持二進(jìn)制兼容binary-compatibility。在倉(cāng)庫(kù)的 CMakeLists.txt 中可以看到實(shí)際版本被定義為1.8.1對(duì)應(yīng)的JSONCPP_SOVERSION共享庫(kù)版本號(hào)為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」的說(shuō)明完全一致。因此將 JsonCpp 集成進(jìn) GameAISDK 這類使用現(xiàn)代 C 的項(xiàng)目時(shí)不存在語(yǔ)言標(biāo)準(zhǔn)層面的兼容障礙。在項(xiàng)目中集成 JsonCpp 的推薦方式方式一使用 amalgamated 單一源碼文件官方推薦README 明確推薦的做法是將amalgamated source一個(gè).cpp文件加兩個(gè).h文件直接加入你的項(xiàng)目像編譯任何普通源文件一樣參與編譯。這樣做的好處是保證編譯標(biāo)志compilation flags的一致性避免共享庫(kù)/靜態(tài)庫(kù)構(gòu)建時(shí)常見(jiàn)的 ABI 兼容性問(wèn)題。同時(shí)需要把include/目錄加入編譯器的 include 路徑并按下述方式包含頭文件#include json/json.h如果在 Windows 上以動(dòng)態(tài)庫(kù)方式構(gòu)建 JsonCpp那么使用方項(xiàng)目還需定義宏JSON_DLL該宏由 autolink.h 配合使用用于處理 Windows 下 DLL 的導(dǎo)入/導(dǎo)出符號(hào)標(biāo)記。生成 amalgamated 源碼與頭文件JsonCpp 自帶生成腳本 amalgamate.py。在倉(cāng)庫(kù)頂層目錄即Modules/Json/jsoncpp-master/執(zhí)行以下命令即可隨時(shí)生成腳本同時(shí)兼容 Python 2.6 與 Python 3.4python amalgamate.py腳本支持通過(guò)-h查看全部選項(xiàng)核心參數(shù)如下來(lái)自 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)情況下會(huì)生成三個(gè)文件dist/jsoncpp.cpp需要加入項(xiàng)目的源文件dist/json/json.h對(duì)應(yīng)非 amalgamated 源碼中的json/json.h該頭文件只依賴標(biāo)準(zhǔn)頭文件dist/json/json-forwards.h提供所有 JsonCpp 類型的前置聲明forward declaration適合用來(lái)減少編譯依賴。其實(shí)現(xiàn)原理見(jiàn) amalgamate.py腳本按正確順序拼接 JsonCpp 的各個(gè)源文件——依次是src/lib_json/json_tool.h、json_reader.cpp、json_valueiterator.inl、json_value.cpp、json_writer.cpp并定義宏JSON_IS_AMALGAMATION以阻止內(nèi)部再包含其他私有頭文件。如果編譯時(shí)未提供該宏amalgamated 源碼會(huì)通過(guò)#error Compile with -I PATH_TO_JSON_DIRECTORY直接報(bào)錯(cuò)防止誤用。方式二傳統(tǒng)庫(kù)構(gòu)建集成若希望以靜態(tài)庫(kù)/共享庫(kù)方式鏈接可參考下文「構(gòu)建 JsonCpp」章節(jié)。倉(cāng)庫(kù)內(nèi)Modules/Json/lib/Windows/下已提供預(yù)編譯的 Windows.lib文件而Modules/Json/lib/Linux/目錄為空Linux 平臺(tái)需要自行構(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 測(cè)試還需要 Python若缺失構(gòu)建會(huì)跳過(guò)這些測(cè)試。倉(cāng)庫(kù)根 CMakeLists.txt 提供了豐富的構(gòu)建開(kāi)關(guān)關(guān)鍵選項(xiàng)整理如下選項(xiàng)默認(rèn)值說(shuō)明BUILD_SHARED_LIBSOFF構(gòu)建共享庫(kù)動(dòng)態(tài)庫(kù)BUILD_STATIC_LIBSON構(gòu)建靜態(tài)庫(kù)JSONCPP_WITH_TESTSON編譯 JsonCpp 測(cè)試可執(zhí)行文件JSONCPP_WITH_POST_BUILD_UNITTESTON作為構(gòu)建后步驟自動(dòng)運(yùn)行單元測(cè)試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時(shí)為 STL 啟用清空內(nèi)存的分配器使用cmake-gui的可視化步驟如下將「source code」指向源碼目錄「where to build the binary」指向構(gòu)建目錄勾選「Grouped」分組查看選項(xiàng)按需勾選BUILD_SHARED_LIBS構(gòu)建動(dòng)態(tài)庫(kù)點(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可查看所有可用的生成器通過(guò)-G指定如 Visual Studio 版本、32/64 位解決方案等CMake 默認(rèn)隱藏編譯命令生成 Makefiles 時(shí)加-DCMAKE_VERBOSE_MAKEFILEtrue即可顯示從 CMakeLists.txt 可見(jiàn)JSONCPP_WITH_TESTS與JSONCPP_WITH_POST_BUILD_UNITTEST默認(rèn)開(kāi)啟構(gòu)建時(shí)會(huì)一并產(chǎn)出測(cè)試可執(zhí)行文件。使用 Conan 構(gòu)建Conan 是面向 C/C 的開(kāi)源包管理器跨平臺(tái)且與構(gòu)建系統(tǒng)無(wú)關(guān)。它需要 Python可用pip install conan安裝。使用 Conan 需要?jiǎng)?chuàng)建conanfile.txt簡(jiǎn)單或conanfile.py更靈活。README 中給出的conanfile.txt示例[requires] jsoncpp/1.8.0theirix/ci [generators] cmake然后在 conanfile 所在目錄執(zhí)行conan install --build missing該命令會(huì)嘗試從配方倉(cāng)庫(kù)下載與當(dāng)前設(shè)置OS、編譯器、架構(gòu)匹配的包找不到則本地構(gòu)建。注意cmake 生成器并非必需可換用其他集成方式或通過(guò) virtualenv generators 設(shè)置環(huán)境變量即便不使用 Conan 的 cmake 生成器也不需要手動(dòng)安裝 cmake——配方會(huì)自動(dòng)下載。使用 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)境。測(cè)試體系手動(dòng)測(cè)試、測(cè)試用例編寫與輸出解讀運(yùn)行測(cè)試僅當(dāng)排查問(wèn)題troubleshooting時(shí)才需要手動(dòng)運(yùn)行測(cè)試。以下命令中請(qǐng)將path/to/jsontest替換為你平臺(tái)實(shí)際編譯出的jsontest可執(zhí)行文件路徑cd test # 運(yùn)行 Reader/Writer 測(cè)試 python runjsontests.py path/to/jsontest # 使用 JSONChecker 測(cè)試套件運(yùn)行 Reader/Writer 測(cè)試 # 注意并非所有用例都能通過(guò)——JsonCpp 目前解析過(guò)于寬松 # 例如允許整數(shù)以 0 開(kāi)頭目標(biāo)是改進(jìn)嚴(yán)格模式解析使全部用例通過(guò) python runjsontests.py --with-json-checker path/to/jsontest # 運(yùn)行單元測(cè)試主要是 Value 相關(guān) python rununittests.py path/to/test_lib_json # 使用 valgrind 運(yùn)行單元測(cè)試 python rununittests.py --valgrind path/to/test_lib_json使用 SCons 時(shí)可通過(guò)check目標(biāo)運(yùn)行測(cè)試scons platform$PLATFORM check測(cè)試腳本位于 Modules/Json/jsoncpp-master/test/包括runjsontests.py、rununittests.py、pyjsontestrunner.py等測(cè)試輸入數(shù)據(jù)在test/data/目錄下倉(cāng)庫(kù)共有 94 個(gè).json與 56 個(gè).expected文件。添加一個(gè) reader/writer 測(cè)試在test/data下新增測(cè)試需要兩個(gè)文件TESTNAME.jsonJSON 格式的輸入文檔TESTNAME.expected輸入文檔的扁平化flattened表示。TESTNAME.expected文件格式規(guī)則README 原文要點(diǎn)每一行代表輸入文檔元素樹(shù)中的一個(gè) JSON 元素每行由「訪問(wèn)元素的路徑」 「元素值」兩部分組成數(shù)組和對(duì)象的值始終為空即[]或{}元素路徑中.代表根元素同時(shí)用于分隔對(duì)象成員[N]表示數(shù)組中索引為N的元素。以倉(cāng)庫(kù)中的 test/data/test_complex_01.json 為例它包含嵌套對(duì)象、字符串?dāng)?shù)組與混合類型數(shù)組其對(duì)應(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ù)組每個(gè)元素單獨(dú)一行[0]、[1]…嵌套對(duì)象如name、test.1.2.3只展開(kāi)為{}并在下一行繼續(xù)其成員數(shù)組coord則按[0]、[1]展開(kāi)。理解 reader/writer 測(cè)試輸出測(cè)試運(yùn)行時(shí)會(huì)緊鄰輸入文件生成輸出文件README 對(duì)各文件的含義說(shuō)明如下test_complex_01.json輸入 JSON 文檔test_complex_01.expected用于校驗(yàn)解析正確性的扁平化元素樹(shù)test_complex_01.actualjsontest讀取test_complex_01.json后生成的扁平化元素樹(shù)test_complex_01.rewritejsontest將解析得到的Json::Value用Json::StyledWritter序列化后寫出的 JSON 文檔test_complex_01.actual-rewritejsontest讀取test_complex_01.rewrite后生成的扁平化元素樹(shù)test_complex_01.process-outputjsontest的輸出通常用于理解解析錯(cuò)誤的原因。這一「expected / actual / rewrite / actual-rewrite」的對(duì)照設(shè)計(jì)使開(kāi)發(fā)者既能驗(yàn)證解析正確性又能驗(yàn)證「讀-寫-再讀」的往返一致性round-trip這正是保留注釋特性的測(cè)試保障。實(shí)戰(zhàn)佐證JsonCpp 在 GameAISDK 中的配置解析應(yīng)用JsonCpp 在 GameAISDK 中并非僅僅作為第三方依賴存在而是直接支撐了圖像識(shí)別模塊的 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→ 打開(kāi)二進(jìn)制輸入流 →reader.parse(in, m_root)將 JSON 文檔解析進(jìn)成員Json::Value m_root。這與 README 描述的「反序列化到字符串/流」能力完全對(duì)應(yīng)。隨后的讀取接口展示了Json::Value的典型用法GetDataJsonConfig.cpp通過(guò)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ù)組元素個(gè)數(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è)子模塊采用其構(gòu)建文件如 src/ImgProc/GameRecognize/Makefile.am、src/ImgProc/GameRecognize/Windows/GameReg.vcxproj 均顯式引用 jsoncpp說(shuō)明 JsonCpp 是貫穿整個(gè)圖像處理管線的公共基礎(chǔ)設(shè)施。構(gòu)建文檔與許可說(shuō)明如需生成 JsonCpp 的 Doxygen 文檔在頂層目錄運(yùn)行python doxybuild.py --doxygen$(which doxygen) --open --with-dot詳細(xì)選項(xiàng)可查看doxybuild.py --help。倉(cāng)庫(kù)中 Modules/Json/jsoncpp-master/doc 目錄已包含部分文檔構(gòu)建產(chǎn)物.dox、.html等。許可方面JsonCpp 采用 MIT 許可證在司法轄區(qū)認(rèn)可的情況下也可按公共領(lǐng)域public domain使用。完整條款見(jiàn) Modules/Json/jsoncpp-master/LICENSE。在 GameAISDK 中該庫(kù)作為內(nèi)置第三方模塊存放于 Modules/Json與 boost、darknet、opencv、protobuf 等模塊并列均為項(xiàng)目依賴體系的一部分。贊分享人工智能強(qiáng)化學(xué)習(xí)計(jì)算機(jī)視覺(jué)游戲開(kāi)發(fā)測(cè)試【免費(fèi)下載鏈接】GameAISDK基于圖像的游戲AI自動(dòng)化框架項(xiàng)目地址https://gitcode.com/gh_mirrors/ga/GameAISDK點(diǎn)擊查看免費(fèi)下載相關(guān)推薦使用 VoltOps Deploy 零配置部署 VoltAgent 應(yīng)用GitHub 集成、自動(dòng)構(gòu)建與托管基礎(chǔ)設(shè)施實(shí)戰(zhàn)指南使用 VoltOps Deploy 零配置部署 VoltAgent 應(yīng)用GitHub 集成、自動(dòng)構(gòu)建與托管基礎(chǔ)設(shè)施實(shí)戰(zhàn)指南 VoltOps Deploy 是人工智能AI AgentAgent 框架后端多智能體RAG工具調(diào)用Agent 記憶Agent 工作流AI 評(píng)測(cè)MCP 服務(wù)MCP Clients語(yǔ)音xhyve與Kubernetes集成構(gòu)建容器化基礎(chǔ)設(shè)施的完整指南x(chóng)hyve與Kubernetes集成構(gòu)建容器化基礎(chǔ)設(shè)施的完整指南 在現(xiàn)代云原生環(huán)境中 xhyve輕量級(jí)虛擬機(jī)管理程序 與Kubernetes的結(jié)合為開(kāi)發(fā)者和虛擬化B站會(huì)員購(gòu)搶票終極指南如何用Python自動(dòng)化工具高效搶到熱門活動(dòng)門票B站會(huì)員購(gòu)搶票終極指南如何用Python自動(dòng)化工具高效搶到熱門活動(dòng)門票 當(dāng)Bilibili World、BML等熱門活動(dòng)門票開(kāi)售時(shí)你是否經(jīng)歷過(guò) 手動(dò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），僅供參考