Android 視頻播放失敗排查：3gp 與 mp4 差異及路徑問題

常見現象

使用 VideoView 或 MediaPlayer 播放本地視頻時，提示「視頻不存在」或「無法播放」，即使代碼邏輯正確。

核心排查步驟

1. 驗證文件路徑正確性

最常見原因是路徑錯誤。請按以下優先級嘗試：

// 1. 絕對路徑（需運行時權限）
String path = "/sdcard/Download/test.mp4"; 

// 2. 應用私有目錄（無需權限）
String path = getFilesDir() + "/test.mp4";

// 3. 原始資源目錄
String path = "android.resource://" + getPackageName() + "/" + R.raw.test;

// 4. 網絡視頻驗證編碼器支持
String url = "https://example.com/test.mp4";

2. 格式兼容性對比

建議：統一使用 MP4 (H.264 Baseline Profile + AAC LC)，兼容性最佳。

3. 關鍵代碼檢查清單

VideoView videoView = findViewById(R.id.videoView);
// 必須設置 MediaController 才能顯示控制條
videoView.setMediaController(new MediaController(this));

// 設置路徑
videoView.setVideoPath(localPath); // 或 setVideoURI(Uri.parse(url))

// 關鍵：設置準備完成監聽器，捕獲錯誤
videoView.setOnPreparedListener(mp -> {
    videoView.start();
});

videoView.setOnErrorListener((mp, what, extra) -> {
    Log.e("VideoError", "what=" + what + ", extra=" + extra);
    // what=1: 未知錯誤; what=-38: 文件不存在/路徑錯誤
    return true; // 消費錯誤，不顯示默認對話框
});

調試技巧

1. 先播網絡視頻：若網絡視頻正常，說明播放器配置無誤，問題在本地文件路徑或文件損壞。
2. 文件管理器驗證：用手機自帶播放器嘗試打開該文件，若也失敗則文件損壞或格式不支持。
3. 檢查存儲權限：Android 10+ 訪問共享存儲需 MANAGE_EXTERNAL_STORAGE 或使用 MediaStore API。

總結

90% 的「視頻不存在」實為 路徑錯誤或權限不足。優先用網絡視頻驗證播放器，再排查本地路徑；統一採用 MP4 格式，配合 OnErrorListener 精確定位錯誤碼。