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_completed 的以外的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;
}
从上面可以发现，真正工作的其实是android.media.mediascanner.java 具体扫描过程就请点击左侧链接查看。
如何扫描一个刚创建的文件
这里介绍两种方式来实现将新创建的文件加入媒体库。
最简单的方式
只需要发送一个正确的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.发送多个intent.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
你可以通过查看/data/data/com.android.providers.media/databases/external.db(不同系统略有不同)文件可以了解更多的信息。