Android中掃描多媒體檔案操作詳解

這篇文章從系統原始碼分析，講述如何將程式創建的多媒體檔案加入系統的媒體庫，如何從媒體庫刪除，以及大多數程式開發者經常遇到的無法添加到媒體庫的問題等。本人將透過對原始碼的分析，一一解釋這些問題。

Android中的多媒體檔案掃描機制

Android提供了一個很棒的程式來處理將多媒體檔案加入的媒體庫中。這個程式就是MediaProvider，現在我們簡單看以下這個程式。首先來看看它的Receiver

<receiver android:name="MediaScannerReceiver">
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.MEDIA_MOUNTED" />
        <data android:scheme="file" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.MEDIA_UNMOUNTED" />
        <data android:scheme="file" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.MEDIA_SCANNER_SCAN_FILE" />
        <data android:scheme="file" />
    </intent-filter>
</receiver>

MediaScannerReceiver只接收符合action和資料規則正確的intent。

MediaScannerReciever如何處理Intent

1.當且僅當接收到action android.intent.action.BOOT_COMPLETED才掃描內部儲存（非內建和外置sdcard）
2.除了action為android.intent.action.BOOT_COMPLE 的以外的intent都必須要有資料傳遞。
3.當收到 Intent.ACTION_MEDIA_MOUNTED intent，掃描Sdcard
4.收到 Intent.ACTION_MEDIA_SCANNER_SCAN_FILE intent，偵測沒有問題，將掃描單一檔案。

MediaScannerService如何運作

其實MediaScannerReceiver並不是真正處理掃描工作，它會啟動一個叫做MediaScannerService的服務。我們繼續看MediaProvider的manifest中關於service的部分。

<service android:name="MediaScannerService" android:exported="true">
       <intent-filter>
           <action android:name="android.media.IMediaScannerService" />
       </intent-filter>
   </service>

MediaScannerService中的scanFile方法

private Uri scanFile(String path, String mimeType) {
    String volumeName = MediaProvider.EXTERNAL_VOLUME;
    openDatabase(volumeName);
    MediaScanner scanner = createMediaScanner();
    return scanner.scanSingleFile(path, volumeName, mimeType);
}

MediaScannerService中的scan方法

private void scan(String[] directories, String volumeName) {
    // don't sleep while scanning
    mWakeLock.acquire();
    ContentValues values = new ContentValues();
    values.put(MediaStore.MEDIA_SCANNER_VOLUME, volumeName);
    Uri scanUri = getContentResolver().insert(MediaStore.getMediaScannerUri(), values);
    Uri uri = Uri.parse("file://" + directories[0]);
    sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_STARTED, uri));
    try {
        if (volumeName.equals(MediaProvider.EXTERNAL_VOLUME)) {
            openDatabase(volumeName);
        }
        MediaScanner scanner = createMediaScanner();
        scanner.scanDirectories(directories, volumeName);
    } catch (Exception e) {
        Log.e(TAG, "exception in MediaScanner.scan()", e);
    }
    getContentResolver().delete(scanUri, null, null);
    sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_FINISHED, uri));
    mWakeLock.release();
}

MediaScannerService中的createMediaScanner方法

private MediaScanner createMediaScanner() {
        MediaScanner scanner = new MediaScanner(this);
        Locale locale = getResources().getConfiguration().locale;
        if (locale != null) {
            String language = locale.getLanguage();
            String country = locale.getCountry();
            String localeString = null;
            if (language != null) {
                if (country != null) {
                    scanner.setLocale(language + "_" + country);
                } else {
                    scanner.setLocale(language);
                }
            }
        }
        return scanner;
}

MediaScannerService中的createMediaScanner方法。庫。

最簡單的方式

只需要發送一個正確的intent廣播到MediaScannerReceiver即可。

String saveAs = "Your_Created_File_Path"
Uri contentUri = Uri.fromFile(new File(saveAs));
Intent mediaScanIntent = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE,contentUri);
getContext().sendBroadcast(mediaScanIntent);

上面的極簡方法大多數情況下正常工作，但是有些情況下是不會工作的，稍後的部分會介紹。即使你使用上述方法成功了，還是建議你繼續閱讀稍後的為什麼發廣播不成功的部分。

使用MediaScannerConnection

public void mediaScan(File file) {
    MediaScannerConnection.scanFile(getActivity(),
            new String[] { file.getAbsolutePath() }, null,
            new OnScanCompletedListener() {
                @Override
                public void onScanCompleted(String path, Uri uri) {
                    Log.v("MediaScanWork", "file " + path
                            + " was scanned seccessfully: " + uri);
                }
            });
}

MediaScannerConnection的scanFile方法從2.2（API 8）開始引入。

建立一個MediaScannerConnection物件然後呼叫scanFile方法

很簡單，參考http://developer.android.com/reference/android/media/MediaScannerConnection.html

如何掃描多個檔案

1.發送多個檔案.ACTION_MEDIA_SCANNER_SCAN_FILE廣播

2.使用MediaScannerConnection，傳入要加入的路徑的陣列。

為什麼發送MEDIA_SCANNER_SCAN_FILE廣播不生效

關於為什麼有些設備上不生效，很多人認為是API原因，其實不是的，這其實和你傳入的文件路徑有關係。來看看接收者Receiver的onReceive程式碼。

public void onReceive(Context context, Intent intent) {
    String action = intent.getAction();
    Uri uri = intent.getData();
    if (action.equals(Intent.ACTION_BOOT_COMPLETED)) {
        // scan internal storage
        scan(context, MediaProvider.INTERNAL_VOLUME);
    } else {
        if (uri.getScheme().equals("file")) {
            // handle intents related to external storage
            String path = uri.getPath();
            String externalStoragePath = Environment.getExternalStorageDirectory().getPath();
            Log.d(TAG, "action: " + action + " path: " + path);
            if (action.equals(Intent.ACTION_MEDIA_MOUNTED)) {
                // scan whenever any volume is mounted
                scan(context, MediaProvider.EXTERNAL_VOLUME);
            } else if (action.equals(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE) &&
                    path != null && path.startsWith(externalStoragePath + "/")) {
                scanFile(context, path);
            }
        }
    }
}

所有的部分都正確除了傳入的路徑。因為你可能硬編碼了檔案路徑。因為有一個這樣的判斷path.startsWith(externalStoragePath + "/"),這裡我舉一個簡單的小例子。

final String saveAs = "/sdcard/" + System.currentTimeMillis() + "_add.png";
Uri contentUri = Uri.fromFile(new File(saveAs));
Intent mediaScanIntent = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE,contentUri);
getContext().sendBroadcast(mediaScanIntent);
Uri uri = mediaScanIntent.getData();
String path = uri.getPath();
String externalStoragePath = Environment.getExternalStorageDirectory().getPath();
Log.i("LOGTAG", "Androidyue onReceive intent= " + mediaScanIntent
                        + ";path=" + path + ";externalStoragePath=" +
                        externalStoragePath);

我們看一下輸出日誌，分析原因。

LOGTAG Androidyue onReceive intent= Intent { act=android.intent.action.MEDIA_SCANNER_SCAN_FILE dat=file:///sdcard/1390136305831_add.png };path=/sdcard/1390136305831_add.png;externalStoragePath=/mnt/sdcard

上述輸出分析，你發送的廣播，action是正確的，資料規則也是正確的，而且你的檔案路徑也是存在的，但是，檔案的路徑/sdcard/1390136305831_add.png並不是以外部儲存根路徑/mnt/sdcard/開頭。所以掃描操作沒有開始，導致檔案沒有加入到媒體庫。所以，請檢查文件的路徑。

如何從多媒體庫中移除

如果我們刪除一個多媒體檔案的話，也就意味我們還需要將這個檔案從媒體庫中刪除掉。

能不能簡簡單單發廣播？

僅發一個廣播能解決問題麼？我倒是希望可以，但是實際上是不工作的，請查看如下程式碼即可明白。

// this function is used to scan a single file
public Uri scanSingleFile(String path, String volumeName, String mimeType) {
    try {
        initialize(volumeName);
        prescan(path, true);
        File file = new File(path);
        if (!file.exists()) {
            return null;
        }
        // lastModified is in milliseconds on Files.
        long lastModifiedSeconds = file.lastModified() / 1000;
        // always scan the file, so we can return the content://media Uri for existing files
        return mClient.doScanFile(path, mimeType, lastModifiedSeconds, file.length(),
                false, true, MediaScanner.isNoMediaPath(path));
    } catch (RemoteException e) {
        Log.e(TAG, "RemoteException in MediaScanner.scanFile()", e);
        return null;
    }
}

正如上述程式碼，會對檔案是否存在進行檢查，如果檔案不存在，直接停止向下執行。所以這樣是不行的。那怎麼辦呢？

public void testDeleteFile() {
    String existingFilePath = "/mnt/sdcard/1390116362913_add.png";
    File  existingFile = new File(existingFilePath);
    existingFile.delete();
    ContentResolver resolver = getActivity().getContentResolver();
    resolver.delete(Images.Media.EXTERNAL_CONTENT_URI, Images.Media.DATA + "=?", new String[]{existingFilePath});

    }

上述程式碼是可以運作的，直接從MediaProvider刪除即可。 具體的刪除代碼請參考Code Snippet for Media on Android

One More Thing

更多Android中掃描多媒體文件操作詳解相關文章請關注PHP中文網！