假設安裝根目錄為 D:\OpenH323:
| 類型 | 加入路徑 |
|---|---|
| Include 檔案 | D:\OpenH323\Include |
| 執行檔 | D:\OpenH323\Lib |
| 庫檔案 | D:\OpenH323\Lib |
設定位置:Tools → Options → Directories
| 配置 | Debug 符號 | 追蹤日誌 | 輸出大小 | 適用場景 |
|---|---|---|---|---|
| Debug | 完整 | 完整 | 最大 | 開發除錯 |
| Release | 無 | 完整 | 中等 | 測試/生產 (需日誌) |
| No Trace | 無 | 無 | 最小 | 正式發布 (極致效能) |
注意:外掛 Codec (g726, gsm, speex 等) **僅支援 Release 配置**,且不可在運行時啟用除錯資訊。
| 專案名 | 說明 | Debug | Release | No Trace |
|---|---|---|---|---|
| OpenH323Lib | 靜態庫 | open323sd.lib | open323s.lib | open323sn.lib |
| OpenH323dll | 動態庫 | openh323d.lib | openh323.lib | openh323n.lib |
| g726 | G.726 Codec | N/A | g726codec.dll | N/A |
| gsm0610 | GSM 06.10 Codec | N/A | gsm0610.dll | N/A |
| ilbccodec | iLBC Codec | N/A | ilbccodec.dll | N/A |
| IMA_ADPCM | IMA ADPCM Codec | N/A | IMA_ADPCM.dll | N/A |
| Speex | Speex Codec | N/A | speexcodec.dll | N/A |
| LPC_10 | LPC-10 Codec | N/A | LPC_10.dll | N/A |
| VoiceAgeG729 | G.729 Codec | N/A | VoiceAgeG729.dll | N/A |
D:\OpenH323\OPENH323.dswWin32 ReleaseConfiguring Build Options Located ffmpeg RFC2190 AVCODEC Library at D:\rfc2190avcodec.dll\ Audio Software Codecs enabled Video System enabled ... Creating library... OpenH323s.lib - 0 error(s), 0 warning(s)
Merging exported library symbols MergeSym version 1.4.0 ... Linking... Creating library lib/OpenH323.lib and object lib/OpenH323.exp REBASE: Total Size of mapping 0x00570000 OpenH323.dll - 0 error(s), 0 warning(s)
samples 目錄,可自行開啟專案建置動態庫 (OpenH323dll) 建置需要 MergeSym,它會合併 PWLib Release 版的匯出符號。請確認:
MergeSym.exe (通常在 PWLib 的 bin 目錄)| 現象 | 可能原因 | 解決 |
|---|---|---|
| 找不到 PWLib 標頭/庫 | VC 目錄未正確設定 | 重新檢查 Tools→Options→Directories 三個路徑 |
| MergeSym 失敗 | PWLib 非 Release 版、或 MergeSym 不在 PATH | 重建 PWLib Release,將 MergeSym 目錄加入系統 PATH |
| Codec 專案連結錯誤 | 嘗試用 Debug/No Trace 建置 Codec | Codec 僅支援 Release,切換配置重建 |
| 視訊/音訊功能缺失 | 未啟用 ffmpeg / RFC2190 | 確認建置日誌出現 "ffmpeg RFC2190 AVCODEC Library enabled" |
OpenH323 編譯雖繁瑣,但遵循「先 PWLib、後 OpenH323、三種配置擇一、Codec 唯 Release、動態庫需 MergeSym」原則,即可穩定產出各類庫檔。建議建立批次腳本自動化建置流程,納入持續整合管線。