Unity 在Unity端动态申请Android权限的实践与优化

1. 从一次闪退说起：为什么要在Unity里申请Android权限？

几年前我还在做一款AR应用的时候，遇到过一个特别头疼的bug。应用里集成了一个第三方的扫码SDK，在用户第一次点击“扫码”按钮时，理论上应该弹出相机权限申请，用户同意后直接打开相机。但诡异的事情发生了：在某些Android 13的手机上，这个流程会连续弹出两次权限申请窗口，然后在第二次拍照完成后，应用直接闪退。更奇怪的是，只要用户同意过一次权限，之后再扫码就一切正常，闪退只发生在“首次申请权限”这个关键时刻。

当时排查了很久，从SDK的日志看到，它内部封装了权限申请逻辑。初步怀疑是SDK在Android 13的权限模型适配上有问题。我尝试把项目的Target API Level从33（Android 13）降到30（Android 10），但问题依旧。这说明可能不是单纯的API版本兼容性问题。后来我换了个思路：既然SDK自己申请权限会出问题，那我能不能在调用SDK之前，先由我的Unity应用把相机权限申请好呢？这样SDK被调用时，检测到权限已经拥有，就会跳过自己的申请流程，直接打开相机。

说干就干。我在Unity里写了几行代码，在应用启动后、进入主界面之前，就主动向用户申请相机权限。测试下来，闪退问题真的解决了！这个经历让我深刻体会到，把权限申请的主动权掌握在自己手里是多么重要。它不仅能规避第三方SDK可能存在的兼容性坑，还能让我们对用户体验有更强的把控力，比如决定在什么时机、以什么方式向用户请求权限，而不是把这一切交给“黑盒”。

所以，今天我们就来深入聊聊，如何在Unity端优雅、健壮地动态申请Android权限。这不仅仅是调用一个API那么简单，它涉及到权限声明、运行时请求、回调处理、用户体验优化等一系列实践细节。我会把我踩过的坑和总结的最佳实践都分享出来，让你在遇到类似问题时能从容应对。

2. 基础搭建：权限声明与Unity API初探

在开始写代码之前，我们必须搞清楚一个核心原则：所有需要在运行时申请的Android权限，都必须先在AndroidManifest.xml文件中进行声明。你可以把它理解为应用的“权限清单”，告诉Android系统和应用商店，我这个应用可能会用到哪些敏感功能。没有声明就直接申请，权限请求是无效的。

2.1 配置你的AndroidManifest.xml

Unity项目在打包Android应用时，会生成一个最终的AndroidManifest.xml文件。我们需要在这个文件里添加权限声明。最规范的做法是使用一个自定义的清单文件。

首先，打开Unity编辑器，进入 File -> Build Settings，选择Android平台，点击 Player Settings...。在打开的Player Settings窗口中，找到 Publishing Settings 区域（旧版本可能叫 Other Settings 下的 Configuration）。这里面有一个 Custom Main Manifest 的复选框。

勾选它！这个操作至关重要。勾选后，Unity会在你项目的 Assets/Plugins/Android/ 目录下自动生成一个名为 AndroidManifest.xml 的模板文件。如果这个目录不存在，Unity也会一并创建。现在，所有关于Android Manifest的修改，我们都应该在这个自定义文件里进行，Unity在打包时会用它来覆盖默认的清单。

接下来，用任何文本编辑器（比如VSCode、Sublime Text）打开这个 AndroidManifest.xml 文件。我们需要在 <manifest> 标签内部、<application> 标签之前，添加我们需要的权限。例如，要申请相机和外部存储读写权限，可以这样添加：

<?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" />
    <!-- 声明读取外部存储权限（Android 13+ 可能需要细化） -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <!-- 声明写入外部存储权限（针对旧版本Android） -->
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <!-- 如果需要访问精确位置 -->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <!-- 如果需要访问粗略位置 -->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

    <application
        ...>
        ...
    </application>
</manifest>

这里有个关键点要注意：从Android 6.0（API Level 23）开始，权限被分为普通权限和危险权限。普通权限（比如网络访问）在清单中声明后，系统会在安装时自动授予。而危险权限（比如相机、位置、通讯录等）不仅需要在清单中声明，还必须在运行时向用户动态申请，获得用户明确同意后才能使用。我们这篇文章讨论的核心，就是如何申请这些“危险权限”。

2.2 认识Unity的权限请求API