Android 媒體存儲服務（一）

Android 媒體存儲服務

 

本文介紹如何在 Android 中，開發者的 APP 如何使用媒體存儲服務（包含MediaScanner、MediaProvider以及媒體信息解析等部分），包括如何把 APP 新增或修改的文件更新到媒體數據庫、如何在多媒體應用中隱藏 APP 產生的文件、如何監聽媒體數據庫的變化等等。

 

簡介：
本文介紹如何在 Android 中，開發者的 APP 如何使用媒體存儲服務（包含MediaScanner、MediaProvider以及媒體信息解析等部分），包括如何把 APP 新增或修改的文件更新到媒體數據庫、如何在多媒體應用中隱藏 APP 產生的文件、如何監聽媒體數據庫的變化等等。
Android 原生有一套媒體存儲服務，進程名是 android.process.media，主要負責把磁盤中的文件信息保存到數據庫當中，供其餘 APP 使用以及 MTP 模式使用。所以 APP 能夠隨時快速查詢到機器上有多少音樂，音樂的時長、標題、藝術家、專輯封面均可以獲取到。下面就介紹咱們開發的 APP 如何與這個媒體存儲服務打交道。
Note：MTP 模式是 Android 3.0 開始引入的，其數據來源於媒體存儲服務。
隱藏多媒體文件
應用場景：APP 產生了圖片/音樂/視頻類文件，不想讓它顯示在圖庫/音樂播放器。市面上有很多遊戲，它的圖片和音效文件沒有作隱藏，出如今用戶的圖庫/音樂播放器當中，引發用戶反感。若是用戶把它刪除了，又可能會影響 APP 正常運行。

方法一：把文件設爲隱藏。Linux 裏文件前加點就是隱藏，例如「文件A」改爲「.文件A」。或者把文件擴展名去掉，這樣媒體存儲服務掃描時就不會將其看成多媒體文件。
方法二：在文件夾下生成一個名爲「.nomedia」的空白文件。這樣同一個文件夾下的全部文件都不會被看成多媒體文件。

1.添加/修改多媒體文件
        應用場景：APP 建立了一個新的多媒體文件，或者修改了一個已有多媒體文件。例如 APP 下載了一個音樂文件，須要通知媒體存儲服務，用戶就能在音樂播放器中看到這個文件。不然，只有下次媒體存儲服務開始掃描整個磁盤，纔會發現 APP 產生的新文件。

方法一
若是隻有一個文件，而且不須要獲得結果返回，直接發 Intent 通知媒體存儲服務便可。

複製代碼 代碼以下:

import java.io.File;
import android.content.Context;
import android.content.Intent;
import android.net.Uri;

private static void requestScanFile(Context context, File file) {
    Intent i = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE);
    i.setData(Uri.fromFile(file));
    context.sendBroadcast(i);
}

private static void requestScanFile(Context context, String file) {
    Intent i = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE);
    i.setData(Uri.parse("file://" + Uri.encode(file)));
    context.sendBroadcast(i);
}

Note： 若是使用 Uri.parse() 從文件名生成 Uri，文件名必需要先 Uri.encode()，做用是把保留字符轉義。例如文件名若包含「?」，不通過 Uri.encode 轉義的話會被看成是查詢參數，這樣 uri.getPath() 獲取的文件路徑會丟失「?」以後的部分。

方法二
若是隻有一個文件，而且須要文件 uri 結果返回，則使用回調函數。

複製代碼 代碼以下:

import android.media.MediaScannerConnection;
import android.net.Uri;

private void requestScanFile(Context context, String file) {
    MediaScannerConnection.scanFile(context, new String[] {file},
        null, // mime types，可不指定
        mListener);
}

MediaScannerConnection.OnScanCompletedListener mListener =
        new MediaScannerConnection.OnScanCompletedListener() {
    public void onScanCompleted(String path, Uri uri) {
        // TODO: 獲取到該文件在多媒體數據庫中的 uri，進行下一步動做
    }
};

Note：還有一種方法，能夠先往多媒體數據庫插入一條包含文件路徑的記錄，插入後能夠獲得其 uri；而後再使用方法一通知媒體存儲服務掃描此文件，把文件信息（如專輯名）補充完整。但不推薦使用這種方法，由於得到 uri 時文件信息並不完整。

方法三
若是文件較多，則發 Intent 通知媒體存儲服務掃描整個磁盤。這種作法不是特別好，但又沒發現其餘更好的接口。第三方文件管理如「ES 文件管理器」就是使用這種方法的。

複製代碼 代碼以下:

import android.content.Context;
import android.content.Intent;
import android.net.Uri;

private static void requestScanDisk(Context context) {
    Intent i = new Intent(Intent.ACTION_MEDIA_MOUNTED);
    String path = Environment.getExternalStorageDirectory().getPath();
    i.setData(Uri.parse("file://" + Uri.encode(path)));
    context.sendBroadcast(i);
}

2.監聽數據變化
         應用場景：多媒體數據庫有變化，須要刷新 APP 顯示界面。比較好理解，磁盤中的多媒體文件有新增、刪除或者修改，APP 界面上要實時反應這些變化，刷新顯示界面。

方法一
監聽媒體存儲相關 Intent。接受到 Intent 後，從新查詢一次數據庫。咱們須要注意的 Intent 主要有如下幾個：
一、Intent.ACTION_MEDIA_SCANNER_FINISHED: 媒體存儲服務掃描整個磁盤完成後會發這個 Intent。可能有新增較多文件或者被刪除。
二、Intent.ACTION_MEDIA_SCANNER_SCAN_FILE: 媒體存儲服務掃描單個文件。

複製代碼 代碼以下:

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.net.Uri;

private void registerReceiver(Context context) {
    IntentFilter filter = new IntentFilter(Intent.ACTION_MEDIA_MOUNTED);
    filter.addAction(Intent.ACTION_MEDIA_SCANNER_FINISHED);
    filter.addAction(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE);
    filter.addDataScheme("file");
    context.registerReceiver(mReceiver, filter);
}

private BroadcastReceiver mReceiver = new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        Uri uri = intent.getData();
        if (uri != null && uri.getScheme().equals("file")) {
            Log.v("Receiver", "BroadcastReceiver action = " + action + ", uri = " + uri);
            if (Intent.ACTION_MEDIA_SCANNER_SCAN_FILE.equals(action)) {
                String filePath = uri.getPath();
                // TODO: filePath 文件已改變，APP 刷新界面
            } else if (Intent.ACTION_MEDIA_SCANNER_FINISHED.equals(action)) {
                // TODO: 整個磁盤掃描完成，APP 刷新界面
            }
        }
    }
};

另 外，在 Intent.MEDIA_SCANNER_STARTED 和 Intent.ACTION_MEDIA_SCANNER_FINISHED 之間的時間裏，媒體存儲服務正在掃描文件，數據庫會有變化，因此只有在收到 Intent.ACTION_MEDIA_SCANNER_FINISHED 以後查詢的結果纔是準確的。若是要檢測媒體存儲服務是否在掃描能夠用如下方法：

複製代碼 代碼以下:

import android.content.ContentResolver;
import android.database.Cursor;
import android.os.Environment;
import android.provider.MediaStore;

private static boolean isMediaScannerScanning(ContentResolver cr) {
    Cursor cursor = null;
    try {
        cursor = cr.query(MediaStore.getMediaScannerUri(), new String[] {
            MediaStore.MEDIA_SCANNER_VOLUME}, null, null, null);

        if (cursor != null && cursor.getCount() > 0) {
            cursor.moveToFirst();
            return "external".equals(cursor.getString(0));
        }
    } finally {
        if (cursor != null) {
            cursor.close();
        }
    }

    return false;
}

Note：APP 可能還須要監聽存儲設備的變化，例如 SD 卡拔出、磁盤掛載出去（USB 大容量存儲模式）等等，這些狀況下可能要把文件顯示界面清空，或者退出程序。各個手機對於每一個 Intent 定義可能略有不一樣，但基本上是如下幾個：
一、Intent.ACTION_MEDIA_EJECT: 存儲設備正常移除，例如在設置裏卸載存儲器。
二、Intent.ACTION_MEDIA_UNMOUNTED: 存儲設備正常卸載，一般與 EJECT 前後出現。
三、Intent.ACTION_MEDIA_BAD_REMOVAL: 非正常移除存儲設備，例如硬插拔 SD 卡。

方法二
監聽數據庫變化。若是須要在數據庫發生變化時能實時接收到通知，可使用 ContentObserver。

複製代碼 代碼以下:

import android.content.Context;
import android.database.ContentObserver;
import android.database.Cursor;
import android.net.Uri;

private ContentObserver mContentObserver = new ContentObserver(null) {
    @Override
    public void onChange(boolean selfChange) { // 日後兼容
        onChange(selfChange, null);
    }

    public void onChange(boolean selfChange, Uri uri) {
        // TODO: 數據已改變，APP 從新查詢數據庫並刷新界面
    }
};

private void setupCursor(Context context, Cursor c) {
    c.unregisterContentObserver(mContentObserver); // c 爲須要顯示的數據
}

此外，使用 CursorAdapter 和顯示的 ListView 綁定，也能夠達到一樣目的。當 Cursor 內容發現變化，ListView 也會相應自動刷新。