4. 相机权限处理：Android 6.0+ 运行时权限请求

在 Android 6.0（API 23）及更高版本中，系统引入了运行时权限模型。应用不再在安装时一次性授予所有权限，而是需要在应用运行时动态请求用户授权。对于自定义相机应用，必须处理 CAMERA 权限（用于打开相机预览和拍照）以及 WRITE_EXTERNAL_STORAGE 权限（用于将照片保存到设备存储）。本章将系统讲解运行时权限的请求流程、最佳实践及常见问题处理。

4.1 运行时权限模型概述

运行时权限模型将权限分为正常权限和危险权限两类。正常权限由系统自动授予，危险权限则需要运行时动态请求。CAMERA 和 WRITE_EXTERNAL_STORAGE 均属于危险权限。

运行时权限请求的核心流程包含以下步骤：

1. 检查权限状态： 使用 ContextCompat.checkSelfPermission() 判断权限是否已被授予。
2. 解释请求原因： 如果用户之前拒绝过权限，应使用 shouldShowRequestPermissionRationale() 判断是否需要显示解释说明。
3. 发起权限请求： 调用 ActivityCompat.requestPermissions() 弹出系统权限对话框。
4. 处理请求结果： 在 onRequestPermissionsResult() 回调中处理用户的授权或拒绝操作。

4.2 权限请求流程图

下图展示了完整的权限请求决策流程，帮助理解每个分支的处理逻辑：

4.3 在 AndroidManifest.xml 中声明权限

无论运行时如何请求，首先必须在 AndroidManifest.xml 中声明所需权限。这是权限工作的前提条件。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.customcamera">

    <!-- 相机权限 -->
    <uses-permission android:name="android.permission.CAMERA" />

    <!-- 写入外部存储权限（用于保存照片） -->
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
        android:maxSdkVersion="28" />

    <!-- 读取外部存储权限（Android 10+ 推荐使用） -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
        android:maxSdkVersion="32" />

    <!-- 相机硬件特性声明（非必需，但建议添加） -->
    <uses-feature android:name="android.hardware.camera" android:required="true" />

    ...
</manifest>

4.4 运行时权限请求完整实现

以下代码展示了在 Activity 中请求 CAMERA 和 WRITE_EXTERNAL_STORAGE 权限的完整实现：

public class CameraActivity extends AppCompatActivity {

    private static final int REQUEST_CODE_PERMISSIONS = 100;
    private static final String[] REQUIRED_PERMISSIONS = {
        Manifest.permission.CAMERA,
        Manifest.permission.WRITE_EXTERNAL_STORAGE
    };

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

        // 检查并请求权限
        if (allPermissionsGranted()) {
            openCamera();
        } else {
            requestPermissionsIfNeeded();
        }
    }

    private boolean allPermissionsGranted() {
        for (String permission : REQUIRED_PERMISSIONS) {
            if (ContextCompat.checkSelfPermission(this, permission)
                    != PackageManager.PERMISSION_GRANTED) {
                return false;
            }
        }
        return true;
    }

    private void requestPermissionsIfNeeded() {
        List<String> permissionsToRequest = new ArrayList<>();

        for (String permission : REQUIRED_PERMISSIONS) {
            if (ContextCompat.checkSelfPermission(this, permission)
                    != PackageManager.PERMISSION_GRANTED) {
                permissionsToRequest.add(permission);
            }
        }

        if (!permissionsToRequest.isEmpty()) {
            ActivityCompat.requestPermissions(this,
                    permissionsToRequest.toArray(new String[0]),
                    REQUEST_CODE_PERMISSIONS);
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode,
                                           @NonNull String[] permissions,
                                           @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);

        if (requestCode == REQUEST_CODE_PERMISSIONS) {
            if (allPermissionsGranted()) {
                openCamera();
            } else {
                // 权限被拒绝，检查是否需要显示解释
                boolean shouldShowRationale = false;
                for (String permission : REQUIRED_PERMISSIONS) {
                    if (ActivityCompat.shouldShowRequestPermissionRationale(
                            this, permission)) {
                        shouldShowRationale = true;
                        break;
                    }
                }

                if (shouldShowRationale) {
                    // 用户拒绝但未勾选"不再询问"，可再次解释并请求
                    showPermissionExplanationDialog();
                } else {
                    // 用户勾选了"不再询问"，引导用户前往设置
                    showSettingsRedirectDialog();
                }
            }
        }
    }

    private void openCamera() {
        // 初始化相机预览和拍照功能
        // 后续章节实现
    }

    private void showPermissionExplanationDialog() {
        new AlertDialog.Builder(this)
                .setTitle("需要相机权限")
                .setMessage("自定义相机应用需要相机权限来拍照，" +
                        "以及存储权限来保存照片。请授予相关权限。")
                .setPositiveButton("重新请求", (dialog, which) -> {
                    requestPermissionsIfNeeded();
                })
                .setNegativeButton("取消", null)
                .show();
    }

    private void showSettingsRedirectDialog() {
        new AlertDialog.Builder(this)
                .setTitle("权限被永久拒绝")
                .setMessage("相机或存储权限已被永久拒绝，" +
                        "请在系统设置中手动开启。")
                .setPositiveButton("前往设置", (dialog, which) -> {
                    Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
                    Uri uri = Uri.fromParts("package", getPackageName(), null);
                    intent.setData(uri);
                    startActivity(intent);
                })
                .setNegativeButton("取消", null)
                .show();
    }
}

4.5 权限请求最佳实践

在实际开发中，遵循以下最佳实践可以显著提升用户体验和权限授予率：

4.6 权限状态与用户决策路径

用户与权限对话框的交互会产生三种不同的状态，每种状态对应不同的处理策略：

4.7 常见问题与解决方案

4.8 本章小结

权限处理是自定义相机应用的基础保障。本章涵盖了以下核心知识点：

• 运行时权限模型： Android 6.0+ 要求危险权限在运行时动态请求。
• 权限声明： 在 AndroidManifest.xml 中声明 CAMERA 和 WRITE_EXTERNAL_STORAGE 权限。
• 请求流程： 检查状态 → 解释原因 → 发起请求 → 处理结果。
• 用户决策处理： 区分授权、拒绝一次、永久拒绝三种场景。
• 最佳实践： 时机选择、解释说明、设置引导、兼容性处理。