MediaMetadataRetriever详解

MediaMetadataRetriever是Android框架中一个非常有用的类，它允许开发者从媒体文件（如音频或视频）中提取元数据和帧。它提供了多种功能，例如获取媒体信息（时长、艺术家、标题等）、提取关键帧或指定时间的帧图像等。以下是其用法的详细说明。

1、添加权限

在使用MediaMetadataRetriever之前，可能需要在AndroidManifest.xml中添加读取外部存储的权限（取决于媒体文件的位置）：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

2、初始化MediaMetadataRetriever

首先，创建MediaMetadataRetriever实例并设置数据源（文件路径、URI或文件描述符等）：

MediaMetadataRetriever retriever = new MediaMetadataRetriever();
try {
    // 设置数据源（例如文件路径）
    retriever.setDataSource("/sdcard/Music/sample.mp3");
    // 或者通过URI（例如Content URI）
    // retriever.setDataSource(context, uri);
} catch (IllegalArgumentException e) {
    e.printStackTrace();
}

3、提取元数据

使用extractMetadata()方法获取媒体文件的元数据，传入指定的键（如METADATA_KEY_DURATION、METADATA_KEY_ARTIST等）。常见的元数据键包括：

METADATA_KEY_TITLE：标题

METADATA_KEY_ARTIST：艺术家

METADATA_KEY_ALBUM：专辑

METADATA_KEY_DURATION：时长（毫秒）

METADATA_KEY_MIMETYPE：MIME类型

示例代码：

String title = retriever.extractMetadata(MediaMetadataRetriever.METADATA_KEY_TITLE);
String artist = retriever.extractMetadata(MediaMetadataRetriever.METADATA_KEY_ARTIST);
String duration = retriever.extractMetadata(MediaMetadataRetriever.METADATA_KEY_DURATION);
Log.d("MediaMetadata", "Title: " + title);
Log.d("MediaMetadata", "Artist: " + artist);
Log.d("MediaMetadata", "Duration: " + duration + " ms");

4、提取帧图像

使用getFrameAtTime()方法可以从视频中提取指定时间的帧（返回Bitmap对象）。可以选择提取关键帧或近似帧：

// 提取第5秒的帧（时间单位：微秒）
long timeUs = 5000000; // 5秒 = 5 * 1000000微秒
Bitmap frame = retriever.getFrameAtTime(timeUs, MediaMetadataRetriever.OPTION_CLOSEST);
// 显示或处理Bitmap
if (frame != null) {
    imageView.setImageBitmap(frame);
}

参数说明：

timeUs：时间点（微秒）。

option：提取选项，例如：

OPTION_CLOSEST：提取最接近的帧（可能不是关键帧）。

OPTION_PREVIOUS_SYNC：提取关键帧。

OPTION_NEXT_SYNC：提取下一个关键帧。

5、释放资源

使用完成后，必须调用release()方法释放资源：

retriever.release();

6、完整示例代码

以下是一个完整的示例，演示如何提取元数据和帧：

public void extractMediaMetadata(String filePath) {
    MediaMetadataRetriever retriever = new MediaMetadataRetriever();
    try {
        retriever.setDataSource(filePath);
        // 提取元数据
        String title = retriever.extractMetadata(MediaMetadataRetriever.METADATA_KEY_TITLE);
        String artist = retriever.extractMetadata(MediaMetadataRetriever.METADATA_KEY_ARTIST);
        String duration = retriever.extractMetadata(MediaMetadataRetriever.METADATA_KEY_DURATION);
        Log.d("MediaInfo", "Title: " + (title != null ? title : "Unknown"));
        Log.d("MediaInfo", "Artist: " + (artist != null ? artist : "Unknown"));
        Log.d("MediaInfo", "Duration: " + duration + " ms");
        // 提取第10秒的帧
        Bitmap frame = retriever.getFrameAtTime(10000000, MediaMetadataRetriever.OPTION_CLOSEST);
        if (frame != null) {
            // 处理帧（例如显示在ImageView中）
        }
    } catch (Exception e) {
        Log.e("MediaMetadata", "Error: " + e.getMessage());
    } finally {
        retriever.release();
    }
}

7、注意事项

兼容性：MediaMetadataRetriever从Android API 10（Android 2.3.3）开始提供，但某些方法（如getScaledFrameAtTime()）可能需要更高版本。

性能：处理大型媒体文件时，提取帧可能耗时，建议在后台线程执行。

数据源：支持本地文件路径、URL（需网络权限）或Content URI。

通过以上步骤，可以有效地使用MediaMetadataRetriever来获取媒体文件的元数据和帧图像。

MediaMetadataRetriever详解