安卓权限和调用时机说明

网络与接口

权限相关权限 权限调用时机 权限用途
INTERNET(必选) 进行登录、首页加载、发帖、上传和消息收发时 允许应用发起网络请求并完成数据交互,是各类联网能力的基础权限。
ACCESS_NETWORK_STATE(必选) 初始化及网络状态判断时 检测当前网络是否可用,帮助应用区分无网、弱网和可用网络状态。
ACCESS_WIFI_STATE(可选) 进行网络环境识别和兼容处理时 读取 Wi-Fi 状态,用于网络判断和部分 SDK 兼容能力。
CHANGE_WIFI_STATE(可选) 进行部分网络兼容或切换处理时 允许在兼容场景下调整 Wi-Fi 状态,满足部分第三方 SDK 的联网需求。

媒体与文件

权限相关权限 权限调用时机 权限用途
READ_MEDIA_IMAGES(可选) 进行相册选图、发帖、上传和预览时 读取图片资源,支撑发帖、头像、分享和素材上传等功能。
READ_MEDIA_VIDEO(可选) 进行相册选视频、发帖、上传和预览时 读取视频资源,支撑发帖、上传和内容预览等功能。
WRITE_MEDIA_IMAGES / WRITE_MEDIA_VIDEO(可选) 保存图片或视频到系统媒体库时 将生成或下载的图片、视频写入系统相册,便于用户保存和分享。
READ_EXTERNAL_STORAGE / WRITE_EXTERNAL_STORAGE(可选,兼容 Android 12L 及以下) 兼容旧系统进行本地文件读写时 适配低版本系统的相册读取、文件保存和本地资源访问。

相机、录音与扫码

权限相关权限 权限调用时机 权限用途
CAMERA(可选) 进行扫一扫、拍照、拍视频或头像采集时 使用相机能力采集图像或视频内容。
RECORD_AUDIO(可选) 进行语音输入、语音相关功能或视频录制时 采集麦克风音频,支撑语音和视频场景。
MODIFY_AUDIO_SETTINGS(可选) 进行音频播放或录制路由调整时 调整音频设置,保证播放和录制体验正常。
FLASHLIGHT(可选) 扫一扫需要补光时 打开闪光灯辅助扫码识别。

定位与地图

权限相关权限 权限调用时机 权限用途
ACCESS_FINE_LOCATION(可选) 进行精确定位、附近内容或地图相关功能时 获取精确位置信息,支撑本地服务、附近内容和地图展示。
ACCESS_COARSE_LOCATION(可选) 进行粗略定位或城市区域判断时 获取大致位置,用于城市识别和弱定位场景。

通知、启动与前台服务

权限相关权限 权限调用时机 权限用途
POST_NOTIFICATIONS(可选) Android 13 及以上展示通知和推送消息时 允许应用向用户展示通知、推送和提醒信息。
RECEIVE_BOOT_COMPLETED(可选) 开机后恢复推送或初始化任务时 让应用在设备重启后完成必要的初始化和恢复工作。
WAKE_LOCK(可选) 执行推送、下载或后台任务时 保证任务在唤醒状态下顺利执行完成。
FOREGROUND_SERVICE(可选) 进行下载、定位或持续运行任务时 支持前台服务持续运行,避免关键任务被系统过早回收。

更新、系统设置与覆盖层

权限相关权限 权限调用时机 权限用途
REQUEST_INSTALL_PACKAGES(可选) 应用更新或安装 APK 时 允许下载完成后发起应用安装流程。
SYSTEM_ALERT_WINDOW(可选) 需要悬浮窗展示时 显示悬浮层或覆盖层内容。
SYSTEM_OVERLAY_WINDOW(可选) 进行地图或兼容覆盖层展示时 提供系统覆盖层显示能力,满足相关页面和 SDK 场景。

应用可见性与生物识别

权限相关权限 权限调用时机 权限用途
QUERY_ALL_PACKAGES(可选) 进行应用安装包可见性判断、分享或外部跳转兼容时 获取已安装应用信息,完成分享、跳转和兼容性判断。
USE_BIOMETRIC / USE_FINGERPRINT(可选) 登录或校验使用生物识别时 支持指纹或人脸等生物识别验证能力。

桌面角标、厂商推送与 SDK 互通

权限相关权限 权限调用时机 权限用途
READ_APP_BADGE(可选) 显示桌面角标时 兼容桌面红点和角标显示。
com.huawei.android.launcher.permission.CHANGE_BADGE / READ_SETTINGS / WRITE_SETTINGS(可选) 华为桌面角标同步时 更新和读取华为桌面角标配置。
com.oppo.launcher.permission.READ_SETTINGS / WRITE_SETTINGS(可选) OPPO 桌面角标同步时 更新和读取 OPPO 桌面角标配置。
permission.MIPUSH_RECEIVE(可选) 小米推送接收时 接收小米推送消息。
openadsdk.permission.TT_PANGOLIN(可选) 第三方广告或下载 SDK 通信时 允许相关 SDK 进行广播通信和任务回调。
permission.KW_SDK_BROADCAST(可选) 广告或下载 SDK 执行下载回调时 支持 SDK 广播通信和下载状态回调。