Android开发：MediaMetadataRetriever加载GIF报setDataSource失败求助

嘿，这个问题我之前也踩过坑！核心原因很明确：MediaMetadataRetriever本来就不是为处理GIF格式设计的——它的API主要针对MP4、MKV这类视频文件，对GIF这种基于帧序列的图片格式支持非常有限，大部分Android设备上直接会触发你看到的setDataSource failed异常。

下面给你几个可行的解决方案，按推荐程度排序：

1. 使用Glide/Picasso等图片加载库（强烈推荐） #

这类成熟的图片加载框架专门做了GIF格式的适配，不仅能轻松获取第一帧，还支持直接播放动态GIF，同时帮你处理内存缓存、文件权限适配等一堆细节，省心又高效。

以Glide为例，先确保你在build.gradle里添加了依赖：

dependencies {
    implementation 'com.github.bumptech.glide:glide:4.16.0'
    annotationProcessor 'com.github.bumptech.glide:compiler:4.16.0'
}

然后在onBindViewHolder里替换你的原有代码：

// 如果你只需要显示GIF的第一帧
Glide.with(holder.mImageView.getContext())
     .asBitmap()
     .load(files[position]) // 直接传入File对象即可
     .into(holder.mImageView);

// 如果要显示动态GIF，去掉.asBitmap()就行
// Glide.with(holder.mImageView.getContext())
//      .load(files[position])
//      .into(holder.mImageView);

2. 手动解析GIF获取第一帧（无需第三方库） #

如果你不想引入第三方库，可以自己实现简单的GIF解析逻辑，读取第一帧的Bitmap。Android SDK没有内置GIF解析类，你可以用一个轻量的开源GifDecoder实现（网上搜“Android GifDecoder”就能找到现成的轻量代码，直接复制到项目里即可）：

try (InputStream inputStream = new FileInputStream(files[position])) {
    GifDecoder decoder = new GifDecoder();
    decoder.read(inputStream);
    Bitmap firstFrameBitmap = decoder.getFrame(0); // 获取第一帧
    if (firstFrameBitmap != null) {
        holder.mImageView.setImageBitmap(firstFrameBitmap);
    }
} catch (IOException e) {
    e.printStackTrace();
}

3. 适配Scoped Storage权限（Android 10+） #

虽然你说其他目录的视频能正常加载，但Android 10及以上的Scoped Storage限制可能导致直接访问ExternalStoragePublicDirectory的绝对路径出现隐性权限问题。如果一定要用MediaMetadataRetriever，可以尝试通过MediaStore获取文件的Uri，再调用setDataSource(Context, Uri)方法：

Uri gifUri = getGifUriFromMediaStore(context, files[position].getName());
if (gifUri != null) {
    try {
        retriever.setDataSource(context, gifUri);
        Bitmap frame = retriever.getFrameAtTime(1000000, MediaMetadataRetriever.OPTION_CLOSEST_SYNC);
        holder.mImageView.setImageBitmap(frame);
    } catch (Exception e) {
        e.printStackTrace();
    }
}

// 辅助方法：通过文件名从MediaStore查询对应Uri
private Uri getGifUriFromMediaStore(Context context, String fileName) {
    String[] projection = {MediaStore.Images.Media._ID};
    String selection = MediaStore.Images.Media.DISPLAY_NAME + "=?";
    String[] selectionArgs = {fileName};
    Cursor cursor = context.getContentResolver().query(
            MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
            projection,
            selection,
            selectionArgs,
            null
    );
    if (cursor != null && cursor.moveToFirst()) {
        long id = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID));
        cursor.close();
        return ContentUris.withAppendedId(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, id);
    }
    return null;
}

不过还是要提醒你，这个方案本质上绕不开MediaMetadataRetriever对GIF的支持缺陷，不如用图片加载库来得稳定。

内容的提问来源于stack exchange，提问作者Tsar