Android 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”的空白文件。这样同一个文件夹下的所有文件都不会被当作多媒体文件。
添加/修改多媒体文件
应用场景：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);
}
监听数据变化
应用场景：多媒体数据库有变化，需要刷新 app 显示界面。比较好理解，磁盘中的多媒体文件有新增、删除或者修改，app 界面上要实时反应这些变化，刷新显示界面。
方法一
监听媒体存储相关 intent。接受到 intent 后，重新查询一次数据库。我们需要注意的 intent 主要有以下几个：
1、intent.action_media_scanner_finished: 媒体存储服务扫描整个磁盘完成后会发这个 intent。可能有新增较多文件或者被删除。
2、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 定义可能略有不同，但基本上是以下几个：
1、intent.action_media_eject: 存储设备正常移除，例如在设置里卸载存储器。
2、intent.action_media_unmounted: 存储设备正常卸载，通常与 eject 先后出现。
3、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 也会相应自动刷新。