這是以 Python 的 ctypes 呼叫 DLL 內函式的主控台/終端機範例,僅支援 Windows。程式會載入 bin/R8_lib.dll,呼叫其中的 R8_GetLicenseType() 並將回傳值印出來。ctypes 是 Python 標準函式庫的一部分,因此不需要另外寫 C 的包裝程式就能直接呼叫 DLL。內附的 DLL 都是 win64 版本,其中 opencv_world420.dll 是 R8 函式庫所依賴的元件,因此一併附上。
[資料夾結構]
- CLAUDE.md / AGENT.md:程式規格書(內容相同)。
- CHANGELOG.md:變更紀錄。
- copyright.txt:版權聲明。
- bin/R8_lib.dll:範例要呼叫的 DLL,以及它所依賴的 opencv_world420.dll。
- src/:範例程式、啟動腳本與本說明文件。
- venv/:Python 虛擬環境,由步驟 1 建立。
[執行環境需求]
- 作業系統:Windows 11。內附的 DLL 是 win64 版本,因此本範例僅支援 Windows。
- Python 3 與 pip。
- 不需要任何第三方套件,ctypes 屬於標準函式庫。
- 不需要 GPU。
[操作步驟及說明]
步驟 1:建立虛擬環境
建立虛擬環境。因為範例只用標準函式庫,這一步不會安裝任何額外套件。
Windows 11:src\01_venv_create.bat
Ubuntu 24.04:bash src/01_venv_create.sh
步驟 2:啟用虛擬環境
啟用剛才建立的虛擬環境。Linux 請使用 source 的方式執行,否則環境變數不會套用到目前的終端機。
Windows 11:src\02_venv_activate.bat
Ubuntu 24.04:source src/02_venv_activate.sh
步驟 3:呼叫 DLL
載入 bin/R8_lib.dll,呼叫 R8_GetLicenseType() 並印出回傳結果。
Windows 11:src\03_dll_demo.bat
Ubuntu 24.04:bash src/03_dll_demo.sh
步驟 4:清除虛擬環境(選用)
不再需要時,可刪除 venv/ 資料夾以釋放磁碟空間。
Windows 11:src\99_venv_clear.bat
Ubuntu 24.04:bash src/99_venv_clear.sh
[使用說明]
- 本範例只能在 Windows 上執行,因為內附的 DLL 是 win64 版本。在 Linux 或 macOS 上執行時,腳本會以明確的訊息結束,而不是跳出難懂的錯誤。
- opencv_world420.dll 必須與 R8_lib.dll 放在同一個資料夾,它是 R8 函式庫執行時會載入的依賴元件。
這個 SDK 內建於 MYAI Studio 人工智慧開發工具。
單獨購買價格:5,000元,永久授權,單一 SDK 授權,單機授權,一次下載,無更新服務,一年電子郵件範例諮詢服務。如果是軟體客製化問題,請購買我們的客製化顧問服務點數。