CSipSimple 專案麥克風預設音量設定位置說明

CSipSimple 為開源 SIP 客戶端專案，音量相關設定分散於多層配置與程式碼中。若修改 prefs_media.xml 後預設值不生效，需按優先級順序排查：

設定優先級層級（由高到低）

1. 程式碼硬編碼預設值：MediaManager、AudioManager 相關類別建構子或 init() 中的 setDefaultVolume() 呼叫。
2. SharedPreferences 實際儲存值：使用者曾調整過音量，系統會寫入 SharedPreferences，優先於 XML 預設值。
3. XML 預設值定義：res/xml/prefs_media.xml 中 android:defaultValue 屬性。
4. Codec/硬體層限制：音訊編解碼器（如 Opus、G.722）或硬體 HAL 可能限制增益範圍。

排查步驟

// 1. 搜尋程式碼中的預設音量常數
grep -r "DEFAULT_MIC_VOLUME" --include="*.java" .
grep -r "setMicrophoneGain" --include="*.java" .

// 2. 檢查 SharedPreferences 實際值
adb shell
run-as com.csipsimple
cat shared_prefs/com.csipsimple_preferences.xml | grep mic_volume

// 3. 確認 prefs_media.xml 定義
<ListPreference
    android:key="mic_volume"
    android:defaultValue="5"  <!-- 確認此值 -->
    android:entries="@array/mic_volume_entries"
    android:entryValues="@array/mic_volume_values" />

常見問題與對策

建議除錯流程

1. 全新安裝 App，驗證 XML 預設值是否生效。
2. 在 MediaManager.setMicrophoneGain() 下斷點，觀察實際傳入值。
3. 使用 adb logcat | grep -i "volume\|gain\|mic" 追蹤運行時邏輯。

CSipSimple 架構複雜，音量鏈路涉及 UI 設定 → SharedPreferences → MediaManager → AudioTrack/Record → Codec → HAL 多層，建議由上而下系統性排查。