Unity开发Android应用动态权限申请实战：从配置到回调处理

1. 项目概述：为什么Unity开发Android应用必须搞定动态权限？

如果你用Unity开发过Android应用，并且这个应用需要访问相册、定位、麦克风或者读写外部存储，那你大概率遇到过这个场景：在编辑器里跑得好好的，打包成APK装到真机上，一点某个功能就直接闪退，或者弹出一个看不懂的系统弹窗后就没下文了。这十有八九，就是动态权限申请没处理好。

这可不是个小问题。从Android 6.0（API level 23）开始，Google引入了运行时权限模型，把权限分成了普通权限和危险权限。像网络访问这种普通权限，你在AndroidManifest.xml里声明了就行。但像相机、存储、位置这些危险权限，光声明不够，必须在应用运行时，由用户主动授权。Unity作为一个跨平台引擎，它把大部分平台交互都封装好了，但在动态权限这块，它只提供了一个基础的接口，剩下的“脏活累活”——比如什么时候弹窗、用户点了拒绝怎么办、怎么优雅地引导用户——都得我们开发者自己来填。

所以，这个“从配置到回调处理”的实战，核心就是解决三个问题：第一，怎么在Unity工程里正确配置Android权限；第二，怎么在C#脚本里触发系统原生的权限请求弹窗；第三，也是最重要最麻烦的，怎么处理用户授权后的各种回调结果，构建一个健壮、用户体验良好的权限管理流程。搞定了这些，你的应用才能在Android生态里合规、稳定地运行。

2. 权限基础与Unity环境配置

2.1 理解Android的危险权限与权限组

在动手之前，得先明白规则。Android的危险权限不是一个个独立的，它们被分成了“权限组”。这个分组机制直接影响用户体验和你的代码逻辑。

举个例子，READ_EXTERNAL_STORAGE（读存储）和WRITE_EXTERNAL_STORAGE（写存储）同属于STORAGE权限组。当你向用户申请WRITE_EXTERNAL_STORAGE权限并且用户同意了，那么同组的READ_EXTERNAL_STORAGE权限也会被自动授予，你不需要再单独申请一次。反之亦然。

但是，这里有个至关重要的细节：用户授权是针对权限组的，但你的应用拥有权限的状态是针对单个权限的。也就是说，系统记录的是“用户是否授予了STORAGE权限组”，而你在代码里检查Permission.HasUserAuthorizedPermission时，传入的必须是具体的权限名，比如Permission.ExternalStorageWrite。

常见的权限组和对应的Unity API常量如下表：

注意：关于存储权限，在Android 10（API 29）及以上版本，引入了作用域存储（Scoped Storage），READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE的行为发生了变化。对于访问应用专属目录（Application.persistentDataPath）和通过MediaStore API访问公共媒体文件，可能不再需要这些权限。你需要根据你的目标API级别和具体文件访问需求来调整策略，这本身就是一个大坑，我们今天聚焦在通用申请流程上。

2.2 Unity项目中的Android权限配置

配置是第一步，错了后面全白搭。Unity里配置Android权限主要有两个地方。

1. 在Player Settings中声明（必须）

这是告诉Android系统：“我的应用可能会用到这些权限”。即使对于动态申请的权限，这里也必须声明。

• 打开File -> Build Settings，选择Android平台，点击Player Settings...。
• 在Player设置面板中，找到Other Settings区域。
• 向下滚动到Configuration部分，你会看到Write Permission、Read Permission等旧版选项，不要在这里设置。
• 继续向下，找到Scripting Backend，确保它是IL2CPP（推荐，兼容性和性能更好）。
• 再往下，找到Configuration下的Permissions列表。这是一个下拉菜单，你可以点击+号添加权限。
• 根据你的需求，从列表中选择对应的权限。例如，需要访问相机就添加Camera，需要读写存储就添加External Storage。

2. 在AndroidManifest.xml中覆写（高级/必须）

Unity在打包时会自动生成一个基础的AndroidManifest.xml文件。但自动生成的可能不完整，或者你需要更精细的控制（比如设置maxSdkVersion），这时就需要自定义一个。

• 在Unity项目的Assets文件夹下（或Assets/Plugins/Android更规范），创建一个名为AndroidManifest.xml的文件。
• 你可以从Unity安装目录下的{UnityInstallPath}/Editor/Data/PlaybackEngines/AndroidPlayer/Apk中找到模板文件复制过来修改。
• 关键是在<manifest>标签内，<application>标签外，添加<uses-permission>标签。

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.yourcompany.yourapp"> <!-- 声明可能用到的权限 --> <uses-permission android:name="android.permission.CAMERA" /> <uses-permission android:name="android.permission.RECORD_AUDIO" /> <!-- 对于存储权限，可以指定最高适用的SDK版本 --> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" /> <!-- 如果目标API级别 >= 33 (Android 13)，需要单独申请媒体权限 --> <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" /> <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" /> <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" /> <!-- 访问精确位置 --> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <!-- 如果只需要粗略位置，可以只申请这个 --> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <!-- 在后台访问位置需要额外申请（API 29+） --> <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" /> <application ...> <!-- 你的application配置 --> </application> </manifest>

实操心得：我强烈建议始终使用自定义的AndroidManifest.xml。因为Player Settings里的图形化列表有时会漏掉一些细节配置，而且自定义Manifest让你对整个应用的Android配置有完全的控制权，方便后续添加其他功能（比如Service、BroadcastReceiver、Activity属性等）。把它放在Assets/Plugins/Android/目录下是最佳实践。

3. Unity运行时权限API详解与核心脚本设计

3.1 Permission类：你的主要工具

Unity提供了UnityEngine.Android.Permission类（注意命名空间）来处理运行时权限。它的核心是几个静态方法和属性，设计脚本时要紧紧围绕它们。

• Permission.HasUserAuthorizedPermission(string permission): 这是检查权限状态的核心。它返回一个bool，告诉你用户是否已经授予了该权限。重要：在申请权限前，一定要先调用这个检查！如果用户已经授权，你就不要再弹窗申请了，否则用户体验很差。
• Permission.RequestUserPermission(string permission): 这是申请单个权限的方法。它是异步的，调用后会触发系统弹窗，然后立即返回。你需要通过回调或协程来获取结果。
• Permission.RequestUserPermissions(string[] permissions, PermissionCallbacks callbacks): 这是批量申请多个权限的方法。它允许你传入一个权限字符串数组和一个回调类实例，更结构化地处理结果。

这里最大的坑在于，RequestUserPermission是“发射后不管”的。你调用它，弹窗出现，方法就执行完毕了，它不会阻塞等待用户点击。那么，结果去哪了？

3.2 接收回调的两种主流方式

Unity提供了两种主要方式来接收权限申请的结果。

方式一：使用PermissionCallbacks类（推荐，尤其批量申请）

这是更现代、更清晰的方式。你可以创建一个PermissionCallbacks对象，为其PermissionGranted、PermissionDenied、PermissionDeniedAndDontAskAgain事件注册监听方法。

using UnityEngine; using UnityEngine.Android; // 关键命名空间 public class PermissionManager : MonoBehaviour { void Start() { RequestCameraPermission(); } void RequestCameraPermission() { if (Permission.HasUserAuthorizedPermission(Permission.Camera)) { Debug.Log("相机权限已授予"); // 开始使用相机... return; } var callbacks = new PermissionCallbacks(); callbacks.PermissionGranted += permissionName => { Debug.Log($"{permissionName} 权限被授予"); // 权限获取成功，执行相关操作 }; callbacks.PermissionDenied += permissionName => { Debug.Log($"{permissionName} 权限被拒绝"); // 可以向用户解释为什么需要这个权限，并引导去设置页 ShowPermissionDeniedDialog(); }; callbacks.PermissionDeniedAndDontAskAgain += permissionName => { Debug.Log($"{permissionName} 权限被拒绝且不再询问"); // 这种情况最麻烦，必须引导用户手动去应用设置里开启权限 ShowGoToSettingsDialog(); }; // 发起请求 Permission.RequestUserPermission(Permission.Camera, callbacks); // 如果是多个权限：Permission.RequestUserPermissions(new string[]{Permission.Camera, Permission.Microphone}, callbacks); } void ShowPermissionDeniedDialog() { // 这里可以用UI弹窗提示用户 // 例如：“需要相机权限来扫描二维码，是否重新授权？” // 如果用户点击“是”，可以再次调用RequestCameraPermission() } void ShowGoToSettingsDialog() { // 提示用户：“您已永久拒绝权限，如需使用该功能，请到手机设置->应用管理->[本应用]->权限中手动开启。” // 并提供按钮，点击后可以用Application.OpenURL打开本应用的系统设置页（部分机型支持） // Application.OpenURL("package:com.yourcompany.yourapp"); // 更通用的做法是提示用户自行前往设置。 } }

方式二：在Update中轮询（传统方式，适用于简单场景）

Permission.RequestUserPermission调用后，你可以在Update方法里持续检查权限状态，直到状态发生变化。这种方式代码分散，不够优雅，但在一些简单场景或需要兼容旧代码时可能用到。

private bool isRequestingPermission = false; private string requestedPermission; void RequestPermissionAndWait(string permission) { if (Permission.HasUserAuthorizedPermission(permission)) { OnPermissionGranted(permission); return; } isRequestingPermission = true; requestedPermission = permission; Permission.RequestUserPermission(permission); } void Update() { if (isRequestingPermission) { // 轮询检查权限状态是否改变 if (Permission.HasUserAuthorizedPermission(requestedPermission)) { isRequestingPermission = false; OnPermissionGranted(requestedPermission); } // 注意：这种方式无法区分“拒绝”和“拒绝且不再询问”， // 因为HasUserAuthorizedPermission在两种情况下都返回false。 // 如果需要区分，必须用PermissionCallbacks。 } }

注意事项：绝对不要在主线程中同步等待权限申请结果（比如用while循环配合同步检查）。这会导致应用无响应（ANR）。异步回调是唯一正确的路径。

3.3 设计一个健壮的权限管理单例

在实际项目中，权限申请可能散落在各个功能模块（相机模块、录音模块、文件管理模块）。为了统一管理、避免重复代码和冲突，设计一个全局的权限管理单例是最佳实践。

这个单例应该负责：

1. 提供统一的接口供其他模块查询和申请权限。
2. 缓存权限状态，避免频繁调用系统API。
3. 处理复杂的申请逻辑，比如多个关联权限的申请顺序。
4. 管理“拒绝后引导”和“永久拒绝后跳转设置”的全局UI。

using System; using System.Collections.Generic; using UnityEngine; using UnityEngine.Android; public class AppPermissionManager : MonoBehaviour { public static AppPermissionManager Instance { get; private set; } // 用一个字典缓存权限状态（注意：状态可能被用户在系统设置中改变，需要适时更新） private Dictionary<string, bool> _permissionCache = new Dictionary<string, bool>(); // 权限申请的回调委托字典，用于处理来自不同模块的回调 private Dictionary<string, Action<bool, bool>> _pendingCallbacks = new Dictionary<string, Action<bool, bool>>(); void Awake() { if (Instance != null && Instance != this) { Destroy(gameObject); return; } Instance = this; DontDestroyOnLoad(gameObject); } /// <summary> /// 检查权限是否已授予（带缓存） /// </summary> public bool CheckPermission(string permission) { if (_permissionCache.TryGetValue(permission, out bool cachedResult)) { return cachedResult; } bool result = Permission.HasUserAuthorizedPermission(permission); _permissionCache[permission] = result; return result; } /// <summary> /// 申请权限（统一入口） /// </summary> /// <param name="permission">权限名</param> /// <param name="onResult">回调：参数1-是否授权，参数2-是否“不再询问”</param> public void RequestPermission(string permission, Action<bool, bool> onResult = null) { // 先检查缓存 if (CheckPermission(permission)) { onResult?.Invoke(true, false); return; } // 如果已经有同一个权限的请求在进行，将回调加入列表 if (_pendingCallbacks.ContainsKey(permission)) { if (onResult != null) _pendingCallbacks[permission] += onResult; return; } // 创建新的回调链 Action<bool, bool> callbackChain = null; callbackChain = (granted, dontAskAgain) => { // 更新缓存 _permissionCache[permission] = granted; // 执行所有注册的回调 if (_pendingCallbacks.TryGetValue(permission, out var callbacks)) { callbacks?.Invoke(granted, dontAskAgain); _pendingCallbacks.Remove(permission); } }; if (onResult != null) _pendingCallbacks[permission] = onResult; // 使用PermissionCallbacks发起请求 var callbacks = new PermissionCallbacks(); callbacks.PermissionGranted += _ => callbackChain(true, false); callbacks.PermissionDenied += _ => callbackChain(false, false); callbacks.PermissionDeniedAndDontAskAgain += _ => callbackChain(false, true); Debug.Log($"请求权限: {permission}"); Permission.RequestUserPermission(permission, callbacks); } /// <summary> /// 清除某个权限的缓存（例如在从设置页返回时调用） /// </summary> public void InvalidateCache(string permission) { _permissionCache.Remove(permission); } }

这样，其他模块调用权限申请就变得非常清晰：

// 在相机模块中 void TryOpenCamera() { AppPermissionManager.Instance.RequestPermission(Permission.Camera, (granted, dontAskAgain) => { if (granted) { InitCamera(); } else { if (dontAskAgain) { // 显示“去设置”弹窗 UIManager.ShowGoToSettingsDialog("相机"); } else { // 显示解释性弹窗，并可选择再次申请 UIManager.ShowPermissionRationaleDialog("相机", () => { AppPermissionManager.Instance.RequestPermission(Permission.Camera, (g, d) => { /* 处理第二次结果 */ }); }); } } }); }

4. 实战：分场景的权限申请流程与UI设计

有了核心管理器，我们来看具体场景。权限申请不是弹个窗就完事了，它需要融入你的应用流程和UI设计。

4.1 场景一：启动时一次性申请多个权限

有些应用（如社交、相机类）在启动时就需要一堆权限。你可以设计一个“权限引导页”。

流程设计：

1. 应用启动后，进入一个专门的权限引导场景。
2. 依次或分组检查核心权限（如存储、相机、麦克风）。
3. 对于未授权的权限，向用户展示友好的说明（“我们需要XX权限来为您提供YY功能”），然后触发系统弹窗。
4. 用户操作后，根据结果决定是进入应用主界面，还是停留在引导页处理被拒绝的权限。

代码要点：

public class PermissionIntroController : MonoBehaviour { public GameObject[] permissionPanels; // 每个权限对应的说明UI面板 public Button nextButton; public Button grantButton; private string[] _requiredPermissions = new string[] { Permission.ExternalStorageRead, Permission.Camera, Permission.Microphone }; private int _currentIndex = 0; void Start() { ShowCurrentPermissionPanel(); } void ShowCurrentPermissionPanel() { if (_currentIndex >= _requiredPermissions.Length) { // 所有权限处理完毕，进入主场景 SceneManager.LoadScene("MainMenu"); return; } string currentPerm = _requiredPermissions[_currentIndex]; // 激活对应的说明UI面板 for (int i = 0; i < permissionPanels.Length; i++) { permissionPanels[i].SetActive(i == _currentIndex); } // 检查是否已有权限 if (AppPermissionManager.Instance.CheckPermission(currentPerm)) { // 已有权限，直接下一个 _currentIndex++; ShowCurrentPermissionPanel(); } else { // 没有权限，显示说明和“授权”按钮 grantButton.onClick.RemoveAllListeners(); grantButton.onClick.AddListener(() => RequestCurrentPermission()); grantButton.gameObject.SetActive(true); nextButton.gameObject.SetActive(false); // “跳过”或“下一步”按钮，根据设计决定 } } void RequestCurrentPermission() { string perm = _requiredPermissions[_currentIndex]; AppPermissionManager.Instance.RequestPermission(perm, (granted, dontAskAgain) => { if (granted) { _currentIndex++; ShowCurrentPermissionPanel(); } else { // 处理拒绝逻辑 if (dontAskAgain) { // 提示必须去设置页开启，否则某些功能不可用 ShowMandatoryDialog(perm); } else { // 用户本次拒绝，可以选择“跳过该权限”或“再次询问” ShowSkipOrRetryDialog(perm); } } }); } // ... 其他UI控制方法 }

4.2 场景二：按需申请与用户体验优化

更好的用户体验是“按需申请”。即用户第一次点击“拍照”按钮时，才申请相机权限。

关键技巧：

• 预检查：在按钮点击事件里，首先检查权限。
• 即时申请：如果没有权限，立即触发系统弹窗。
• 优雅降级：如果用户拒绝，则禁用相关功能或显示一个占位UI（比如一个灰色的相机图标，上面有个锁），并提示“需要相机权限才能使用此功能”。
• 提供入口：在被拒绝的占位UI上，提供一个“去设置”或“重新授权”的按钮入口。

public class CameraButtonHandler : MonoBehaviour { public Button cameraButton; public Image buttonIcon; public Sprite lockedSprite; public Sprite unlockedSprite; void Start() { UpdateButtonState(); cameraButton.onClick.AddListener(OnCameraButtonClicked); } void UpdateButtonState() { bool hasPermission = AppPermissionManager.Instance.CheckPermission(Permission.Camera); buttonIcon.sprite = hasPermission ? unlockedSprite : lockedSprite; // 也可以改变按钮颜色或文本 } void OnCameraButtonClicked() { if (AppPermissionManager.Instance.CheckPermission(Permission.Camera)) { OpenCamera(); } else { // 首次触发，直接申请 AppPermissionManager.Instance.RequestPermission(Permission.Camera, (granted, dontAskAgain) => { if (granted) { UpdateButtonState(); OpenCamera(); } else { // 更新按钮为锁定状态，并显示提示 UpdateButtonState(); ShowInAppToast("拍照功能需要相机权限哦~"); // 可以在这里显示一个小的提示气泡，引导用户长按按钮去设置 } }); } } void OpenCamera() { // 打开相机的逻辑 } }

4.3 场景三：处理“不再询问”与引导至系统设置

当用户勾选了“不再询问”并拒绝后，PermissionCallbacks.PermissionDeniedAndDontAskAgain会被触发。此时，调用Permission.RequestUserPermission将不再弹出系统对话框，你必须引导用户去应用的系统设置页面手动开启。

如何打开系统设置页？Unity没有直接打开本应用权限设置页的API。一个常见的做法是使用Application.OpenURL并传入一个特殊的URL scheme。但这个scheme并非官方标准，在不同厂商的Android系统上可能不同，甚至无效。

相对可靠的方法：

public void OpenAppSystemSettings() { try { // 通用Intent方式（通过AndroidJavaObject调用原生API） using (var unityClass = new AndroidJavaClass("com.unity3d.player.UnityPlayer")) using (var currentActivity = unityClass.GetStatic<AndroidJavaObject>("currentActivity")) using (var intentClass = new AndroidJavaClass("android.content.Intent")) using (var settingsIntent = new AndroidJavaObject("android.content.Intent", intentClass.GetStatic<string>("ACTION_APPLICATION_DETAILS_SETTINGS")) { var packageName = currentActivity.Call<string>("getPackageName"); var uriClass = new AndroidJavaClass("android.net.Uri"); var uri = uriClass.CallStatic<AndroidJavaObject>("fromParts", "package", packageName, null); settingsIntent.Call<AndroidJavaObject>("setData", uri); settingsIntent.Call<AndroidJavaObject>("addFlags", intentClass.GetStatic<int>("FLAG_ACTIVITY_NEW_TASK")); currentActivity.Call("startActivity", settingsIntent); } } catch (System.Exception e) { Debug.LogError("打开系统设置失败: " + e.Message); // 降级方案：提示用户手动前往设置 ShowManualGuideDialog(); } }

更稳妥的UI设计：与其依赖可能失效的自动跳转，不如设计一个清晰的指引界面。

1. 弹出一个全屏或半屏的对话框。
2. 用图文并茂的方式告诉用户：“您已永久拒绝XX权限，请按以下步骤操作：1. 点击‘打开设置’按钮尝试跳转；2. 若未跳转，请手动找到‘设置’应用 -> 应用管理 -> 找到[本应用名称] -> 权限 -> 开启XX权限。”
3. 提供两个按钮：“打开设置”（尝试调用上述代码）和“知道了”（关闭对话框）。
4. 用户从设置页返回应用后，在OnApplicationPause或OnApplicationFocus事件中，调用AppPermissionManager.Instance.InvalidateCache清除缓存并重新检查权限状态。

5. 进阶话题与疑难问题排查

5.1 处理Android不同版本与厂商的差异

这是动态权限开发中最令人头疼的部分。

• Android 13 (API 33) 及以上的媒体权限：READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE对于媒体文件的访问被更细粒度的READ_MEDIA_IMAGES、READ_MEDIA_VIDEO、READ_MEDIA_AUDIO权限取代。你需要根据Application.platform和Android版本进行条件判断和申请。

  string GetStoragePermission() { #if UNITY_ANDROID && !UNITY_EDITOR if (Build.VERSION.SDK_INT >= BuildVersionCodes.TIRAMISU) // API 33 { // 根据实际需要返回具体的媒体权限 return "android.permission.READ_MEDIA_IMAGES"; } else { return Permission.ExternalStorageRead; } #else return Permission.ExternalStorageRead; // 编辑器或其他平台 #endif }

  注意：Unity的Permission类常量可能还未包含这些新权限字符串，你可能需要直接使用字符串"android.permission.READ_MEDIA_IMAGES"。

• 后台位置权限：从Android 10 (API 29)开始，如果应用在后台时需要访问位置，必须单独申请ACCESS_BACKGROUND_LOCATION权限。这个权限的申请流程更严格，系统会给出更醒目的提示。你需要在AndroidManifest.xml中声明，并在代码中单独申请。

• 厂商定制系统（MIUI, EMUI, ColorOS等）：这些系统可能有额外的权限管理、自启动管理、电池优化等设置，即使你通过了标准权限申请，功能仍可能被系统限制。在测试时，务必在主流国产机型上进行真机测试。常见的坑包括：

  • 悬浮窗权限：不属于标准Android权限，但很多应用需要。需要引导用户去特殊的“应用权限管理”里开启。
  • 自启动管理：被禁止后，后台服务可能无法运行。
  • 省电策略：可能会限制你的应用在后台使用网络或GPS。

5.2 权限申请流程的调试与日志

在Unity编辑器中，权限检查默认返回true，RequestUserPermission也不会真的弹窗。这给调试带来了困难。

调试方法：

1. 使用Android Logcat：在Unity中打开Window -> Analysis -> Logcat，连接真机或模拟器。过滤Unity标签，查看权限申请相关的日志输出。你可以在C#代码中用Debug.Log打印关键步骤。
2. 模拟权限拒绝：在编辑器里很难模拟“拒绝”和“不再询问”。一个办法是写一个编辑器下的模拟类，在#if UNITY_EDITOR预处理指令下替换Permission类的行为，方便测试各种回调分支。
3. 真机测试是王道：任何权限逻辑，最终都必须在真机上进行全面测试。准备多台不同Android版本的测试机。

5.3 常见问题排查清单

5.4 权限与玩家数据存储的考量

如果你的游戏需要保存存档、配置到本地，优先使用Application.persistentDataPath。这个路径在Android上位于应用沙盒内（/data/data/包名/files或/storage/emulated/0/Android/data/包名/files），不需要任何存储权限即可读写。这是最安全、最推荐的方式。

只有当你的应用需要：

• 读取用户手机上的图片、音乐、视频。
• 将文件保存到公共下载目录或相册。
• 与其他应用共享文件。 时，才需要申请存储权限。在申请前，务必向用户清晰说明用途，遵循“最小必要”原则。

最后，记住动态权限申请的核心是用户体验。弹窗时机要恰当，解释要清晰，拒绝后的引导要友好。把它当作一个与用户对话的过程，而不是一个冷冰冰的技术障碍。处理好这些细节，你的应用在Android平台上的兼容性和口碑都会提升一个档次。