企业官网建设流程全解析

1. 项目概述与核心痛点

最近在PICO 4 Ultra上折腾一个Unity项目，需要把运行时生成的一些日志和用户配置文件保存到设备的外部存储里，结果在Android API Level 32（也就是Android 12L）及以上版本上，直接卡在了文件读写权限这一步。相信不少从移动端或传统VR设备转向PICO 4 Ultra开发的同行都遇到过类似问题：明明在编辑器里跑得好好的，File.WriteAllText也没报错，但一到真机上，文件要么写不进去，要么写进去了也找不到，或者直接给你抛个UnauthorizedAccessException。

这个问题的根源，在于Android系统的权限沙箱机制在不断收紧，尤其是从API Level 30（Android 11）引入作用域存储（Scoped Storage）开始，到API Level 33（Android 13）进一步加强管理，应用对外部存储的访问受到了极其严格的限制。PICO 4 Ultra出厂系统基于Android 12L，其默认的Target API Level往往要求设置到30甚至更高，以符合应用商店的合规要求。这就意味着，我们过去在低API Level下那些“简单粗暴”的读写外部存储的方法，比如直接使用Environment.GetExternalStoragePublicDirectory，已经彻底行不通了。

本指南将彻底拆解在Unity中，为适配PICO 4 Ultra等Android 12L+设备，正确配置外部文件读写权限的完整流程。这不仅仅是在Player Settings里勾选一个WRITE_EXTERNAL_STORAGE权限那么简单，而是一套从项目设置、清单文件（AndroidManifest）配置、运行时动态权限请求，到最终使用正确的API进行文件操作的组合拳。我会结合最近在PICO 4 Ultra上的实际踩坑经验，把每个步骤的原理、意图和避坑点都讲清楚，目标是让你配置一次，就能稳定地在高版本Android系统上实现可靠的文件读写。

2. 环境准备与项目基础配置

在开始处理权限这个“上层建筑”之前，我们必须先把“地基”打牢。这里的核心是确保Unity项目针对Android（尤其是PICO设备）的构建环境是正确的，并且设定了正确的目标API级别。

2.1 Unity版本与Android模块确认

首先，确保你使用的Unity版本与PICO SDK兼容。目前PICO官方推荐使用Unity 2021 LTS或2022 LTS版本进行开发。你可以在Unity Hub中检查或安装对应的Android Build Support模块，特别是Android SDK & NDK Tools和OpenJDK。一个常见的坑是只安装了Unity，但没有安装Android模块，导致构建时找不到SDK路径。

安装完成后，在Unity编辑器中，打开Edit > Preferences > External Tools，检查Android SDK、JDK和NDK的路径是否已自动配置。如果没有，你需要手动指向它们的安装目录。对于PICO开发，通常使用Unity内置的或PICO SDK包中推荐的NDK版本即可，避免使用过新或过旧的版本导致原生库编译问题。

2.2 关键配置：Player Settings中的Target API Level

这是整个流程中最关键的一步，它决定了你的应用将在哪种权限模型下运行。打开File > Build Settings，确保平台切换到了Android，然后点击Player Settings...按钮。

在打开的Project Settings窗口中，找到Player > Other Settings区域：

1. Identification部分：确保Bundle Identifier符合反向域名格式（如com.YourCompany.YourApp）。
2. Configuration部分：找到Target API Level这个下拉菜单。这里的设置至关重要。

选项解析与选择策略：

• Automatic (highest installed)：不推荐。这会让Unity使用你本地安装的最高版本SDK进行构建，可能导致在低版本设备上出现意外行为。
• API Level XX：你需要手动指定一个具体的级别。
  • 对于PICO 4 Ultra（Android 12L）：最低要求通常是API Level 31 (Android 12)。但为了更好的兼容性和符合应用商店的未来要求，我强烈建议直接设置为API Level 32 (Android 12L)或API Level 33 (Android 13)。这能确保你的应用在最新的权限模型下进行测试和开发。

为什么必须设置高Target API Level？谷歌Play商店对于新应用和重大更新有强制性的Target API Level要求。即使PICO商店目前可能没有如此严格的规定，但使用高Target API Level进行开发，可以让你提前适配更严格的隐私和安全规范，避免未来被动。更重要的是，很多与存储相关的行为（尤其是作用域存储）在低Target API Level下会被兼容性框架“放行”，从而掩盖了真实问题，导致你在真机（高系统版本）上测试时才发现功能失效。因此，从项目初期就面向高API Level开发，是最高效的做法。

3. 在同一个Other Settings区域，向下滚动，找到Write Permission选项（在Install Location附近）。对于需要写入外部存储的应用，将其从默认的Internal改为External (SDCard)。这个设置告诉系统，你的应用期望被允许写入外部共享存储。

2.3 导入PICO Unity Integration SDK

从PICO开发者平台下载并导入最新版本的PICO Unity Integration SDK（例如PICO Unity Integration SDK v2.x.x.unitypackage）。导入后，通常会在Window > PICO菜单下找到相关的工具和设置面板。确保SDK初始化成功，并且项目中没有出现编译错误。这个SDK除了提供XR功能外，其自带的AndroidManifest.xml基础模板也包含了PICO设备所需的一些基本权限和特性声明，是我们进行后续权限定制的基础。

3. Android清单文件深度解析与权限声明

Android应用的权限和组件声明，全部依赖于AndroidManifest.xml文件。在Unity中，这个文件通常由Unity根据Player Settings和已导入的插件（如PICO SDK）自动生成和合并。但为了声明高级权限和配置，我们需要提供一个自定义的清单文件来覆盖或补充默认内容。

3.1 创建自定义的AndroidManifest.xml

1. 在你的Unity项目Assets目录下，创建一个名为Plugins的文件夹（如果不存在）。
2. 在Plugins文件夹内，再创建一个名为Android的文件夹。这是Unity约定俗成的路径，用于存放Android平台特有的资源。
3. 在Android文件夹内，创建一个新的XML文件，命名为AndroidManifest.xml。

你可以从一个简单的模板开始。一个最基础的、声明了外部存储写入权限的清单文件如下：

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.YourCompany.YourApp" android:installLocation="preferExternal"> <!-- 应用运行所需的基本权限 --> <uses-permission android:name="android.permission.INTERNET" /> <!-- 关键：声明应用需要外部存储写入权限（Android 10及以下/传统模型） --> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="29" /> <!-- 注意：从Android 11（API 30）开始，WRITE_EXTERNAL_STORAGE权限对于访问共享存储已失效。 但为了兼容targetSdkVersion < 30的应用，我们仍声明它，并用maxSdkVersion限制其只在低版本系统上生效。 --> <!-- 关键：声明应用需要管理外部存储的权限（Android 11及以上/作用域存储模型） --> <!-- 这个权限是访问MediaStore集合（如图片、视频、音频）和下载目录所必需的。 --> <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" /> <!-- 关键：声明应用请求所有文件访问的特殊权限（Android 11及以上） --> <!-- 这个权限允许应用访问共享存储上的任何文件，但需要用户手动在系统设置中授权，且上架商店可能受限。 --> <!-- 慎用！仅在绝对需要访问非媒体文件时使用，并做好被应用商店审核质询的准备。 --> <!-- <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" /> --> <!-- 实际上，MANAGE_EXTERNAL_STORAGE权限的声明就是上面那一行。这里再次注释是为了强调其特殊性。 --> <!-- 为了请求MANAGE_EXTERNAL_STORAGE权限，必须在application标签内添加一个特定属性 --> <application android:requestLegacyExternalStorage="true" android:allowBackup="true" android:icon="@drawable/app_icon" android:label="@string/app_name" android:theme="@style/UnityThemeSelector"> <!-- 你的活动（Activity）和其他组件声明会由Unity和PICO SDK自动合并进来 --> <activity android:name="com.unity3d.player.UnityPlayerActivity" android:exported="true"> <!-- ... --> </activity> </application> </manifest>

3.2 关键权限与属性详解

• android:installLocation="preferExternal"：建议系统将应用安装到外部存储（如果存在）。这可以为设备内部存储节省空间，但对于PICO 4 Ultra这类通常只有内置存储的设备，影响不大。
• android.permission.WRITE_EXTERNAL_STORAGE与android:maxSdkVersion="29"：这对组合是兼容性配置。在API Level 29（Android 10）及以下的设备上，系统会向用户请求此权限。在API Level 30+的设备上，系统会忽略此权限声明，因为该权限对于访问共享存储已不再有效。务必添加maxSdkVersion属性，否则在高版本系统上，应用可能会在安装时就被标记为请求了一个“过时”的权限。
• android.permission.MANAGE_EXTERNAL_STORAGE：这是Android 11（API 30）及以上版本中，访问共享存储空间（即传统的/sdcard/目录下的公共区域）的关键权限。但请注意，拥有此权限并不意味着可以随意读写任何位置。它的主要作用是让你能够使用MediaStoreAPI或Storage Access Framework (SAF)来访问公共目录（如Downloads,Documents,Pictures等）。直接使用传统的java.io.File路径去访问/sdcard/根目录或任意子目录，即使有这个权限，在API 30+上也是行不通的。
• android:requestLegacyExternalStorage="true"：这是一个临时的兼容性标志。当你的targetSdkVersion为29（Android 10）时，设置此属性为true可以让你暂时退出作用域存储的限制，继续使用旧的文件API。但是，当targetSdkVersion>= 30时，这个属性将完全失效。我们的配置中保留它，主要是为了应对某些中间环节或插件可能仍依赖它，但核心逻辑绝不能依赖它。

3.3 清单文件的合并与覆盖规则

Unity在构建APK时，会收集项目中所有的AndroidManifest.xml文件（包括Unity自带的、PICO SDK提供的、以及其他插件提供的），并将它们合并成一个最终的文件。合并规则大致是：后处理的清单可以覆盖先处理的清单中相同的元素。我们放在Assets/Plugins/Android/下的自定义清单，通常会在最后被处理，因此可以有效地覆盖之前的设置。

一个常见的坑是权限声明冲突或重复。确保你的自定义清单中没有声明不必要的权限，特别是那些可能被标记为“危险”或“特殊”的权限，除非你确实需要。你可以通过构建APK后，使用aapt2或apkanalyzer工具检查最终的合并清单来确认。

4. 运行时动态权限请求实现

在Android 6.0（API 23）之后，危险权限（如存储权限）不仅需要在清单文件中声明，还需要在运行时向用户动态请求并获得授权。对于MANAGE_EXTERNAL_STORAGE这个特殊权限，其请求流程又和普通危险权限略有不同。

4.1 检测与请求标准存储权限（针对API<30）

对于API Level 29及以下的设备，我们仍然需要请求WRITE_EXTERNAL_STORAGE权限。我们可以编写一个通用的权限管理类。

首先，在Unity中创建一个C#脚本，例如RuntimePermissionManager.cs。我们需要使用Android Java接口来调用系统的权限API。

using UnityEngine; using UnityEngine.Android; // Unity封装好的Android权限API using System.Collections; using UnityEngine.Android; public class RuntimePermissionManager : MonoBehaviour { public static RuntimePermissionManager Instance { get; private set; } private void Awake() { if (Instance == null) { Instance = this; DontDestroyOnLoad(gameObject); } else { Destroy(gameObject); } } /// <summary> /// 检查并请求写入外部存储的权限（针对Android 10及以下） /// </summary> public void CheckAndRequestWritePermission() { // 使用Unity封装的Permission类，它简化了Android API的调用 if (Permission.HasUserAuthorizedPermission(Permission.ExternalStorageWrite)) { Debug.Log("WRITE_EXTERNAL_STORAGE权限已授予。"); OnWritePermissionGranted(); } else { Debug.Log("请求WRITE_EXTERNAL_STORAGE权限..."); var callbacks = new PermissionCallbacks(); callbacks.PermissionGranted += (permissionName) => { Debug.Log($"{permissionName}权限已授予。"); OnWritePermissionGranted(); }; callbacks.PermissionDenied += (permissionName) => Debug.LogWarning($"{permissionName}权限被拒绝。"); callbacks.PermissionDeniedAndDontAskAgain += (permissionName) => Debug.LogError($"{permissionName}权限被永久拒绝，请去设置中手动开启。"); Permission.RequestUserPermission(Permission.ExternalStorageWrite, callbacks); } } private void OnWritePermissionGranted() { // 权限获取成功后的回调，可以在这里初始化文件操作 Debug.Log("可以开始进行文件操作了。"); // 例如：检查或创建应用专属外部目录 CheckOrCreateAppExternalDirectory(); } private void CheckOrCreateAppExternalDirectory() { // 获取应用专属外部存储目录，这个目录在Android 4.4+上无需权限即可访问 string appExternalPath = Application.persistentDataPath; Debug.Log($"应用专属外部存储路径: {appExternalPath}"); // 这个路径通常位于 /Android/data/<package_name>/files/ // 你可以在这里安全地创建和读写文件。 } }

4.2 处理MANAGE_EXTERNAL_STORAGE特殊权限（针对API>=30）

MANAGE_EXTERNAL_STORAGE权限的请求方式与普通权限不同。用户不会被一个系统弹窗询问，而是会被引导至系统的“所有文件访问权限”设置页面。我们需要检查权限状态，并在未授权时打开这个设置页面。

我们需要使用Android原生API。为此，可以创建一个Android Java插件，或者使用Unity的AndroidJavaClass和AndroidJavaObject直接调用。

在RuntimePermissionManager.cs中增加以下方法：

using System; using UnityEngine; public class RuntimePermissionManager : MonoBehaviour { // ... 之前的代码 ... /// <summary> /// 检查是否拥有管理所有文件的权限（Android 11+） /// </summary> public bool HasManageExternalStoragePermission() { // 仅当运行在Android 11 (API 30) 及以上时检查 if (Application.platform == RuntimePlatform.Android && GetAndroidAPILevel() >= 30) { try { using (AndroidJavaClass environment = new AndroidJavaClass("android.os.Environment")) { bool isExternalStorageManager = environment.CallStatic<bool>("isExternalStorageManager"); return isExternalStorageManager; } } catch (Exception e) { Debug.LogError($"检查MANAGE_EXTERNAL_STORAGE权限时出错: {e.Message}"); return false; } } return false; // 低版本Android不需要此权限 } /// <summary> /// 请求管理所有文件的权限（打开系统设置页面） /// </summary> public void RequestManageExternalStoragePermission() { if (Application.platform != RuntimePlatform.Android || GetAndroidAPILevel() < 30) { Debug.Log("当前设备或系统版本无需请求MANAGE_EXTERNAL_STORAGE权限。"); return; } if (HasManageExternalStoragePermission()) { Debug.Log("已拥有MANAGE_EXTERNAL_STORAGE权限。"); OnManageExternalStorageGranted(); return; } Debug.Log("准备跳转到设置页面以请求MANAGE_EXTERNAL_STORAGE权限..."); try { using (AndroidJavaClass unityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer")) using (AndroidJavaObject currentActivity = unityPlayer.GetStatic<AndroidJavaObject>("currentActivity")) using (AndroidJavaClass intentClass = new AndroidJavaClass("android.content.Intent")) { // 创建指向系统设置中“所有文件访问权限”页面的Intent AndroidJavaObject intent = new AndroidJavaObject("android.content.Intent", intentClass.GetStatic<string>("ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION")); string packageName = currentActivity.Call<string>("getPackageName"); AndroidJavaObject uri = new AndroidJavaClass("android.net.Uri").CallStatic<AndroidJavaObject>("parse", "package:" + packageName); intent.Call<AndroidJavaObject>("setData", uri); // 添加标志，确保从设置返回后能回到我们的应用 intent.Call<AndroidJavaObject>("addFlags", intentClass.GetStatic<int>("FLAG_ACTIVITY_NEW_TASK")); currentActivity.Call("startActivity", intent); Debug.Log("已启动系统设置页面，请用户手动授权。"); } } catch (Exception e) { Debug.LogError($"启动MANAGE_EXTERNAL_STORAGE权限请求页面失败: {e.Message}"); // 备选方案：打开通用的应用详情设置页面 OpenAppSettings(); } } /// <summary> /// 打开本应用的系统设置详情页（通用后备方案） /// </summary> private void OpenAppSettings() { try { using (AndroidJavaClass unityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer")) using (AndroidJavaObject currentActivity = unityPlayer.GetStatic<AndroidJavaObject>("currentActivity")) using (AndroidJavaClass intentClass = new AndroidJavaClass("android.content.Intent")) { string packageName = currentActivity.Call<string>("getPackageName"); AndroidJavaObject intent = new AndroidJavaObject("android.content.Intent", intentClass.GetStatic<string>("ACTION_APPLICATION_DETAILS_SETTINGS")); AndroidJavaObject uri = new AndroidJavaClass("android.net.Uri").CallStatic<AndroidJavaObject>("fromParts", "package", packageName, null); intent.Call<AndroidJavaObject>("setData", uri); intent.Call<AndroidJavaObject>("addFlags", intentClass.GetStatic<int>("FLAG_ACTIVITY_NEW_TASK")); currentActivity.Call("startActivity", intent); } } catch (Exception e) { Debug.LogError($"打开应用设置页失败: {e.Message}"); } } private void OnManageExternalStorageGranted() { Debug.Log("MANAGE_EXTERNAL_STORAGE权限已获得。"); // 现在可以使用特定API访问共享存储了（注意：仍不能随意使用File API访问任意路径） // 例如，可以使用MediaStore或SAF } /// <summary> /// 获取当前设备的Android API Level /// </summary> private int GetAndroidAPILevel() { if (Application.platform == RuntimePlatform.Android) { using (AndroidJavaClass version = new AndroidJavaClass("android.os.Build$VERSION")) { return version.GetStatic<int>("SDK_INT"); } } return 0; } // 在应用启动或需要权限的界面初始化时调用 void Start() { int apiLevel = GetAndroidAPILevel(); Debug.Log($"当前Android API Level: {apiLevel}"); if (apiLevel >= 30) { // Android 11+，检查并请求MANAGE_EXTERNAL_STORAGE if (!HasManageExternalStoragePermission()) { // 可以在这里直接请求，或者设计一个UI按钮让用户触发 Debug.LogWarning("需要MANAGE_EXTERNAL_STORAGE权限来访问共享存储。"); // RequestManageExternalStoragePermission(); // 根据你的UX设计决定何时调用 } else { OnManageExternalStorageGranted(); } } else { // Android 10及以下，请求WRITE_EXTERNAL_STORAGE CheckAndRequestWritePermission(); } } }

4.3 权限请求的最佳实践与用户体验

1. 按需请求：不要在应用一启动就请求所有危险权限。这会让用户感到困惑和被打扰。应该在用户即将执行需要该权限的操作（例如，点击“保存截图到相册”按钮）时，才去请求对应的权限。
2. 解释原因：在请求权限前，最好通过一个简单的弹窗向用户解释为什么需要这个权限（例如，“为了将游戏截图保存到您的设备相册中，需要访问存储权限”）。这可以大大提高用户的授权率。
3. 处理拒绝：用户可能会拒绝权限。你的应用应该优雅地处理这种情况：禁用相关功能，并提示用户“该功能需要存储权限，您可以在系统设置中为应用授权”。可以提供一键跳转到应用设置页面的按钮。
4. MANAGE_EXTERNAL_STORAGE的特殊性：这个权限的请求流程是跳转到系统设置，这是一个非常重的操作。务必向用户清晰说明为什么你需要如此广泛的文件访问权限，并且只在绝对必要（例如，文件管理器类应用）时才请求它。对于大多数应用，应该优先使用应用专属目录或MediaStoreAPI来访问特定类型的文件，避免请求此权限。

5. 高版本Android系统下的文件操作实践

获得了权限，并不意味着你可以像过去一样随意使用System.IO下的File或Directory类去读写/sdcard/下的任意路径。在Android 11（API 30）及以上版本，即使拥有MANAGE_EXTERNAL_STORAGE权限，直接使用传统文件路径访问共享存储的大部分区域也是被禁止的，或者行为不可预测。我们必须采用新的、系统认可的方式来访问文件。

5.1 首选方案：使用应用专属外部存储目录

这是最简单、最推荐的方式，无需任何运行时权限（从Android 4.4开始）。

// Unity 已经为我们提供了这个路径 string appExternalPrivatePath = Application.persistentDataPath; Debug.Log($"应用专属外部存储路径: {appExternalPrivatePath}"); // 在PICO 4 Ultra上，输出可能类似于： // /storage/emulated/0/Android/data/<你的包名>/files // 你可以在这个目录下自由创建、读取、写入、删除文件。 string logFilePath = Path.Combine(appExternalPrivatePath, "logs", "game_log.txt"); Directory.CreateDirectory(Path.GetDirectoryName(logFilePath)); // 确保目录存在 File.WriteAllText(logFilePath, "这是一条日志。"); // 读取也一样 if (File.Exists(logFilePath)) { string content = File.ReadAllText(logFilePath); }

优点：

• 零权限要求。
• 文件对其他应用不可见（默认），隐私性好。
• 当用户卸载应用时，该目录会被自动清理。

缺点：

• 文件无法被其他应用（如文件管理器、图库）直接访问。如果你想分享文件，需要将其“导出”到公共目录。

5.2 访问公共媒体目录（使用MediaStore API）

如果你需要保存图片、视频、音频或下载文件，并希望它们出现在系统的相册、音乐播放器或下载管理器中，你应该使用MediaStoreAPI。这需要READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限（在API<30时），或者MANAGE_EXTERNAL_STORAGE权限（在API>=30时，用于写入非应用专属的媒体文件）。

由于Unity C#环境直接调用MediaStore较为复杂，通常需要编写Android原生插件（Java/Kotlin）或使用第三方插件。其核心思想是：不再使用文件路径，而是通过ContentResolver向MediaStore数据库插入一条记录，由系统决定文件的实际存储位置并返回一个Uri，然后通过这个Uri来读写文件内容。

简化流程示例（概念性）：

1. 检查并获取必要的存储权限。
2. 创建一个ContentValues对象，设置文件的元数据（如MediaStore.Images.Media.DISPLAY_NAME,MediaStore.Images.Media.MIME_TYPE）。
3. 通过ContentResolver.insert()插入到对应的MediaStore集合（如MediaStore.Images.Media.EXTERNAL_CONTENT_URI），获得一个Uri。
4. 通过ContentResolver.openOutputStream(uri)获取输出流，写入文件数据。
5. 读取时，通过ContentResolver.query()查询MediaStore获得Uri，再通过ContentResolver.openInputStream(uri)读取。

5.3 访问任意文件（使用Storage Access Framework - SAF）

对于需要让用户自主选择文件或目录进行读写的场景（如导入/导出自定义数据包），Storage Access Framework (SAF) 是最佳选择。它通过系统文件选择器与用户交互，用户选择后，你的应用会获得一个代表该文件或目录的Uri，并拥有长期的访问权限。

在Unity中，可以通过AndroidJavaClass调用Intent.ACTION_OPEN_DOCUMENT或Intent.ACTION_CREATE_DOCUMENT等Intent来启动SAF选择器。处理返回的Uri同样需要用到Android原生API。

5.4 实践建议：为不同场景选择正确路径

为了代码的兼容性和清晰度，建议封装一个文件工具类，根据不同的用途返回正确的路径或处理方式：

public static class FileAccessHelper { // 获取应用内部私有目录（无需权限，完全控制） public static string GetAppPrivateDirectory() { return Application.persistentDataPath; } // 获取应用外部公共目录（需要权限，用于存放希望被其他应用访问的媒体文件） // 注意：这是一个传统路径，在API>=30时可能无法直接通过File API写入。 // 此方法主要用于获取目录概念，实际写入应通过MediaStore。 public static string GetPublicPicturesDirectory() { if (Application.platform == RuntimePlatform.Android) { // 传统路径，仅供参考和低版本兼容 return "/storage/emulated/0/Pictures/YourAppName/"; } // 其他平台（如Editor）的路径 return Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyPictures), "YourAppName"); } // 判断当前是否有权限进行共享存储写入 public static bool CanWriteToSharedStorage() { if (Application.platform != RuntimePlatform.Android) return true; // 非Android平台默认允许 int apiLevel = GetAndroidAPILevel(); if (apiLevel >= 30) { // Android 11+，需要MANAGE_EXTERNAL_STORAGE权限 return HasManageExternalStoragePermission(); } else { // Android 10及以下，需要WRITE_EXTERNAL_STORAGE权限 return Permission.HasUserAuthorizedPermission(Permission.ExternalStorageWrite); } } // 保存截图到公共相册的示例方法（需实现MediaStore交互） public static void SaveScreenshotToGallery(Texture2D screenshot) { if (!CanWriteToSharedStorage()) { Debug.LogError("无共享存储写入权限，无法保存到相册。"); return; } // 这里应调用封装好的MediaStore API方法 // MediaStoreHelper.SaveImage(screenshot); } }

6. 真机调试、构建与验证流程

配置完成后，必须在PICO 4 Ultra真机上进行彻底的测试。

6.1 构建APK并安装

1. 在Unity的Build Settings中，确保Target Architecture包含了ARM64（PICO 4 Ultra是64位设备）。
2. 连接你的PICO 4 Ultra到电脑，并确保设备已开启开发者模式（在设置->通用->关于本机中连续点击软件版本号）和USB调试。
3. 在Unity中点击Build And Run。Unity会编译项目并自动将APK安装到设备上。

6.2 权限验证与行为观察

1. 首次安装启动：观察应用启动时是否有系统弹窗请求WRITE_EXTERNAL_STORAGE权限（仅当targetSdkVersion < 30且在Android 10及以下设备上运行时）。对于MANAGE_EXTERNAL_STORAGE，不会有弹窗。
2. 触发权限请求：在你的应用中，调用RequestManageExternalStoragePermission()方法。你应该看到设备屏幕跳转到了“所有文件访问权限”的设置页面。手动开启开关，然后返回应用。
3. 检查权限状态：返回应用后，再次调用HasManageExternalStoragePermission()，应该返回true。
4. 执行文件操作：
   • 测试应用专属目录：尝试在Application.persistentDataPath下创建和读写文件。这应该总是成功的。
   • 测试共享存储（如果请求了权限）：尝试通过你实现的MediaStore或SAF方法，向公共目录（如Pictures）保存一张图片。然后断开USB，在PICO设备本地的“文件管理”或“图库”应用中查看文件是否存在。
   • 测试传统路径（应失败）：尝试直接用File.WriteAllText写入一个类似/storage/emulated/0/TestFile.txt的路径。在API Level 30+的设备上，这个操作应该会失败或文件被写入沙箱位置（你无法直接访问）。这是一个重要的验证步骤，确保你没有错误地依赖旧API。

6.3 使用ADB进行深度排查

如果遇到问题，Android Debug Bridge (ADB) 是强大的排查工具。

1. 查看日志：在命令行中使用adb logcat -s Unity来过滤Unity和你的应用输出的日志，查看权限请求和文件操作相关的错误信息。
2. 检查权限：安装应用后，使用命令adb shell dumpsys package <你的包名> | grep permission可以查看应用声明的和已授予的权限列表。确认android.permission.MANAGE_EXTERNAL_STORAGE是否在列表中。
3. 检查文件：使用adb shell进入设备，导航到/storage/emulated/0/Android/data/<你的包名>/files/目录，查看应用专属文件是否正常创建。尝试访问你试图写入的公共目录，看看文件是否以预期的方式存在。
4. 模拟不同API Level：虽然PICO 4 Ultra是固定系统，但你可以在Android Studio的模拟器中创建不同API Level的虚拟设备，提前测试你的应用在不同系统版本上的兼容性。

7. 常见问题、疑难杂症与解决方案

在实际开发中，你可能会遇到一些棘手的情况。以下是我在PICO 4 Ultra和其他Android设备上遇到的一些典型问题及解决方法。

7.1 问题排查表

7.2 关于PICO设备特性的特别提醒

• 存储空间：PICO 4 Ultra的可用内部存储空间是用户和应用共享的。在写入大量数据（如高清录屏、缓存文件）时，务必做好空间检查和管理，避免把设备空间写满。
• 性能考量：频繁的I/O操作可能影响VR体验的流畅度。对于日志等频繁写入的操作，建议采用缓冲写入（先攒在内存里，定期写入文件）或使用异步写入方式。
• 用户交互：在VR环境中弹出系统的2D权限弹窗或设置页面，会打断用户的沉浸体验。务必在合适的时机（如应用启动后的主菜单、首次进行需要权限的操作前）以清晰的非沉浸式面板提示用户，解释权限用途，并引导其完成授权操作。

8. 总结与核心要点回顾

在PICO 4 Ultra这类高版本Android设备上进行Unity开发，外部文件读写权限的配置是一个从“项目设置”到“清单声明”，再到“运行时请求”和“API使用”的完整链条，任何一个环节出错都会导致功能失效。

核心流程再梳理：

1. 设定高Target API Level：在Player Settings中明确设置Target API Level为31或更高，从开发初期就面向新的存储规范。
2. 正确声明权限：在自定义的AndroidManifest.xml中，使用<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="29" />处理旧版本兼容，并声明<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />以适配Android 11+。
3. 实现动态权限请求：使用Unity的Permission类请求旧版存储权限；使用Android原生接口（AndroidJavaClass）检查并引导用户开启MANAGE_EXTERNAL_STORAGE权限。
4. 使用正确的文件API：这是最关键也是最容易出错的一步。彻底放弃直接使用文件路径读写共享存储的旧习惯。
   • 应用私有文件：无条件使用Application.persistentDataPath。
   • 公共媒体文件：学习并使用MediaStoreAPI。
   • 用户自定义文件存取：使用Storage Access Framework (SAF)。

最后的个人建议：除非你的应用是文件管理器、备份工具等必须访问广泛文件系统的类型，否则应尽量避免请求MANAGE_EXTERNAL_STORAGE权限。优先考虑将文件保存在应用专属目录，然后通过系统的分享功能（Intent.ACTION_SEND）将文件发送给其他应用，或者引导用户使用SAF来选择保存位置。这不仅能简化你的权限处理逻辑，也能让应用更容易通过各大应用商店的审核，为用户提供更安全、更符合现代Android设计规范的使用体验。在PICO 4 Ultra上开发，本质就是在为现代Android系统开发，尽早拥抱这些变化，能让你的项目走得更远。