MediaScanner
2011-01-25 13:14 cppguy 阅读(1353) 评论(0) 编辑 收藏 举报原作者：Steve Gou 转载请注明！
下面是系统 图
MediaScannerReceiver 会在任何的 ACTION_BOOT_COMPLETED, ACTION_MEDIA_MOUNTED 或 ACTION_MEDIA_SCANNER_SCAN_FILE 意图（ intent ）发出的时候启动。因为解析媒体文件 的元数据 或许会需要很长时间 ，所以 MediaScannerReceiver 会启动 MediaScannerService 。
MediaScannerService 调用一个公用类 MediaScanner 去处理真正的工作。 MediaScannerReceiver 维持两种扫描目录：一种是内部卷（ internal volume ）指向 $(ANDROID_ROOT)/media. 另一种是外部卷（ external volume ）指向 $(EXTERNAL_STORAGE).
扫描和解析工作位于 JAVA 层和 C++ 层。 JAVA 层是启动器。 MediaScanner 扫描所有目录，如下步骤：
1.JAVA 层初始化
在这一步骤中，它会根据目录是在内部卷还是外部卷打开不同的数据库 。
2.Java 层预扫描
首先清除文件和播放 列表的缓存条目。然后根据 MediaProvider 返回的请求结果生成新文件和播放列表缓存条目。
3.C++ 层处理目录
列举出所有文件和特定的所有子目录（如果子目录包含一个 .nomedia 隐藏文件，则不会被列举出来。）。被列举的文件是根据文件扩展来判断文件是否被支持。如果支持这种文件扩展， C++ 层就会回调到 JAVA 层扫描文件。这种扩展就会被扫描到 MediaFile.java 中列出。下面是支持的文件扩展列表。
/* Audio */
addFileType("MP3", FILE_TYPE_MP3, "audio/mpeg");
addFileType("M4A", FILE_TYPE_M4A, "audio/mp4");
addFileType("WAV", FILE_TYPE_WAV, "audio/x-wav");
addFileType("AMR", FILE_TYPE_AMR, "audio/amr");
addFileType("AWB", FILE_TYPE_AWB, "audio/amr-wb");
addFileType("WMA", FILE_TYPE_WMA, "audio/x-ms-wma");
addFileType("OGG", FILE_TYPE_OGG, "application/ogg");
addFileType("MID", FILE_TYPE_MID, "audio/midi");
addFileType("XMF", FILE_TYPE_MID, "audio/midi");
addFileType("RTTTL", FILE_TYPE_MID, "audio/midi");
addFileType("SMF", FILE_TYPE_SMF, "audio/sp-midi");
addFileType("IMY", FILE_TYPE_IMY, "audio/imelody");
/* Video */
addFileType("MP4", FILE_TYPE_MP4, "video/mp4");
addFileType("M4V", FILE_TYPE_M4V, "video/mp4");
addFileType("3GP", FILE_TYPE_3GPP, "video/3gpp");
addFileType("3GPP", FILE_TYPE_3GPP, "video/3gpp");
addFileType("3G2", FILE_TYPE_3GPP2, "video/3gpp2");
addFileType("3GPP2", FILE_TYPE_3GPP2, "video/3gpp2");
addFileType("WMV", FILE_TYPE_WMV, "video/x-ms-wmv");
/* Image */
addFileType("JPG", FILE_TYPE_JPEG, "image/jpeg");
addFileType("JPEG", FILE_TYPE_JPEG, "image/jpeg");
addFileType("GIF", FILE_TYPE_GIF, "image/gif");
addFileType("PNG", FILE_TYPE_PNG, "image/png");
addFileType("BMP", FILE_TYPE_BMP, "image/x-ms-bmp");
addFileType("WBMP", FILE_TYPE_WBMP, "image/vnd.wap.wbmp");
/* Audio Play List */
addFileType("M3U", FILE_TYPE_M3U, "audio/x-mpegurl");
addFileType("PLS", FILE_TYPE_PLS, "audio/x-scpls");
addFileType("WPL", FILE_TYPE_WPL, "application/vnd.ms-wpl");
4.Java 层扫描文件
a ） Java 层开始文件
首先它忽略一些 MacOS 和 Windows Media Player 特殊的文件。然后它会查看被扫描的文件是否已经存在于缓存条目中，如果存在，它会检查文件上次修改的时间是否改变。最后它返回该文件是否需要进一步处理的结果。如果不需要，接下来的两步不会执行。
b)C++ 层扫描文件
不是所有的文件都需要交给 C++ 层解析成元数据。只有下面的文件类型会被解析，注意，这里不处理 image 文件。
- if (mFileType == MediaFile.FILE_TYPE_MP3 ||
- mFileType == MediaFile.FILE_TYPE_MP4 ||
- mFileType == MediaFile.FILE_TYPE_M4A ||
- mFileType == MediaFile.FILE_TYPE_3GPP ||
- mFileType == MediaFile.FILE_TYPE_3GPP2 ||
- mFileType == MediaFile.FILE_TYPE_OGG ||
- mFileType == MediaFile.FILE_TYPE_MID ||
- mFileType == MediaFile.FILE_TYPE_WMA) {
- ……
- ｝
对于被解析的元数据信息， C++ 层会回调到 JAVA 层的 handleStringTag 。 Java 层会记录它的 name/value 信息。
c)Java 层结束文件
最后根据上一步解析出的值， Java 层会更新相应的 MeidaProvider 产生的数据库表。
5.Java 层发送扫描
到目前为止，所有文件已经被扫描，它最后会检查文件和播放列表缓存条目，看是否所有项仍然存在于文件系统。如果有空条目，则会从数据库中删除。这样它能够保持数据库和文件系统的一致性。
其他的应用 程序 通过接收 MediaScannerService 发出的 ACTION_MEDIA_SCANNER_STARTED 和 ACTION_MEDIA_SCANNER_FINISHED 意图能够知道什么时候扫描操作开始和结束。
MediaScanner
之所以拿MediaScanner开刀 因为想借用系统的Media Scan 工具 通过Intent直接调用系统的
[步骤]
1. 下载并安装Git 过程略 网络上很多
2. 得到该功能的模块地址并使用Git下载之 地址：git://android.git.kernel.org/platform/packages/providers/MediaProvider.git
3. 分析源代码：
- AndroidManifest.xml : 各组件属性描述文件
- MediaProvider : extends ContentProvider 使用SQLiteDatabase 保存查询数据 action="content://media"
- MediaScannerCursor.java
- MediaScannerReceiver : extends BroadcastReceiver 用于接收指定Broadcast: BOOT_COMPLETED MEDIA_MOUNTED MEDIA_SCANNER_SCAN_FILE 并启动 MediaScannerService 开始扫描
- MediaScannerService : extends Service 执行具体的扫描工作
- MediaThumbRequest
4. 鉴于 并不打算自行实现多媒体扫描 因此 此次重点研究对象：MediaScannerReceiver
5. MediaScannerReceiver 代码
- public class MediaScannerReceiver extends BroadcastReceiver
- {
- private final static String TAG = "MediaScannerReceiver" ;
- @Override
- public void onReceive(Context context, Intent intent) {
- String action = intent.getAction();
- Uri uri = intent.getData();
- String externalStoragePath = Environment.getExternalStorageDirectory().getPath();
- 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();
- if (action.equals(Intent.ACTION_MEDIA_MOUNTED) &&
- externalStoragePath.equals(path)) {
- scan(context, MediaProvider.EXTERNAL_VOLUME);
- } else if (action.equals(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE) &&
- path != null && path.startsWith(externalStoragePath + "/" )) {
- scanFile(context, path);
- }
- }
- }
- }
- private void scan(Context context, String volume) {
- Bundle args = new Bundle();
- args.putString("volume" , volume);
- context.startService(
- new Intent(context, MediaScannerService. class ).putExtras(args));
- }
- private void scanFile(Context context, String path) {
- Bundle args = new Bundle();
- args.putString("filepath" , path);
- context.startService(
- new Intent(context, MediaScannerService. class ).putExtras(args));
- }
- }
- public class MediaScannerReceiver extends BroadcastReceiver
- {
- private final static String TAG = "MediaScannerReceiver";
- @Override
- public void onReceive(Context context, Intent intent) {
- String action = intent.getAction();
- Uri uri = intent.getData();
- String externalStoragePath = Environment.getExternalStorageDirectory().getPath();
- 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();
- if (action.equals(Intent.ACTION_MEDIA_MOUNTED) &&
- externalStoragePath.equals(path)) {
- scan(context, MediaProvider.EXTERNAL_VOLUME);
- } else if (action.equals(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE) &&
- path != null && path.startsWith(externalStoragePath + "/")) {
- scanFile(context, path);
- }
- }
- }
- }
- private void scan(Context context, String volume) {
- Bundle args = new Bundle();
- args.putString("volume", volume);
- context.startService(
- new Intent(context, MediaScannerService.class).putExtras(args));
- }
- private void scanFile(Context context, String path) {
- Bundle args = new Bundle();
- args.putString("filepath", path);
- context.startService(
- new Intent(context, MediaScannerService.class).putExtras(args));
- }
- }
6. 根据以上代码得知：
- 当系统启动完毕 会扫描一次
- 当 ACTION_MEDIA_MOUNTED ACTION_MEDIA_SCANNER_SCAN_FILE 也会扫描
7. 如何调用系统MediaScanner 进行扫描
- 通过 Intent.ACTION_MEDIA_MOUNTED 进行全扫描
- public void allScan(){
- sendBroadcast(new Intent(Intent.ACTION_MEDIA_MOUNTED, Uri.parse( "file://"
- + Environment.getExternalStorageDirectory())));
- }
- public void allScan(){
- sendBroadcast(new Intent(Intent.ACTION_MEDIA_MOUNTED, Uri.parse("file://"
- + Environment.getExternalStorageDirectory())));
- }
- 通过 Intent.ACTION_MEDIA_SCANNER_SCAN_FILE 扫描某个文件
- public void fileScan(String fName){
- Uri data = Uri.parse("file:///" +fName);
- sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, data));
- }
- public void fileScan(String fName){
- Uri data = Uri.parse("file:///"+fName);
- sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, data));
- }
补充： 上述方法是不支持对文件夹的 即：Uri data 必须是 文件的Uri 如果是文件夹的 其不会起作用的 切记！
- 如何扫描某文件夹下所有文件 难道就不可以么？ 当然不 借助于Intent.ACTION_MEDIA_SCANNER_SCAN_FILE
我们可以这么做： 取出该文件夹下的所有子文件 如其是文件且类型符合条件 就取出该文件目录 以 Intent.ACTION_MEDIA_SCANNER_SCAN_FILE方式发送至MediaScannerReceiver 若其为文件夹 则迭代查询之 故实现为：
- public void fileScan(String file){
- Uri data = Uri.parse("file://" +file);
- Log.d("TAG" , "file:" +file);
- sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, data));
- }
- public void folderScan(String path){
- File file = new File(path);
- if (file.isDirectory()){
- File[] array = file.listFiles();
- for ( int i= 0 ;i<array.length;i++){
- File f = array[i];
- if (f.isFile()){ //FILE TYPE
- String name = f.getName();
- if (name.contains( ".mp3" )){
- fileScan(f.getAbsolutePath());
- }
- }
- else { //FOLDER TYPE
- folderScan(f.getAbsolutePath());
- }
- }
- }
- }
- public void fileScan(String file){
- Uri data = Uri.parse("file://"+file);
- Log.d("TAG","file:"+file);
- sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, data));
- }
- public void folderScan(String path){
- File file = new File(path);
- if(file.isDirectory()){
- File[] array = file.listFiles();
- for(int i=0;i<array.length;i++){
- File f = array[i];
- if(f.isFile()){//FILE TYPE
- String name = f.getName();
- if(name.contains(".mp3")){
- fileScan(f.getAbsolutePath());
- }
- }
- else {//FOLDER TYPE
- folderScan(f.getAbsolutePath());
- }
- }
- }
- }
8. 鉴于多数人并不关心其原理 仅关系如何使用 故 总结如下：
- 扫描全部 我猜测其在效率方面可能有点副作用
- public void systemScan(){
- sendBroadcast(new Intent(Intent.ACTION_MEDIA_MOUNTED, Uri.parse( "file://"
- + Environment.getExternalStorageDirectory())));
- }
- public void systemScan(){
- sendBroadcast(new Intent(Intent.ACTION_MEDIA_MOUNTED, Uri.parse("file://"
- + Environment.getExternalStorageDirectory())));
- }
- 扫描某个文件 参数：填入该文件的路径
- public void fileScan(String file){
- Uri data = Uri.parse("file://" +file);
- sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, data));
- }
- public void fileScan(String file){
- Uri data = Uri.parse("file://"+file);
- sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, data));
- }
- 扫描文件夹 参数：填入该文件夹路径
- public void fileScan(String file){
- Uri data = Uri.parse("file://" +file);
- sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, data));
- }
- public void folderScan(String path){
- File file = new File(path);
- if (file.isDirectory()){
- File[] array = file.listFiles();
- for ( int i= 0 ;i<array.length;i++){
- File f = array[i];
- if (f.isFile()){ //FILE TYPE
- String name = f.getName();
- if (name.contains( ".mp3" )){
- fileScan(f.getAbsolutePath());
- }
- }
- else { //FOLDER TYPE
- folderScan(f.getAbsolutePath());
- }
- }
- }
- }
- public void fileScan(String file){
- Uri data = Uri.parse("file://"+file);
- sendBroadcast(new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, data));
- }
- public void folderScan(String path){
- File file = new File(path);
- if(file.isDirectory()){
- File[] array = file.listFiles();
- for(int i=0;i<array.length;i++){
- File f = array[i];
- if(f.isFile()){//FILE TYPE
- String name = f.getName();
- if(name.contains(".mp3")){
- fileScan(f.getAbsolutePath());
- }
- }
- else {//FOLDER TYPE
- folderScan(f.getAbsolutePath());
- }
- }
- }
- }
