Unity与Android权限设置

  • Android Permission:Android权限
  • Unity的Android权限
  • 运行时权限系统
  • 手动修改Unity AndroidManifest的方法
  • AndroidManifest.xml权限设置表格
  • Android 13的权限变更
  • 适配点:
  • 新特性:
  • 参考链接


Android Permission:Android权限

权限是一种限制,用于限制对部分代码或设备上数据的访问。施加限制是为了保护可能被误用以致破坏或损害用户体验的关键数据和代码。每种权限均由一个唯一的标签标识。标签通常指示受限制的操作。
如果应用需要访问受权限保护的功能,则必须在清单中使用 元素声明应用需要该权限。将应用安装到设备上之后,安装程序会通过检查签署应用证书的颁发机构并(在某些情况下)询问用户,确定是否授予请求的权限。如果授予权限,则应用能够使用受保护的功能。否则,其访问这些功能的尝试将会失败,并且不会向用户发送任何通知。
参考链接:https://developer.android.com/guide/topics/manifest/manifest-intro#perms

Unity的Android权限

Android的权限配置于AndroidManifest.xml中
Unity会自动生成一些权限(Unity生成一个AndroidManifest.xml),然后找到插件(AAR和Android Libraries)的所有Android Manifest。合并到unity生成的xml中。这些都是Unity自动完成的。即使你指定了一份AndroidManifest.xml,Unity仍然会修改或加入一些Unity工程中所需的权限。如要完全修改可以导出Android工程进行修改,生成APK。
Unity根据您的应用程序从脚本调用的设置和Unity API,自动添加必要的权限到清单。
例如:

  • 网络类添加INTERNET权限(例如在player settingInternet Access选为require,这时即使你没有网络访问,unity仍会添加Internet权限)。
  • 使用振动(如Handheld.Vibrate)增加VIBRATE
  • 判断网络状态InternetReachability增加ACCESS_NETWORK_STATE
  • 位置API(如LocationService)会添加ACCESS_FINE_LOCATION
  • WebCamTexture API添加CAMERA权限。
  • 启用麦克风增加RECORD_AUDIO
  • PlayerSetting中WriteAccess设置为External(SDCard),会添加相应权限。

运行时权限系统

APK在Android6.0设备上运行( Android API大于等于23),则应用程序将使用Android运行时权限系统
Android运行时权限系统要求应用程序在运行时授予权限,而不是首次安装时就获取权限。当应用程序运行时,应用程序用户通常可以授予或拒绝每个权限(例如,在拍摄照片之前请求摄像机许可)。这允许应用程序在没有权限的情况下运行有限的功能。
Unity不支持运行时权限系统,所以您的应用程序提示用户允许Android在启动时称为“危险”权限。
提示用户允许危险的权限是确保在缺少权限时不会导致崩溃的唯一方法。但是,如果你不想让程序运行开始就弹出这些权限的窗口,可以在AndroidManifest中添加。

手动修改Unity AndroidManifest的方法

要使用Unity之外创建的Android清单,请将自定义的Android Manifest文件导入到以下位置:Assets / Plugins / Android / AndroidManifest.xml。这将覆盖默认的Unity创建的清单
在这种情况下,Android Libraries的清单随后会被合并到这份清单中,并且所生成的清单仍然被Unity调整,以确保配置正确。要完全控制清单,包括权限,您需要导出项目并修改Android Studio中的最终清单。

AndroidManifest.xml权限设置表格

名称

权限,描述

访问登记属性

android.permission.ACCESS_CHECKIN_PROPERTIES ,读取或写入登记check-in数据库属性表的权限

获取错略位置

android.permission.ACCESS_COARSE_LOCATION,通过WiFi或移动基站的方式获取用户错略的经纬度信息,定位精度大概误差在30~1500米

获取精确位置

android.permission.ACCESS_FINE_LOCATION,通过GPS芯片接收卫星的定位信息,定位精度达10米以内

访问定位额外命令

android.permission.ACCESS_LOCATION_EXTRA_COMMANDS,允许程序访问额外的定位提供者指令

获取模拟定位信息

android.permission.ACCESS_MOCK_LOCATION,获取模拟定位信息,一般用于帮助开发者调试应用

获取网络状态

android.permission.ACCESS_NETWORK_STATE,获取网络信息状态,如当前的网络连接是否有效

访问Surface Flinger

android.permission.ACCESS_SURFACE_FLINGER,Android平台上底层的图形显示支持,一般用于游戏或照相机预览界面和底层模式的屏幕截图

获取WiFi状态

android.permission.ACCESS_WIFI_STATE,获取当前WiFi接入的状态以及WLAN热点的信息

账户管理

android.permission.ACCOUNT_MANAGER,获取账户验证信息,主要为GMail账户信息,只有系统级进程才能访问的权限

验证账户

android.permission.AUTHENTICATE_ACCOUNTS,允许一个程序通过账户验证方式访问账户管理ACCOUNT_MANAGER相关信息

电量统计

android.permission.BATTERY_STATS,获取电池电量统计信息

绑定小插件

android.permission.BIND_APPWIDGET,允许一个程序告诉appWidget服务需要访问小插件的数据库,只有非常少的应用才用到此权限

绑定设备管理

android.permission.BIND_DEVICE_ADMIN,请求系统管理员接收者receiver,只有系统才能使用

绑定输入法

android.permission.BIND_INPUT_METHOD ,请求InputMethodService服务,只有系统才能使用

绑定RemoteView

android.permission.BIND_REMOTEVIEWS,必须通过RemoteViewsService服务来请求,只有系统才能用

绑定壁纸

android.permission.BIND_WALLPAPER,必须通过WallpaperService服务来请求,只有系统才能用

使用蓝牙

android.permission.BLUETOOTH,允许程序连接配对过的蓝牙设备

蓝牙管理

android.permission.BLUETOOTH_ADMIN,允许程序进行发现和配对新的蓝牙设备

变成砖头

android.permission.BRICK,能够禁用手机,非常危险,顾名思义就是让手机变成砖头

应用删除时广播

android.permission.BROADCAST_PACKAGE_REMOVED,当一个应用在删除时触发一个广播

收到短信时广播

android.permission.BROADCAST_SMS,当收到短信时触发一个广播

连续广播

android.permission.BROADCAST_STICKY,允许一个程序收到广播后快速收到下一个广播

WAP PUSH广播

android.permission.BROADCAST_WAP_PUSH,WAP PUSH服务收到后触发一个广播

拨打电话

android.permission.CALL_PHONE,允许程序从非系统拨号器里输入电话号码

通话权限

android.permission.CALL_PRIVILEGED,允许程序拨打电话,替换系统的拨号器界面

拍照权限

android.permission.CAMERA,允许访问摄像头进行拍照

改变组件状态

android.permission.CHANGE_COMPONENT_ENABLED_STATE,改变组件是否启用状态

改变配置

android.permission.CHANGE_CONFIGURATION,允许当前应用改变配置,如定位

改变网络状态

android.permission.CHANGE_NETWORK_STATE,改变网络状态如是否能联网

改变WiFi多播状态

android.permission.CHANGE_WIFI_MULTICAST_STATE,改变WiFi多播状态

改变WiFi状态

android.permission.CHANGE_WIFI_STATE,改变WiFi状态

清除应用缓存

android.permission.CLEAR_APP_CACHE,清除应用缓存

清除用户数据

android.permission.CLEAR_APP_USER_DATA,清除应用的用户数据

底层访问权限

android.permission.CWJ_GROUP,允许CWJ账户组访问底层信息

手机优化大师扩展权限

android.permission.CELL_PHONE_MASTER_EX,手机优化大师扩展权限

控制定位更新

android.permission.CONTROL_LOCATION_UPDATES,允许获得移动网络定位信息改变

删除缓存文件

android.permission.DELETE_CACHE_FILES,允许应用删除缓存文件

删除应用

android.permission.DELETE_PACKAGES,允许程序删除应用

电源管理

android.permission.DEVICE_POWER,允许访问底层电源管理

应用诊断

android.permission.DIAGNOSTIC,允许程序到RW到诊断资源

禁用键盘锁

android.permission.DISABLE_KEYGUARD,允许程序禁用键盘锁

转存系统信息

android.permission.DUMP,允许程序获取系统dump信息从系统服务

状态栏控制

android.permission.EXPAND_STATUS_BAR,允许程序扩展或收缩状态栏

工厂测试模式

android.permission.FACTORY_TEST,允许程序运行工厂测试模式

使用闪光灯

android.permission.FLASHLIGHT,允许访问闪光灯

强制后退

android.permission.FORCE_BACK,允许程序强制使用back后退按键,无论Activity是否在顶层

访问账户Gmail列表

android.permission.GET_ACCOUNTS,访问GMail账户列表

获取应用大小

android.permission.GET_PACKAGE_SIZE,获取应用的文件大小

获取任务信息

android.permission.GET_TASKS,允许程序获取当前或最近运行的应用

允许全局搜索

android.permission.GLOBAL_SEARCH,允许程序使用全局搜索功能

硬件测试

android.permission.HARDWARE_TEST,访问硬件辅助设备,用于硬件测试

注射事件

android.permission.INJECT_EVENTS,允许访问本程序的底层事件,获取按键、轨迹球的事件流

安装定位提供

android.permission.INSTALL_LOCATION_PROVIDER,安装定位提供

安装应用程序

android.permission.INSTALL_PACKAGES,允许程序安装应用

内部系统窗口

android.permission.INTERNAL_SYSTEM_WINDOW,允许程序打开内部窗口,不对第三方应用程序开放此权限

访问网络

android.permission.INTERNET,访问网络连接,可能产生GPRS流量

结束后台进程

android.permission.KILL_BACKGROUND_PROCESSES,允许程序调用killBackgroundProcesses(String).方法结束后台进程

管理账户

android.permission.MANAGE_ACCOUNTS,允许程序管理AccountManager中的账户列表

管理程序引用

android.permission.MANAGE_APP_TOKENS,管理创建、摧毁、Z轴顺序,仅用于系统

高级权限

android.permission.MTWEAK_USER,允许mTweak用户访问高级系统权限

社区权限

android.permission.MTWEAK_FORUM,允许使用mTweak社区权限

软格式化

android.permission.MASTER_CLEAR,允许程序执行软格式化,删除系统配置信息

修改声音设置

android.permission.MODIFY_AUDIO_SETTINGS,修改声音设置信息

修改电话状态

android.permission.MODIFY_PHONE_STATE,修改电话状态,如飞行模式,但不包含替换系统拨号器界面

格式化文件系统

android.permission.MOUNT_FORMAT_FILESYSTEMS,格式化可移动文件系统,比如格式化清空SD卡

挂载文件系统

android.permission.MOUNT_UNMOUNT_FILESYSTEMS,挂载、反挂载外部文件系统

允许NFC通讯

android.permission.NFC,允许程序执行NFC近距离通讯操作,用于移动支持

永久Activity

android.permission.PERSISTENT_ACTIVITY,创建一个永久的Activity,该功能标记为将来将被移除

处理拨出电话

android.permission.PROCESS_OUTGOING_CALLS,允许程序监视,修改或放弃播出电话

读取日程提醒

android.permission.READ_CALENDAR,允许程序读取用户的日程信息

读取联系人

android.permission.READ_CONTACTS,允许应用访问联系人通讯录信息

屏幕截图

android.permission.READ_FRAME_BUFFER,读取帧缓存用于屏幕截图

读取收藏夹和历史记录

com.android.browser.permission.READ_HISTORY_BOOKMARKS,读取浏览器收藏夹和历史记录

读取输入状态

android.permission.READ_INPUT_STATE,读取当前键的输入状态,仅用于系统

读取系统日志

android.permission.READ_LOGS,读取系统底层日志

读取电话状态

android.permission.READ_PHONE_STATE,访问电话状态

读取短信内容

android.permission.READ_SMS,读取短信内容

读取同步设置

android.permission.READ_SYNC_SETTINGS,读取同步设置,读取Google在线同步设置

读取同步状态

android.permission.READ_SYNC_STATS,读取同步状态,获得Google在线同步状态

重启设备

android.permission.REBOOT,允许程序重新启动设备

开机自动允许

android.permission.RECEIVE_BOOT_COMPLETED,允许程序开机自动运行

接收彩信

android.permission.RECEIVE_MMS,接收彩信

接收短信

android.permission.RECEIVE_SMS,接收短信

接收Wap Push

android.permission.RECEIVE_WAP_PUSH,接收WAP PUSH信息

录音

android.permission.RECORD_AUDIO,录制声音通过手机或耳机的麦克

排序系统任务

android.permission.REORDER_TASKS,重新排序系统Z轴运行中的任务

结束系统任务

android.permission.RESTART_PACKAGES,结束任务通过restartPackage(String)方法,该方式将在外来放弃

发送短信

android.permission.SEND_SMS,发送短信

设置Activity观察其

android.permission.SET_ACTIVITY_WATCHER,设置Activity观察器一般用于monkey测试

设置闹铃提醒

com.android.alarm.permission.SET_ALARM,设置闹铃提醒

设置总是退出

android.permission.SET_ALWAYS_FINISH,设置程序在后台是否总是退出

设置动画缩放

android.permission.SET_ANIMATION_SCALE,设置全局动画缩放

设置调试程序

android.permission.SET_DEBUG_APP,设置调试程序,一般用于开发

设置屏幕方向

android.permission.SET_ORIENTATION,设置屏幕方向为横屏或标准方式显示,不用于普通应用

设置应用参数

android.permission.SET_PREFERRED_APPLICATIONS,设置应用的参数,已不再工作具体查看addPackageToPreferred(String) 介绍

设置进程限制

android.permission.SET_PROCESS_LIMIT,允许程序设置最大的进程数量的限制

设置系统时间

android.permission.SET_TIME,设置系统时间

设置系统时区

android.permission.SET_TIME_ZONE,设置系统时区

设置桌面壁纸

android.permission.SET_WALLPAPER,设置桌面壁纸

设置壁纸建议

android.permission.SET_WALLPAPER_HINTS,设置壁纸建议

发送永久进程信号

android.permission.SIGNAL_PERSISTENT_PROCESSES,发送一个永久的进程信号

状态栏控制

android.permission.STATUS_BAR,允许程序打开、关闭、禁用状态栏

访问订阅内容

android.permission.SUBSCRIBED_FEEDS_READ,访问订阅信息的数据库

写入订阅内容

android.permission.SUBSCRIBED_FEEDS_WRITE,写入或修改订阅内容的数据库

显示系统窗口

android.permission.SYSTEM_ALERT_WINDOW,显示系统窗口

更新设备状态

android.permission.UPDATE_DEVICE_STATS,更新设备状态

使用证书

android.permission.USE_CREDENTIALS,允许程序请求验证从AccountManager

使用SIP视频

android.permission.USE_SIP,允许程序使用SIP视频服务

使用振动

android.permission.VIBRATE,允许振动

唤醒锁定

android.permission.WAKE_LOCK,允许程序在手机屏幕关闭后后台进程仍然运行

写入GPRS接入点设置

android.permission.WRITE_APN_SETTINGS,写入网络GPRS接入点设置

写入日程提醒

android.permission.WRITE_CALENDAR,写入日程,但不可读取

写入联系人

android.permission.WRITE_CONTACTS,写入联系人,但不可读取

写入外部存储

android.permission.WRITE_EXTERNAL_STORAGE,允许程序写入外部存储,如SD卡上写文件

写入Google地图数据

android.permission.WRITE_GSERVICES,允许程序写入Google Map服务数据

写入收藏夹和历史记录

com.android.browser.permission.WRITE_HISTORY_BOOKMARKS,写入浏览器历史记录或收藏夹,但不可读取

读写系统敏感设置

android.permission.WRITE_SECURE_SETTINGS,允许程序读写系统安全敏感的设置项

读写系统设置

android.permission.WRITE_SETTINGS,允许读写系统设置项

编写短信

android.permission.WRITE_SMS,允许编写短信

写入在线同步设置

android.permission.WRITE_SYNC_SETTINGS,写入Google在线同步设置

Android 13的权限变更

围绕Android13适配点与Android13新特性两个方面进行简易说明。
详细解析请看: Android 13 适配指南。

适配点:
  • 细分媒体权限:(若设置 targetSdk>=33 则此项必需适配!)
    READ_EXTERNAL_STORAGE细分为IAMGESVIDEOAUDIO权限
  • WebView调整:(若设置 targetSdk>=33 则此项必需适配!)
    废弃setAppCacheEnabledsetForceDark方法;
  • 静态广播注册:(若设置 targetSdk>=33 则此项必需适配!)
    注册静态广播时,需设置对其他应用的可见性
  • 通知权限:(若设置 targetSdk>=33 则此项必需适配!)
    新增运行时通知权限:POST_NOTIFICATIONS
  • Wi-Fi:(若设置 targetSdk>=33 则此项必需适配!)
    新增NEARBY_WIFI_DEVICES运行时权限
  • 身体传感器后台权限:(若设置 targetSdk>=33 则此项必需适配!)
    新增BODY_SENSORS_BACKGROUND运行时权限
  • 剪切板内容隐藏:(根据业务需求,选择性适配!)
    新增内容隐藏API
  • 非SDK接口的限制:(若设置 targetSdk>=33 则此项必需适配!)
新特性:
  • 前台服务管理器:
    系统新增前台服务管理器(系统新特性无需适配!)

参考链接

  1. Android 13 运行时权限变更一览
  2. Android 13 功能和变更列表