1. 項(xiàng)目概述為什么Android 13權(quán)限適配是Unity開發(fā)者的“必修課”如果你最近用Unity打包的Android游戲在Android 13設(shè)備上運(yùn)行時(shí)突然發(fā)現(xiàn)相機(jī)打不開、相冊(cè)訪問(wèn)不了或者通知不彈了別急著懷疑是自己的代碼寫錯(cuò)了。這大概率是撞上了Android 13API 33引入的新一輪權(quán)限策略收緊。從Android 6.0的動(dòng)態(tài)權(quán)限到Android 10的作用域存儲(chǔ)再到Android 13的細(xì)粒度媒體權(quán)限和運(yùn)行時(shí)通知權(quán)限Google每一次大版本更新都在把“用戶隱私和數(shù)據(jù)安全”的緊箍咒再念緊一圈。對(duì)于Unity開發(fā)者來(lái)說(shuō)這不再是簡(jiǎn)單的調(diào)用幾個(gè)API的問(wèn)題而是一套需要從設(shè)計(jì)、編碼到測(cè)試全流程貫通的“合規(guī)性工程”。我經(jīng)歷過(guò)不止一次因?yàn)闄?quán)限問(wèn)題導(dǎo)致的線上事故新版本上線后差評(píng)突然增多核心功能失效排查半天才發(fā)現(xiàn)是目標(biāo)API等級(jí)Target API Level升級(jí)后新的權(quán)限模型生效了。所以今天我們不聊虛的直接切入實(shí)戰(zhàn)把Android 13下Unity游戲開發(fā)中那些“坑”一個(gè)個(gè)填平。我會(huì)帶你理解背后的機(jī)制并給出一套完整的、可復(fù)用的代碼方案讓你能優(yōu)雅地處理權(quán)限問(wèn)題而不是在用戶拒絕后讓游戲卡死或崩潰。記住優(yōu)雅的權(quán)限處理是提升用戶體驗(yàn)和留存率的關(guān)鍵一步絕不是可有可無(wú)的邊緣功能。2. Android 13權(quán)限模型的核心變化與Unity適配要點(diǎn)Android 13的權(quán)限變化不是小修小補(bǔ)而是對(duì)開發(fā)者習(xí)慣的一次“顛覆”。如果你還停留在“在Start()里一次性請(qǐng)求所有權(quán)限”的舊思維那你的應(yīng)用在Android 13上會(huì)舉步維艱。我們必須先理解這些變化才能寫出正確的代碼。2.1 細(xì)粒度媒體權(quán)限告別“讀寫存儲(chǔ)”一刀切在Android 13之前我們通常使用READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE這兩個(gè)“粗放”的權(quán)限來(lái)訪問(wèn)用戶的媒體文件。這相當(dāng)于你向用戶要了一把能打開他整個(gè)媒體庫(kù)包括照片、視頻、音樂(lè)的萬(wàn)能鑰匙。用戶自然會(huì)警惕。Android 13引入了更細(xì)分的媒體權(quán)限將訪問(wèn)權(quán)限與具體的媒體類型掛鉤READ_MEDIA_IMAGES僅讀取圖片和照片。READ_MEDIA_VIDEO僅讀取視頻。READ_MEDIA_AUDIO僅讀取音頻文件。這對(duì)Unity開發(fā)者的直接影響是什么目標(biāo)APITarget API Level 33時(shí)新規(guī)則強(qiáng)制生效。如果你的游戲需要保存截圖到相冊(cè)或者讓用戶選擇頭像你不能再只請(qǐng)求READ_EXTERNAL_STORAGE。如果你只需要讀取圖片就應(yīng)該只請(qǐng)求READ_MEDIA_IMAGES。WRITE_EXTERNAL_STORAGE在Android 13上幾乎被廢棄。對(duì)于媒體文件應(yīng)用現(xiàn)在擁有其創(chuàng)建的文件的完全訪問(wèn)權(quán)限無(wú)需寫入權(quán)限。向共享存儲(chǔ)寫入媒體文件應(yīng)使用MediaStoreAPI。Unity引擎的兼容性較老版本的Unity如2020.3 LTS之前的版本可能沒(méi)有預(yù)定義這些新權(quán)限的常量。你需要手動(dòng)聲明它們。注意如果你的應(yīng)用需要同時(shí)訪問(wèn)圖片和視頻你必須同時(shí)請(qǐng)求READ_MEDIA_IMAGES和READ_MEDIA_VIDEO兩個(gè)權(quán)限。系統(tǒng)會(huì)彈出一個(gè)合并的對(duì)話框但邏輯上是兩個(gè)獨(dú)立的權(quán)限請(qǐng)求。2.2 運(yùn)行時(shí)通知權(quán)限從安裝時(shí)授予到用時(shí)申請(qǐng)這是另一個(gè)重大變化。以前只要你在AndroidManifest.xml里聲明了POST_NOTIFICATIONS權(quán)限應(yīng)用安裝后默認(rèn)就擁有發(fā)送通知的能力?，F(xiàn)在POST_NOTIFICATIONS被提升為運(yùn)行時(shí)危險(xiǎn)權(quán)限。這意味著應(yīng)用必須在向用戶發(fā)送任何通知之前主動(dòng)請(qǐng)求并獲得該權(quán)限。請(qǐng)求的時(shí)機(jī)至關(guān)重要。最好的實(shí)踐是在用戶可能希望收到通知的上下文場(chǎng)景中請(qǐng)求例如在游戲設(shè)置中開啟“戰(zhàn)斗獎(jiǎng)勵(lì)提醒”時(shí)或者在社交功能中請(qǐng)求“好友消息通知”權(quán)限時(shí)。不要在游戲一啟動(dòng)就彈窗那會(huì)被用戶視為騷擾而拒絕。2.3 鄰近Wi-Fi權(quán)限與身體傳感器權(quán)限這兩項(xiàng)對(duì)特定品類的游戲影響較大NEARBY_WIFI_DEVICES用于發(fā)現(xiàn)和連接附近的Wi-Fi設(shè)備。如果你的游戲涉及本地多人聯(lián)機(jī)如通過(guò)Wi-Fi直連需要此權(quán)限。BODY_SENSORS訪問(wèn)身體傳感器如心率。主要針對(duì)健康類應(yīng)用普通游戲較少涉及。Unity適配的核心思路轉(zhuǎn)變從“一次性索要所有權(quán)限”轉(zhuǎn)變?yōu)榘葱?、分?chǎng)景、有解釋地請(qǐng)求權(quán)限。你的代碼邏輯需要變得更加動(dòng)態(tài)和智能。3. 實(shí)戰(zhàn)構(gòu)建一個(gè)優(yōu)雅的Unity Android權(quán)限管理器理解了理論我們開始動(dòng)手。我將構(gòu)建一個(gè)名為AndroidPermissionManager的單例類它負(fù)責(zé)所有權(quán)限相關(guān)的邏輯。這樣做的好處是職責(zé)清晰便于在整個(gè)項(xiàng)目中復(fù)用和維護(hù)。3.1 定義權(quán)限常量與管理器框架首先我們需要定義Android 13的新權(quán)限常量。因?yàn)閁nity的UnityEngine.Android.Permission類可能還未更新包含它們。// AndroidPermissionConstants.cs public static class AndroidPermissionConstants { // 傳統(tǒng)存儲(chǔ)權(quán)限 (用于 API 33 或作為回退) public const string ReadExternalStorage android.permission.READ_EXTERNAL_STORAGE; public const string WriteExternalStorage android.permission.WRITE_EXTERNAL_STORAGE; // Android 13 (API 33) 細(xì)粒度媒體權(quán)限 public const string ReadMediaImages android.permission.READ_MEDIA_IMAGES; public const string ReadMediaVideo android.permission.READ_MEDIA_VIDEO; public const string ReadMediaAudio android.permission.READ_MEDIA_AUDIO; // Android 13 (API 33) 通知權(quán)限 public const string PostNotifications android.permission.POST_NOTIFICATIONS; // 其他常用權(quán)限 public const string Camera android.permission.CAMERA; public const string RecordAudio android.permission.RECORD_AUDIO; public const string AccessFineLocation android.permission.ACCESS_FINE_LOCATION; }接下來(lái)是權(quán)限管理器的核心框架。我們使用單例模式確保全局只有一個(gè)權(quán)限管理器。// AndroidPermissionManager.cs using UnityEngine; using System; using System.Collections.Generic; #if UNITY_ANDROID using UnityEngine.Android; #endif public class AndroidPermissionManager : MonoBehaviour { public static AndroidPermissionManager Instance { get; private set; } // 定義一個(gè)委托用于權(quán)限請(qǐng)求結(jié)果的回調(diào) public delegate void PermissionCallback(bool granted); // 存儲(chǔ)正在進(jìn)行的權(quán)限請(qǐng)求的回調(diào) private Dictionarystring, PermissionCallback pendingCallbacks new Dictionarystring, PermissionCallback(); // 權(quán)限與其中文解釋的映射用于向用戶展示 private Dictionarystring, string permissionRationaleMap new Dictionarystring, string() { { AndroidPermissionConstants.ReadMediaImages, 需要訪問(wèn)您的相冊(cè)以便您選擇游戲頭像或上傳截圖。 }, { AndroidPermissionConstants.ReadMediaVideo, 需要訪問(wèn)您的視頻文件用于錄制和分享游戲精彩時(shí)刻。 }, { AndroidPermissionConstants.PostNotifications, 希望向您發(fā)送游戲更新、活動(dòng)提醒和好友消息以免您錯(cuò)過(guò)重要內(nèi)容。 }, { AndroidPermissionConstants.Camera, 需要使用攝像頭進(jìn)行AR游戲體驗(yàn)或掃描二維碼添加好友。 }, { AndroidPermissionConstants.RecordAudio, 需要麥克風(fēng)權(quán)限用于游戲內(nèi)語(yǔ)音聊天或語(yǔ)音指令。 }, { AndroidPermissionConstants.AccessFineLocation, 需要獲取您的位置信息用于基于位置的游戲玩法或附近玩家匹配。 } }; private void Awake() { if (Instance ! null Instance ! this) { Destroy(this.gameObject); return; } Instance this; DontDestroyOnLoad(this.gameObject); // 常駐場(chǎng)景方便全局調(diào)用 } }3.2 核心方法檢查、請(qǐng)求與處理回調(diào)管理器的核心是三個(gè)方法檢查權(quán)限狀態(tài)、發(fā)起權(quán)限請(qǐng)求、處理系統(tǒng)返回的結(jié)果。// 在 AndroidPermissionManager.cs 中繼續(xù)添加 public bool CheckPermission(string permission) { #if UNITY_ANDROID return Permission.HasUserAuthorizedPermission(permission); #else Debug.LogWarning($[PermissionManager] 非Android平臺(tái)默認(rèn)授予權(quán)限: {permission}); return true; // 在編輯器或其他平臺(tái)默認(rèn)返回true #endif } public void RequestPermission(string permission, PermissionCallback callback) { #if UNITY_ANDROID // 1. 先檢查是否已有權(quán)限 if (CheckPermission(permission)) { callback?.Invoke(true); return; } // 2. 檢查用戶是否之前選擇了“不再詢問(wèn)” if (ShouldShowRequestPermissionRationale(permission)) { // 用戶拒絕過(guò)但未勾選“不再詢問(wèn)”可以展示解釋性UI ShowRationaleDialog(permission, callback); } else { // 首次請(qǐng)求或用戶已選擇“不再詢問(wèn)”直接向系統(tǒng)發(fā)起請(qǐng)求 DoRequestPermission(permission, callback); } #else callback?.Invoke(true); // 非Android平臺(tái)直接模擬成功 #endif } // 處理系統(tǒng)權(quán)限請(qǐng)求結(jié)果這個(gè)函數(shù)需要由Android系統(tǒng)回調(diào) private void OnPermissionRequestResult(string permission, bool granted) { Debug.Log($[PermissionManager] 權(quán)限 {permission} 請(qǐng)求結(jié)果: {granted}); if (pendingCallbacks.TryGetValue(permission, out var callback)) { callback?.Invoke(granted); pendingCallbacks.Remove(permission); } } // 實(shí)際調(diào)用Unity API發(fā)起請(qǐng)求 private void DoRequestPermission(string permission, PermissionCallback callback) { #if UNITY_ANDROID pendingCallbacks[permission] callback; // 注意這里我們使用一個(gè)協(xié)程來(lái)等待并捕獲回調(diào)因?yàn)閁nity的Permission類回調(diào)方式比較原始。 // 更優(yōu)雅的方式是使用Android原生插件但為簡(jiǎn)化此處用Unity內(nèi)置方式演示。 StartCoroutine(RequestPermissionCoroutine(permission)); #endif } private System.Collections.IEnumerator RequestPermissionCoroutine(string permission) { var callbacks PermissionCallbacks.Instance; bool requestCompleted false; bool resultGranted false; callbacks.PermissionGranted (string perm) { if (perm permission) { resultGranted true; requestCompleted true; } }; callbacks.PermissionDenied (string perm) { if (perm permission) { requestCompleted true; } }; callbacks.PermissionDeniedAndDontAskAgain (string perm) { if (perm permission) { requestCompleted true; } }; Permission.RequestUserPermission(permission); // 等待請(qǐng)求完成簡(jiǎn)單輪詢實(shí)際項(xiàng)目可用更高級(jí)的異步等待 float timeout 5f; // 超時(shí)時(shí)間 float timer 0; while (!requestCompleted timer timeout) { timer Time.deltaTime; yield return null; } OnPermissionRequestResult(permission, resultGranted); }關(guān)鍵點(diǎn)解析ShouldShowRequestPermissionRationale這是一個(gè)關(guān)鍵方法。它返回true表示用戶之前拒絕過(guò)此權(quán)限但沒(méi)有勾選“不再詢問(wèn)”。這是你向用戶解釋權(quán)限用途的黃金窗口期。如果返回false要么是用戶從未被詢問(wèn)過(guò)要么是用戶已經(jīng)勾選了“不再詢問(wèn)”。對(duì)于后者你只能引導(dǎo)用戶去系統(tǒng)設(shè)置頁(yè)手動(dòng)開啟?；卣{(diào)處理Unity的Permission.RequestUserPermission是異步的但沒(méi)有提供方便的async/await或回調(diào)參數(shù)。上面的代碼通過(guò)PermissionCallbacks來(lái)監(jiān)聽結(jié)果并用協(xié)程等待。這是Unity API比較別扭的地方我們通過(guò)封裝來(lái)簡(jiǎn)化上層調(diào)用。3.3 實(shí)現(xiàn)解釋性對(duì)話框與引導(dǎo)至系統(tǒng)設(shè)置當(dāng)ShouldShowRequestPermissionRationale返回true時(shí)我們應(yīng)該彈出一個(gè)自定義對(duì)話框友好地解釋為什么需要這個(gè)權(quán)限從而提高用戶的授權(quán)率。// 在 AndroidPermissionManager.cs 中添加 private void ShowRationaleDialog(string permission, PermissionCallback callback) { // 這里應(yīng)該觸發(fā)你的UI系統(tǒng)彈出一個(gè)模態(tài)對(duì)話框。 // 例如使用UGUI創(chuàng)建一個(gè)簡(jiǎn)單的對(duì)話框Prefab。 // 以下為邏輯示例 string rationaleText GetRationaleText(permission); string dialogTitle 權(quán)限請(qǐng)求; // 假設(shè)你有一個(gè)UI管理器可以顯示對(duì)話框 UIManager.Instance.ShowConfirmDialog( dialogTitle, rationaleText, 去設(shè)置, 取消, () { // 用戶點(diǎn)擊“去設(shè)置”再次發(fā)起系統(tǒng)請(qǐng)求 DoRequestPermission(permission, callback); }, () { // 用戶點(diǎn)擊“取消”直接回調(diào)拒絕 callback?.Invoke(false); } ); } private string GetRationaleText(string permission) { if (permissionRationaleMap.TryGetValue(permission, out string rationale)) { return rationale; } return 此功能需要相關(guān)權(quán)限才能正常使用請(qǐng)授權(quán)。; }如果用戶已經(jīng)選擇了“不再詢問(wèn)”Permission.RequestUserPermission將不會(huì)彈出系統(tǒng)對(duì)話框。此時(shí)我們必須引導(dǎo)用戶手動(dòng)去系統(tǒng)設(shè)置頁(yè)面開啟。public void OpenAppSettings() { #if UNITY_ANDROID !UNITY_EDITOR try { using (var unityClass new AndroidJavaClass(com.unity3d.player.UnityPlayer)) using (var currentActivity unityClass.GetStaticAndroidJavaObject(currentActivity)) using (var intent new AndroidJavaObject(android.content.Intent)) { string packageName currentActivity.Callstring(getPackageName); using (var uri new AndroidJavaObject(android.net.Uri)) { // Android 8.0 (API 26) 之后跳轉(zhuǎn)到應(yīng)用信息頁(yè)面的Intent Action intent.CallAndroidJavaObject(setAction, android.settings.APPLICATION_DETAILS_SETTINGS); string uriString package: packageName; var uriObj uri.CallStaticAndroidJavaObject(parse, uriString); intent.CallAndroidJavaObject(setData, uriObj); intent.CallAndroidJavaObject(addCategory, android.intent.category.DEFAULT); intent.CallAndroidJavaObject(setFlags, 0x10000000); // FLAG_ACTIVITY_NEW_TASK currentActivity.Call(startActivity, intent); } } } catch (System.Exception e) { Debug.LogError($[PermissionManager] 打開系統(tǒng)設(shè)置失敗: {e.Message}); } #else Debug.Log([PermissionManager] 非Android運(yùn)行時(shí)無(wú)法打開系統(tǒng)設(shè)置。); #endif }3.4 針對(duì)Android 13的智能權(quán)限請(qǐng)求策略現(xiàn)在我們將所有部分組合起來(lái)實(shí)現(xiàn)一個(gè)智能的、兼容Android 13的權(quán)限請(qǐng)求方法。這個(gè)方法會(huì)自動(dòng)根據(jù)設(shè)備API等級(jí)選擇正確的權(quán)限字符串。// 在 AndroidPermissionManager.cs 中添加 public void RequestMediaPermission(PermissionCallback callback, MediaType mediaType) { string permissionToRequest; #if UNITY_ANDROID // 獲取當(dāng)前Android API級(jí)別 int apiLevel GetAndroidAPILevel(); if (apiLevel 33) // Android 13 (T) 及以上 { switch (mediaType) { case MediaType.Image: permissionToRequest AndroidPermissionConstants.ReadMediaImages; break; case MediaType.Video: permissionToRequest AndroidPermissionConstants.ReadMediaVideo; break; case MediaType.Audio: permissionToRequest AndroidPermissionConstants.ReadMediaAudio; break; default: permissionToRequest AndroidPermissionConstants.ReadExternalStorage; // 回退 break; } } else { // Android 13 以下使用傳統(tǒng)的存儲(chǔ)權(quán)限 permissionToRequest AndroidPermissionConstants.ReadExternalStorage; // 注意在Android 10-12上即使有READ_EXTERNAL_STORAGE訪問(wèn)媒體文件也受作用域存儲(chǔ)限制。 // 實(shí)際開發(fā)中應(yīng)使用Unity的NativeGallery等插件或FilePicker來(lái)安全訪問(wèn)。 } RequestPermission(permissionToRequest, callback); #else callback?.Invoke(true); #endif } public void RequestNotificationPermission(PermissionCallback callback) { #if UNITY_ANDROID int apiLevel GetAndroidAPILevel(); if (apiLevel 33) { RequestPermission(AndroidPermissionConstants.PostNotifications, callback); } else { // Android 13以下通知權(quán)限非運(yùn)行時(shí)權(quán)限默認(rèn)擁有需在Manifest聲明 callback?.Invoke(true); } #else callback?.Invoke(true); #endif } private int GetAndroidAPILevel() { #if UNITY_ANDROID !UNITY_EDITOR using (var version new AndroidJavaClass(android.os.Build$VERSION)) { return version.GetStaticint(SDK_INT); } #else return 0; // 編輯器環(huán)境 #endif } public enum MediaType { Image, Video, Audio }4. 在游戲業(yè)務(wù)邏輯中集成權(quán)限管理有了強(qiáng)大的AndroidPermissionManager我們?cè)跇I(yè)務(wù)層調(diào)用就變得非常清晰和安全。以下是一些典型場(chǎng)景的示例。4.1 場(chǎng)景一用戶上傳頭像假設(shè)有一個(gè)按鈕點(diǎn)擊后允許用戶從相冊(cè)選擇頭像。// AvatarUploadHandler.cs using UnityEngine; using UnityEngine.UI; public class AvatarUploadHandler : MonoBehaviour { public Button selectAvatarButton; void Start() { selectAvatarButton.onClick.AddListener(OnSelectAvatarClicked); } private void OnSelectAvatarClicked() { // 1. 請(qǐng)求讀取圖片的權(quán)限 AndroidPermissionManager.Instance.RequestMediaPermission(OnImagePermissionResult, MediaType.Image); } private void OnImagePermissionResult(bool granted) { if (granted) { // 權(quán)限已獲取打開圖片選擇器 // 這里需要接入一個(gè)原生圖片選擇器插件例如 NativeGallery // NativeGallery.GetImageFromGallery(...); Debug.Log(權(quán)限獲取成功開始選擇圖片...); // TODO: 調(diào)用具體的圖片選擇邏輯 } else { // 權(quán)限被拒絕 Debug.LogWarning(讀取相冊(cè)權(quán)限被拒絕無(wú)法選擇頭像。); // 可以在這里顯示一個(gè)提示告知用戶功能不可用并提供一個(gè)按鈕引導(dǎo)至設(shè)置。 ShowPermissionDeniedTip(相冊(cè)訪問(wèn)); } } private void ShowPermissionDeniedTip(string featureName) { UIManager.Instance.ShowConfirmDialog( 權(quán)限不足, $您拒絕了{(lán)featureName}權(quán)限相關(guān)功能將無(wú)法使用。您可以去系統(tǒng)設(shè)置中手動(dòng)開啟。, 去設(shè)置, 稍后再說(shuō), () { AndroidPermissionManager.Instance.OpenAppSettings(); }, null ); } }4.2 場(chǎng)景二請(qǐng)求通知權(quán)限不要在游戲啟動(dòng)時(shí)請(qǐng)求通知權(quán)限。更好的時(shí)機(jī)是在用戶完成新手引導(dǎo)、進(jìn)入主城后彈出一個(gè)溫馨的提示。// NotificationPermissionRequester.cs using UnityEngine; public class NotificationPermissionRequester : MonoBehaviour { [SerializeField] private string triggerPrefKey HasAskedNotificationPermission; // 用于記錄是否已詢問(wèn)過(guò) void Start() { // 例如在玩家首次進(jìn)入游戲大廳時(shí)觸發(fā) if (!PlayerPrefs.HasKey(triggerPrefKey)) { // 可以延遲幾秒避免干擾初始體驗(yàn) Invoke(nameof(PromptNotificationPermission), 5f); } } private void PromptNotificationPermission() { // 先檢查是否已有權(quán)限用戶可能在其他地方已經(jīng)授予 if (AndroidPermissionManager.Instance.CheckPermission(AndroidPermissionConstants.PostNotifications)) { return; } // 展示一個(gè)自定義的、吸引人的解釋界面而不是直接彈系統(tǒng)窗 UIManager.Instance.ShowNotificationPermissionDialog( 開啟游戲通知, 及時(shí)接收好友消息、體力恢復(fù)提醒和限時(shí)活動(dòng)通知讓你永不掉隊(duì), 立即開啟, 暫時(shí)不要, () { // 用戶點(diǎn)擊“立即開啟”發(fā)起系統(tǒng)權(quán)限請(qǐng)求 AndroidPermissionManager.Instance.RequestNotificationPermission(OnNotificationPermissionResult); PlayerPrefs.SetInt(triggerPrefKey, 1); }, () { // 用戶點(diǎn)擊“暫時(shí)不要”記錄并關(guān)閉 PlayerPrefs.SetInt(triggerPrefKey, 1); } ); } private void OnNotificationPermissionResult(bool granted) { if (granted) { Debug.Log(通知權(quán)限已開啟可以開始安排本地通知了。); // TODO: 初始化游戲內(nèi)通知調(diào)度系統(tǒng) } else { Debug.Log(用戶拒絕了通知權(quán)限。); } } }4.3 場(chǎng)景三使用相機(jī)進(jìn)行AR掃描// ARScanner.cs using UnityEngine; public class ARScanner : MonoBehaviour { public void StartScan() { AndroidPermissionManager.Instance.RequestPermission( AndroidPermissionConstants.Camera, (granted) { if (granted) { InitializeARCamera(); } else { Debug.LogError(相機(jī)權(quán)限被拒絕AR功能無(wú)法使用。); // 提示用戶并可能提供一個(gè)“重試”或“去設(shè)置”的按鈕 } } ); } private void InitializeARCamera() { // 初始化AR Foundation或其他AR SDK的代碼 Debug.Log(相機(jī)權(quán)限OK啟動(dòng)AR掃描...); } }5. 清單文件AndroidManifest.xml的關(guān)鍵配置代碼寫好了但AndroidManifest.xml的配置同樣重要否則權(quán)限請(qǐng)求可能根本不會(huì)觸發(fā)。你需要通過(guò)Unity的Plugins/Android文件夾來(lái)定制清單文件。創(chuàng)建或修改清單文件在項(xiàng)目的Assets/Plugins/Android目錄下創(chuàng)建或找到AndroidManifest.xml文件。如果沒(méi)有可以從Unity安裝目錄下的Editor/Data/PlaybackEngines/AndroidPlayer/Apk中復(fù)制一個(gè)模板。聲明權(quán)限在manifest標(biāo)簽內(nèi)添加你需要的所有權(quán)限。注意即使Android 13使用了新權(quán)限為了向后兼容有時(shí)也需要聲明舊權(quán)限。?xml version1.0 encodingutf-8? manifest xmlns:androidhttp://schemas.android.com/apk/res/android packagecom.yourcompany.yourgame android:installLocationpreferExternal !-- 傳統(tǒng)存儲(chǔ)權(quán)限 (用于 API 33 兼容) -- uses-permission android:nameandroid.permission.READ_EXTERNAL_STORAGE android:maxSdkVersion32 / !-- 注意WRITE_EXTERNAL_STORAGE 在 Android 10 對(duì)媒體文件作用有限通常不需要了 -- !-- Android 13 (API 33) 細(xì)粒度媒體權(quán)限 -- uses-permission android:nameandroid.permission.READ_MEDIA_IMAGES / uses-permission android:nameandroid.permission.READ_MEDIA_VIDEO / uses-permission android:nameandroid.permission.READ_MEDIA_AUDIO / !-- Android 13 (API 33) 通知權(quán)限 -- uses-permission android:nameandroid.permission.POST_NOTIFICATIONS / !-- 其他常用權(quán)限 -- uses-permission android:nameandroid.permission.CAMERA / uses-permission android:nameandroid.permission.RECORD_AUDIO / uses-permission android:nameandroid.permission.ACCESS_FINE_LOCATION / !-- 如果你的游戲需要保持屏幕常亮 -- uses-permission android:nameandroid.permission.WAKE_LOCK / application android:labelstring/app_name android:iconmipmap/app_icon android:themestyle/UnityThemeSelector android:usesCleartextTraffictrue !-- 其他Activity配置特別是UnityPlayerActivity -- activity android:namecom.unity3d.player.UnityPlayerActivity android:configChangesfontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen android:launchModesingleTask android:resizeableActivitytrue intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter meta-data android:nameunityplayer.UnityActivity android:valuetrue / /activity /application /manifest關(guān)鍵說(shuō)明android:maxSdkVersion32這個(gè)屬性用于READ_EXTERNAL_STORAGE表示此權(quán)限只對(duì)API 32Android 12L及以下的設(shè)備生效。在API 33的設(shè)備上系統(tǒng)會(huì)忽略此權(quán)限聲明。這是Google推薦的兼容性寫法。務(wù)必設(shè)置正確的Target API在Unity的Player Settings Android Other Settings中將Target API Level設(shè)置為最新如Android 13.0 (API Level 33)。這不僅是商店的要求也是確保新權(quán)限規(guī)則生效的前提。6. 測(cè)試、調(diào)試與常見問(wèn)題排查權(quán)限問(wèn)題在測(cè)試階段尤其棘手因?yàn)椴煌珹ndroid版本、不同廠商設(shè)備的行為可能有差異。以下是我總結(jié)的一套測(cè)試方法和常見問(wèn)題清單。6.1 在Unity編輯器和真機(jī)上的測(cè)試策略編輯器模擬我們的AndroidPermissionManager在非Android平臺(tái)會(huì)直接返回true方便在編輯器中跑通邏輯流程。但真正的回調(diào)行為和系統(tǒng)對(duì)話框無(wú)法模擬。ADB命令快速測(cè)試這是最高效的測(cè)試方法。在電腦上連接Android設(shè)備后使用命令行adb shell pm list permissions -d -g查看危險(xiǎn)權(quán)限組。adb shell pm grant package_name permission授予權(quán)限。例如adb shell pm grant com.yourcompany.yourgame android.permission.CAMERAadb shell pm revoke package_name permission撤銷權(quán)限。adb shell am start -a android.settings.APPLICATION_DETAILS_SETTINGS -d package:package_name直接跳轉(zhuǎn)到你應(yīng)用的系統(tǒng)設(shè)置頁(yè)。測(cè)試用例覆蓋首次安裝所有權(quán)限都應(yīng)該是未授予狀態(tài)。允許權(quán)限點(diǎn)擊請(qǐng)求選擇“允許”。檢查功能是否正常。拒絕權(quán)限點(diǎn)擊請(qǐng)求選擇“拒絕”。檢查你的解釋性對(duì)話框是否彈出再次請(qǐng)求是否有效。拒絕并不再詢問(wèn)在系統(tǒng)對(duì)話框勾選“不再詢問(wèn)”后拒絕。檢查你的邏輯是否會(huì)引導(dǎo)用戶去系統(tǒng)設(shè)置。從系統(tǒng)設(shè)置中開啟/關(guān)閉權(quán)限在應(yīng)用運(yùn)行時(shí)去系統(tǒng)設(shè)置里開關(guān)權(quán)限返回應(yīng)用后檢查狀態(tài)是否被正確檢測(cè)到可能需要監(jiān)聽OnApplicationPause/OnApplicationFocus事件來(lái)重新檢查。6.2 常見問(wèn)題與解決方案速查表問(wèn)題現(xiàn)象可能原因解決方案在Android 13設(shè)備上請(qǐng)求READ_EXTERNAL_STORAGE無(wú)效無(wú)法訪問(wèn)相冊(cè)。Target API Level 33系統(tǒng)已啟用新權(quán)限模型。READ_EXTERNAL_STORAGE對(duì)媒體文件無(wú)效。使用RequestMediaPermission方法它會(huì)根據(jù)API等級(jí)自動(dòng)請(qǐng)求READ_MEDIA_IMAGES等權(quán)限。確保清單文件已聲明新權(quán)限。用戶點(diǎn)擊“拒絕并不再詢問(wèn)”后再次調(diào)用RequestUserPermission系統(tǒng)對(duì)話框不彈出。這是Android系統(tǒng)的預(yù)期行為。當(dāng)用戶勾選“不再詢問(wèn)”后該權(quán)限的請(qǐng)求通道被系統(tǒng)屏蔽。調(diào)用ShouldShowRequestPermissionRationale(permission)如果返回false且CheckPermission也返回false則應(yīng)顯示自定義界面引導(dǎo)用戶點(diǎn)擊按鈕通過(guò)OpenAppSettings()跳轉(zhuǎn)到系統(tǒng)設(shè)置頁(yè)。在Unity編輯器中運(yùn)行正常打包到Android后權(quán)限相關(guān)代碼不執(zhí)行。條件編譯指令#if UNITY_ANDROID和#if !UNITY_EDITOR使用有誤或者AndroidManifest.xml未正確合并。檢查所有平臺(tái)相關(guān)代碼是否被正確包裹。在Player Settings中查看最終的合并后的Manifest文件構(gòu)建后可以在Temp目錄找到確認(rèn)權(quán)限聲明已存在。通知權(quán)限請(qǐng)求了但用戶收不到通知。1. 未在AndroidManifest.xml中聲明POST_NOTIFICATIONS。2. 在Android 13以下設(shè)備上沒(méi)有正確配置通知渠道Notification Channel。3. 發(fā)送通知的代碼邏輯有誤。1. 確認(rèn)清單文件已聲明該權(quán)限。2. 對(duì)于API 26的設(shè)備創(chuàng)建通知時(shí)必須指定有效的通知渠道ID。確保你的通知發(fā)送代碼如使用Unity.Notifications包正確創(chuàng)建了渠道。3. 檢查通知的標(biāo)題、內(nèi)容、圖標(biāo)等是否有效。權(quán)限回調(diào)OnPermissionRequestResult沒(méi)有被調(diào)用。PermissionCallbacks的事件訂閱可能因?yàn)閷?duì)象生命周期問(wèn)題被意外取消或者協(xié)程超時(shí)。確保PermissionCallbacks實(shí)例在場(chǎng)景中持久存在。在我們的封裝中AndroidPermissionManager是DontDestroyOnLoad的?？梢赃m當(dāng)增加協(xié)程超時(shí)時(shí)間并添加更詳細(xì)的日志。一個(gè)更穩(wěn)健的方法是使用Android原生插件如UnityAndroidPermissions來(lái)獲得更可靠的回調(diào)。不同手機(jī)廠商小米、華為、OPPO等權(quán)限彈窗樣式或行為不一致。這是Android碎片化的典型問(wèn)題。廠商可能會(huì)修改權(quán)限對(duì)話框的UI甚至增加額外的“后臺(tái)彈出界面”等權(quán)限。進(jìn)行充分的真機(jī)兼容性測(cè)試。對(duì)于廠商特有的權(quán)限如自啟動(dòng)、電池優(yōu)化忽略需要在你的應(yīng)用內(nèi)增加額外的引導(dǎo)說(shuō)明告訴用戶如何手動(dòng)設(shè)置。這超出了標(biāo)準(zhǔn)權(quán)限API的范圍屬于“中國(guó)特色”的適配。6.3 一個(gè)實(shí)用的調(diào)試工具類在開發(fā)過(guò)程中可以創(chuàng)建一個(gè)簡(jiǎn)單的調(diào)試UI實(shí)時(shí)顯示所有關(guān)鍵權(quán)限的狀態(tài)。// PermissionDebugUI.cs using UnityEngine; using UnityEngine.UI; #if UNITY_ANDROID using UnityEngine.Android; #endif public class PermissionDebugUI : MonoBehaviour { public Text debugText; void OnGUI() { if (debugText ! null) { string status 權(quán)限狀態(tài) \n; #if UNITY_ANDROID status $Camera: {Permission.HasUserAuthorizedPermission(Permission.Camera)}\n; status $Microphone: {Permission.HasUserAuthorizedPermission(Permission.Microphone)}\n; // 檢查Android 13權(quán)限需要用到我們定義的常量 if (GetAndroidAPILevel() 33) { status $ReadMediaImages: {Permission.HasUserAuthorizedPermission(AndroidPermissionConstants.ReadMediaImages)}\n; status $PostNotifications: {Permission.HasUserAuthorizedPermission(AndroidPermissionConstants.PostNotifications)}\n; } else { status $ExternalStorage: {Permission.HasUserAuthorizedPermission(Permission.ExternalStorageRead)}\n; } #endif debugText.text status; } // 在屏幕上畫幾個(gè)測(cè)試按鈕 if (GUI.Button(new Rect(10, 100, 200, 60), 請(qǐng)求相機(jī)權(quán)限)) { AndroidPermissionManager.Instance.RequestPermission(AndroidPermissionConstants.Camera, (granted) { Debug.Log($Camera: {granted}); }); } if (GUI.Button(new Rect(10, 170, 200, 60), 請(qǐng)求圖片權(quán)限)) { AndroidPermissionManager.Instance.RequestMediaPermission((granted) { Debug.Log($Image Permission: {granted}); }, MediaType.Image); } if (GUI.Button(new Rect(10, 240, 200, 60), 打開應(yīng)用設(shè)置)) { AndroidPermissionManager.Instance.OpenAppSettings(); } } private int GetAndroidAPILevel() { // ... 同前文 GetAndroidAPILevel 方法 return 0; } }踩過(guò)幾次坑之后我最大的體會(huì)是權(quán)限適配不是一次性任務(wù)而是一個(gè)持續(xù)的過(guò)程。每次Google發(fā)布新的Android版本都需要重新審視你的權(quán)限邏輯。將權(quán)限管理模塊化、服務(wù)化是應(yīng)對(duì)這種變化的最佳策略。本文提供的AndroidPermissionManager只是一個(gè)起點(diǎn)你可以根據(jù)自己項(xiàng)目的UI框架、日志系統(tǒng)和異常處理機(jī)制對(duì)其進(jìn)行增強(qiáng)。比如將權(quán)限請(qǐng)求與游戲內(nèi)的任務(wù)系統(tǒng)結(jié)合或者與數(shù)據(jù)分析平臺(tái)打通記錄用戶拒絕權(quán)限的比率和場(chǎng)景從而持續(xù)優(yōu)化你的權(quán)限請(qǐng)求策略最終的目標(biāo)是讓權(quán)限請(qǐng)求成為流暢用戶體驗(yàn)的一部分而不是令人反感的阻礙。