将MediaMetadataRetriever传入自定义类后方法返回null的问题排查

我创建了MusicData类替代MainActivity中的方法，该类接收存储中音乐文件路径和从MainActivity传入的已初始化MediaMetadataRetriever对象，但调用类中方法时返回null。推测需要从MainActivity传入Context以实现存储数据的读取，但不清楚具体实现方式。

你的代码存在几个关键问题导致返回null：

1. 未声明成员变量MediaMetadataRetriever：getBitmap方法直接使用metadataRetriever，但类中没有定义该成员变量，会导致编译错误或空指针异常。
2. 过早释放MediaMetadataRetriever：getBitmap中调用metadataRetriever.release()，后续再使用该实例会抛出异常，导致返回null。
3. 未处理存储权限与版本适配：Android不同版本对存储访问的权限要求不同，没有Context无法完成权限检查和请求，这会导致无法读取文件元数据。

修正后的MusicData类 #

import android.content.Context;
import android.content.pm.PackageManager;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.media.MediaMetadataRetriever;
import android.os.Build;

import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;

public class MusicData {
    private final Context mContext;
    private MediaMetadataRetriever mMetadataRetriever;

    // 构造方法传入Context，初始化MediaMetadataRetriever
    public MusicData(Context context) {
        mContext = context;
        mMetadataRetriever = new MediaMetadataRetriever();
    }

    public String getTitle(String path) {
        try {
            if (checkStoragePermission()) {
                mMetadataRetriever.setDataSource(path);
                String title = mMetadataRetriever.extractMetadata(MediaMetadataRetriever.METADATA_KEY_TITLE);
                // 若元数据为空，返回文件名作为 fallback
                return title != null ? title : getFileNameFromPath(path);
            } else {
                requestStoragePermission();
                return getFileNameFromPath(path);
            }
        } catch (Exception e) {
            e.printStackTrace();
            return getFileNameFromPath(path);
        }
    }

    public Bitmap getBitmap(String path) {
        try {
            if (checkStoragePermission()) {
                mMetadataRetriever.setDataSource(path);
                byte[] albumArtData = mMetadataRetriever.getEmbeddedPicture();
                if (albumArtData != null) {
                    return BitmapFactory.decodeByteArray(albumArtData, 0, albumArtData.length);
                }
            } else {
                requestStoragePermission();
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
        return null; // 无封面或读取失败时返回null
    }

    // 统一释放资源，在宿主组件销毁时调用
    public void release() {
        if (mMetadataRetriever != null) {
            mMetadataRetriever.release();
            mMetadataRetriever = null;
        }
    }

    // 从路径中提取文件名
    private String getFileNameFromPath(String path) {
        int lastSlashIndex = path.lastIndexOf("/");
        return lastSlashIndex != -1 ? path.substring(lastSlashIndex + 1) : path;
    }

    // 检查存储访问权限，适配不同Android版本
    private boolean checkStoragePermission() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            return ContextCompat.checkSelfPermission(mContext, android.Manifest.permission.READ_MEDIA_AUDIO) == PackageManager.PERMISSION_GRANTED;
        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            return true; // Android Q及以上，访问媒体库无需READ_EXTERNAL_STORAGE
        } else {
            return ContextCompat.checkSelfPermission(mContext, android.Manifest.permission.READ_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED;
        }
    }

    // 请求存储权限
    private void requestStoragePermission() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            ActivityCompat.requestPermissions((android.app.Activity) mContext, new String[]{android.Manifest.permission.READ_MEDIA_AUDIO}, 1001);
        } else if (Build.VERSION.SDK_INT < Build.VERSION_CODES.Q) {
            ActivityCompat.requestPermissions((android.app.Activity) mContext, new String[]{android.Manifest.permission.READ_EXTERNAL_STORAGE}, 1001);
        }
    }
}

在MainActivity中的使用方式 #

import android.os.Bundle;
import android.widget.Toast;

import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {
    private MusicData mMusicData;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        // 传入Context初始化MusicData
        mMusicData = new MusicData(this);

        // 示例调用
        String musicFilePath = "/storage/emulated/0/Music/sample.mp3";
        String musicTitle = mMusicData.getTitle(musicFilePath);
        Bitmap albumArt = mMusicData.getBitmap(musicFilePath);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        // 释放资源，避免内存泄漏
        if (mMusicData != null) {
            mMusicData.release();
        }
    }

    // 处理权限请求结果
    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == 1001) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                // 权限获取成功，可重新加载音乐数据
                Toast.makeText(this, "权限已获取，可读取音乐信息", Toast.LENGTH_SHORT).show();
            } else {
                Toast.makeText(this, "需要存储权限才能读取音乐元数据", Toast.LENGTH_SHORT).show();
            }
        }
    }
}

关键说明 #

• Context的作用：用于权限检查、请求，以及适配Android不同版本的存储访问规则，是读取外部存储文件的必要条件。
• MediaMetadataRetriever管理：统一在构造方法初始化，宿主组件销毁时释放，避免重复创建/释放导致的异常。
• 权限适配：针对Android 13+、10-12、9及以下分别处理不同的权限要求，确保文件访问合法。
• Fallback逻辑：当元数据读取失败时，返回文件名作为标题，避免返回null；封面图确实不存在时才返回null。

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