如何用MediaMetadataRetriever获取MP3专辑封面？代码失效求助

我来帮你梳理下代码里的问题，以及给出可行的修复方案：

你当前代码的几个核心问题 #

• 权限未处理：Android 6.0（API 23）及以上版本，读取外部存储需要动态申请权限，如果没申请，getContentResolver().query可能返回空游标，或者获取的文件路径无法访问，导致MediaMetadataRetriever读不到文件。
• 未判断封面是否存在：调用getEmbeddedPicture()可能返回null（比如该音频文件本身没有内嵌封面），此时直接解码字节数组会抛出异常，触发灰色背景的逻辑。
• 盲目取第一个音频文件：cursor.moveToFirst()只取了设备里的第一个音频，这个文件大概率没有内嵌封面，或者路径获取有误。

方案一：修复MediaMetadataRetriever的实现 #

先补全权限逻辑，再完善空值检查：

1. 先在AndroidManifest.xml添加权限 #

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!-- Android 13+ 需替换为下面的权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" android:minSdkVersion="33" />

2. 修正MainActivity代码 #

public class MainActivity extends AppCompatActivity {
    MediaMetadataRetriever metaRetriever;
    ImageView album_art;
    private static final int REQUEST_PERMISSION = 100;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        getInit();

        // 先检查权限，再加载封面
        if (checkPermission()) {
            loadAlbumArt();
        } else {
            requestPermission();
        }
    }

    // 检查权限适配不同Android版本
    private boolean checkPermission() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            return ContextCompat.checkSelfPermission(this, Manifest.permission.READ_MEDIA_AUDIO) == PackageManager.PERMISSION_GRANTED;
        } else {
            return ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED;
        }
    }

    // 申请权限
    private void requestPermission() {
        ActivityCompat.requestPermissions(this,
                new String[]{Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU ? Manifest.permission.READ_MEDIA_AUDIO : Manifest.permission.READ_EXTERNAL_STORAGE},
                REQUEST_PERMISSION);
    }

    // 权限回调
    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == REQUEST_PERMISSION) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                loadAlbumArt();
            } else {
                Toast.makeText(this, "需要权限才能加载专辑封面", Toast.LENGTH_SHORT).show();
            }
        }
    }

    // 加载封面核心逻辑
    private void loadAlbumArt() {
        Uri uri = MediaStore.Audio.Media.EXTERNAL_CONTENT_URI;
        String[] projection = {MediaStore.Audio.Media.DATA};
        Cursor cursor = getContentResolver().query(uri, projection, null, null, null);

        if (cursor != null && cursor.moveToFirst()) {
            do {
                String url = cursor.getString(cursor.getColumnIndex(MediaStore.Audio.Media.DATA));
                if (url != null) {
                    metaRetriever = new MediaMetadataRetriever();
                    try {
                        metaRetriever.setDataSource(url);
                        byte[] art = metaRetriever.getEmbeddedPicture();
                        if (art != null) { // 先判断封面是否存在再解码
                            Bitmap songImage = BitmapFactory.decodeByteArray(art, 0, art.length);
                            album_art.setImageBitmap(songImage);
                            break; // 找到第一个有封面的音频就停止
                        }
                    } catch (Exception e) {
                        e.printStackTrace();
                    } finally {
                        metaRetriever.release(); // 记得释放资源
                    }
                }
            } while (cursor.moveToNext());

            // 遍历完都没找到封面，再显示灰色背景
            if (album_art.getDrawable() == null) {
                album_art.setBackgroundColor(Color.GRAY);
            }
            cursor.close();
        } else {
            album_art.setBackgroundColor(Color.GRAY);
        }
    }

    public void getInit() {
        album_art = findViewById(R.id.album_art);
    }
}

方案二：用Cursor直接获取专辑封面（更高效） #

MediaStore已经存储了专辑封面的信息，不需要读取整个音频文件，直接通过ALBUM_ID获取封面Uri：

private void loadAlbumArtViaCursor() {
    Uri uri = MediaStore.Audio.Media.EXTERNAL_CONTENT_URI;
    String[] projection = {MediaStore.Audio.Media.ALBUM_ID};
    Cursor cursor = getContentResolver().query(uri, projection, null, null, null);

    if (cursor != null && cursor.moveToFirst()) {
        long albumId = cursor.getLong(cursor.getColumnIndex(MediaStore.Audio.Media.ALBUM_ID));
        // 拼接专辑封面的Uri
        Uri albumArtUri = ContentUris.withAppendedId(Uri.parse("content://media/external/audio/albumart"), albumId);
        
        try {
            Bitmap bitmap = MediaStore.Images.Media.getBitmap(this.getContentResolver(), albumArtUri);
            album_art.setImageBitmap(bitmap);
        } catch (IOException e) {
            album_art.setBackgroundColor(Color.GRAY);
            e.printStackTrace();
        }
        cursor.close();
    } else {
        album_art.setBackgroundColor(Color.GRAY);
    }
}

这个方法不需要读取音频文件本身，直接通过系统媒体库获取封面，效率更高，也避免了文件路径的问题。

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