如何声明访问外部存储所有音乐文件的权限？求完整实现步骤

Got it, let's walk through every step you need to take to get permission to access all music files on external storage for your Android app. The process varies slightly depending on the Android version you're targeting, so I'll break it down clearly for each scenario:

1. 首先在AndroidManifest.xml中声明静态权限 #

You need to add the appropriate permission declarations to your manifest file first. The exact permission depends on your target SDK version:

<!-- 针对 Android 12（API 31）及以下版本 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

<!-- 针对 Android 13（API 33）及以上版本：使用细分的媒体权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />

<!-- 可选：仅当你需要修改/删除音乐文件时添加（读取不需要此权限） -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />

• WRITE_EXTERNAL_STORAGE权限仅在Android 9（API 28）及以下版本中修改文件时需要。Android 10+的分区存储机制对写入操作有不同处理，仅读取音乐文件不需要此权限。

2. 动态请求权限（Android 6.0+ 必须执行） #

从Android 6.0（API 23）开始，"危险权限"（比如存储访问）需要在运行时获得用户的明确批准，不能仅依赖清单声明。

以下是完整的Kotlin实现示例（也提供简化版Java代码）：

Kotlin 实现 #

import android.Manifest
import android.content.pm.PackageManager
import android.os.Build
import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import androidx.core.app.ActivityCompat
import androidx.core.content.ContextCompat

class MusicAccessActivity : AppCompatActivity() {
    private val AUDIO_PERMISSION_REQUEST_CODE = 1001

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_music_access)

        // 先检查是否已获得权限
        if (!hasAudioAccessPermission()) {
            requestAudioPermission()
        } else {
            // 权限已授予，可以开始加载音乐文件
            loadMusicFiles()
        }
    }

    private fun hasAudioAccessPermission(): Boolean {
        return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            // Android 13+：检查新的细分音频权限
            ContextCompat.checkSelfPermission(
                this,
                Manifest.permission.READ_MEDIA_AUDIO
            ) == PackageManager.PERMISSION_GRANTED
        } else {
            // Android 12及以下：检查通用存储读取权限
            ContextCompat.checkSelfPermission(
                this,
                Manifest.permission.READ_EXTERNAL_STORAGE
            ) == PackageManager.PERMISSION_GRANTED
        }
    }

    private fun requestAudioPermission() {
        val permissions = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            arrayOf(Manifest.permission.READ_MEDIA_AUDIO)
        } else {
            arrayOf(Manifest.permission.READ_EXTERNAL_STORAGE)
        }

        ActivityCompat.requestPermissions(
            this,
            permissions,
            AUDIO_PERMISSION_REQUEST_CODE
        )
    }

    // 处理权限请求结果
    override fun onRequestPermissionsResult(
        requestCode: Int,
        permissions: Array<out String>,
        grantResults: IntArray
    ) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
        if (requestCode == AUDIO_PERMISSION_REQUEST_CODE) {
            if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                // 用户批准权限，开始加载音乐文件
                loadMusicFiles()
            } else {
                // 用户拒绝权限 - 显示友好提示并提供跳转到设置的入口
                showPermissionDeniedWarning()
            }
        }
    }

    private fun loadMusicFiles() {
        // 这里编写你的音乐文件查询逻辑（比如使用MediaStore.Audio.Media）
    }

    private fun showPermissionDeniedWarning() {
        // 显示对话框/提示，说明需要权限才能访问音乐文件
        // 可选：添加按钮跳转到应用设置页面，让用户手动开启权限
    }
}

Java 实现（简化版） #

import android.Manifest;
import android.content.pm.PackageManager;
import android.os.Build;
import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;

public class MusicAccessActivity extends AppCompatActivity {
    private static final int AUDIO_PERMISSION_REQUEST_CODE = 1001;

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

        if (!hasAudioAccessPermission()) {
            requestAudioPermission();
        } else {
            loadMusicFiles();
        }
    }

    private boolean hasAudioAccessPermission() {
        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 requestAudioPermission() {
        String[] permissions;
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            permissions = new String[]{Manifest.permission.READ_MEDIA_AUDIO};
        } else {
            permissions = new String[]{Manifest.permission.READ_EXTERNAL_STORAGE};
        }
        ActivityCompat.requestPermissions(this, permissions, AUDIO_PERMISSION_REQUEST_CODE);
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == AUDIO_PERMISSION_REQUEST_CODE) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                loadMusicFiles();
            } else {
                showPermissionDeniedWarning();
            }
        }
    }

    private void loadMusicFiles() {
        // 在这里实现音乐文件加载逻辑
    }

    private void showPermissionDeniedWarning() {
        // 向用户反馈权限被拒绝的信息
    }
}

3. Android 10+ 分区存储注意事项 #

从Android 10（API 29）开始，Google引入了分区存储，默认限制应用访问特定目录，但：

• 我们提到的权限（READ_EXTERNAL_STORAGE/READ_MEDIA_AUDIO）仍然允许你通过MediaStore API访问外部存储上的所有音频文件（这也是现在推荐的媒体文件访问方式）。
• 尽量避免使用直接文件路径访问音乐文件，坚持使用MediaStore以更好地兼容现代Android版本。
• 如果你的应用目标是API 29且使用了android:requestLegacyExternalStorage="true"来绕过分区存储，请注意这个标记在API 30+会被忽略——所以最好迁移到MediaStore方案。

4. 关键最佳实践 #

• 在合适的时机请求权限: 不要一启动应用就索要存储权限，等到用户尝试执行需要权限的操作（比如点击"扫描音乐库"）时再请求，这样更贴合上下文，用户更可能批准。
• 优雅处理权限拒绝: 如果用户拒绝权限，解释清楚为什么需要它，并提供跳转到应用设置页面的入口，让用户手动开启。
• 瞄准最新SDK: 始终尽量瞄准最新的Android SDK版本，以使用最前沿的权限和API。

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