Android Java音乐播放器中MaterialFilePicker实现报错求助

1. 先删除你手动创建的MaterialFilePicker.java #

官方库已经封装好了这个类，自行创建会和库中类冲突，直接删掉即可。

2. 启动文件选择器核心代码 #

在你的音乐播放器Activity/Fragment中，添加以下代码触发文件选择：

2.1 定义请求码常量 #

在Activity类内添加：

private static final int FILE_PICKER_REQUEST = 1001;

2.2 编写启动选择器的方法 #

可绑定到按钮点击事件，只筛选音频文件：

private void launchFilePicker() {
    new MaterialFilePicker()
            .withActivity(this)
            .withRequestCode(FILE_PICKER_REQUEST)
            .withFilter(Pattern.compile(".*\\.(mp3|wav|flac|m4a)$")) // 匹配常见音频格式，可按需修改
            .withFilterDirectories(false) // 仅允许选择文件，不选目录
            .withHiddenFiles(false) // 不显示隐藏文件
            .start();
}

3. 处理选择结果 #

重写Activity的onActivityResult方法，获取选中文件路径：

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == FILE_PICKER_REQUEST && resultCode == RESULT_OK) {
        if (data != null) {
            String selectedPath = data.getStringExtra(MaterialFilePicker.RESULT_FILE_PATH);
            // 这里处理选中的音频文件，比如加入播放列表、启动播放等
            if (selectedPath != null) {
                Log.d("MusicPlayer", "选中音频路径: " + selectedPath);
            }
        }
    }
}

4. 权限处理 #

Android 6.0+需要动态申请存储权限，Android 10+需注意文件访问规则：

4.1 添加Manifest权限 #

在AndroidManifest.xml中添加：

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

4.2 动态申请权限代码 #

private void checkStoragePermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE)
            != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this,
                new String[]{Manifest.permission.READ_EXTERNAL_STORAGE},
                1002);
    } else {
        launchFilePicker();
    }
}

// 处理权限申请结果
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == 1002) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            launchFilePicker();
        } else {
            Toast.makeText(this, "需要存储权限才能选择音频文件", Toast.LENGTH_SHORT).show();
        }
    }
}

5. 样式配置验证 #

确认你的styles.xml使用Material主题，确保和你修改的colors.xml适配：

<style name="AppTheme" parent="Theme.MaterialComponents.Light.DarkActionBar">
    <item name="colorPrimary">@color/colorPrimary</item>
    <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
    <item name="colorAccent">@color/colorAccent</item>
</style>

常见错误排查 #

• 不要手动创建MaterialFilePicker类，直接用库中提供的，避免类重复定义错误。
• 确认依赖引入正确：
  根目录build.gradle：

  allprojects {
      repositories {
          mavenCentral()
      }
  }
  

  App模块build.gradle：

  dependencies {
      implementation 'com.nbsp:library:1.8.1' // 使用最新稳定版本
  }
  

• 确保请求码FILE_PICKER_REQUEST唯一，避免和其他功能请求冲突。

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