权限合规

危险

新的权限合规接口：

无论项目或 Omni SDK，只要使用新接口，共享参数、权限状态，遵循同一套政策逻辑。
项目或渠道使用自己的权限申请接口，则遵循各自定义的逻辑。只共享权限在系统中的真实授予状态这一参数。

描述

本接口，以 OmniSDK 、世游法务需求来设计相应权限审核合规的通用流程。
在此基础上动态加入部分可配置选项。
项目如果认为此流程无法满足自己的合规要求，需要项目自己开发。
OmniSDK 不单独对项目要求进行开发，只适配权限。

官方要求描述

Android 官方权限申请描述
Android 6.0 开始，对权限申请进行精细控制，每一个版本都有不同要求。其表象目前可以总结为：首次申请无限制，二次申请需理由，三次以后申请只能引导到权限设置页面，特殊权限需要跳转到特定系统界面设置。
当然因为 Android 厂商众多、定制 Rom 众多、系统版本众多，具体表现以具体手机为准。
海外权限申请审核：以 Android 官方权限申请描述为标准，暂无其他限制。
国内权限申请审核：增加 48 小时限制，时限之内不允许申请（具体规定大家都在探索中）。

版本生效与接口废弃

OmniSDK v2.3.1 开始生效。
同时原来接口直接废弃，相关接口如下：

危险

hasPermission()
checkCanRequestPermission()
requestPermissions(activity: Activity, @IntRange(from = 0) requestCode ...)
registerRequestPermissions()

1.获取权限状态

接口说明

判断游戏是否拥有某个权限；
游戏通过 android.Manifest.permission 获取权限；
一次只检查一个权限。
可以通过 android.Manifest Android 线上文档查看权限字符串(Constant Value)

接口

getPermissionGrantedStatus(Activity activity, String permission)

返回值

返回值	描述	处理方式	备注
`-1`	该权限生效高于当前系统版本	该权限在高于当前系统版本时才会生效。该权限根据系统规定：无此功能、直接授予、权限组授予(即另一个权限申请时自动授予)申请时无需额外处理，相关功能需要项目适配处理。
`0`	应用已被授予该权限	无需再申请，直接使用相关功能
`1`	未授予，且未真实申请过	弹出首次申请的弹窗： 1. 取消弹窗，则增加时间限制； 2. 同意弹窗，则真实申请，真实申请+1。	国内默认48小时，海外无
`148`	未授予，时间限制无法申请	处理逻辑同`1`	同`1`
`2`	未授予，且被拒绝过一次	弹出第二次申请的弹窗： 1. 取消弹窗，则增加时间限制； 2. 同意弹窗，则真实申请，真实申请+1。	同`1`部分权限可以无限制申请，情况以厂商系统为准。
`248`	未授予，时间限制无法申请	处理逻辑同`2`	同`1`
`3`	未授予，且被永久拒绝	弹出引导到系统界面设置的弹窗： 1. 取消弹窗，则增加时间限制； 2. 同意弹窗，则跳转到系统的应用权限管理界面，用户手动开启权限。	部分权限可以无限制申请，情况以厂商系统为准。
`348`	未授予，时间限制无法申请	处理逻辑同`3`	同`1`

示例

int status = OmniSDK.getInstance().getPermissionGrantedStatus(activity, "android.permission.REQUEST_INSTALL_PACKAGES");

2.注册权限结果回调

接口说明

请求权限前，需要先注册权限结果回调。
返回结果为 JSON 字符串，数据结构为 PermissionResultModel。
allGranted：返回 true 代表申请的权限都被成功授予；false 代表有权限被拒绝授予。

接口

registerPermissionsCallback(PermissionNewCallback callbck)

数据结构 PermissionResultModel

{
    "allGranted": true,
    "granted": [
        "android.permission.WRITE_EXTERNAL_STORAGE",
        "android.permission.READ_PHONE_STATE"
    ],
    "denied": [
        "android.permission.WRITE_EXTERNAL_STORAGE",
        "android.permission.READ_PHONE_STATE"
    ]
}

3.申请权限

接口说明

使用前请阅读 “特殊权限列表”、“常用权限在不同 TargetSdk 下兼容处理方案” 两章节的内容。
permissionJson 为 JSON 字符串，可通过 PermissionRequestModel 定义后转化成 JSON。

接口

requestPermissions(Activity activity, String permissionJson)

PermissionRequestModel 定义

Key	描述	说明	注意事项
`showDialog`	是否由 OmniSDK 处理弹窗	1.`true` 代表由 OmniSDK 处理弹窗，游戏传相关文案。 2.`false` 代表由游戏处理权限申请的理由弹窗	游戏使用自己 UI 的同时，可调用 OmniSDK 的权限申请接口。
`timeLimit`	申请间隔限制，单位小时	>=0，不设置或<0 则使用默认值	默认值：国内 48 小时，海外 0 小时
`permissions`	需要申请的权限及理由文案	PermissionModel
`group`	权限列表	权限常量值：通过 Manifest.permission 获取	1.如果申请多个不同权限，OmniSDK 内部自动合并文案为一个弹窗，减少弹窗次数。 2.Android 系统允许一次申请多个不同权限，部分厂商可能不支持。
`applyDialog`	正常权限的申请理由弹窗	1.正常权限的理由文案 2.`showDialog` 为 `false` 可以不写
`specialDialog`	特殊权限的申请理由弹窗	1.特殊权限的理由文案。 2.申请的权限不是特殊权限时可以不用写。 3.无论 `showDialog` 值，申请的是特殊权限时必须写。 4.查阅特殊权限列表。	1.特殊权限需要在正常权限或前置条件满足后才可以申请。 2.由于是内部逻辑，无法将理由弹窗暴露给游戏，需要游戏将理由文案传递进来，由 OmniSDK 控制。 3.不同特殊权限，需要按系统指定方式处理。
`guideDialog`	引导系统界面的理由弹窗	1.被永久拒绝的权限的理由文案 2.`showDialog` 为 `false` 可以不写

JSON 数据结构示例

showDialog = true

{
    "showDialog": true,
    "timeLimit": 48,
    "permissions": [
        {
            "group": [
                "android.permission.WRITE_EXTERNAL_STORAGE",
                "android.permission.READ_EXTERNAL_STORAGE"
            ],
            "applyDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要访问手机的存储空间，用于游戏资源更新等\n\n请允许权限申请",
                "ok": "允许",
                "cancel": "取消"
            },
            "guideDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要访问手机的存储空间，用于游戏资源更新等\n\n请在系统设置界面-应用权限，开启访问存储空间的权限",
                "ok": "去开启",
                "cancel": "取消"
            }
        },
        {
            "group": [
                "android.permission.READ_PHONE_STATE"
            ],
            "applyDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要获取设备唯一标识码用于用户识别、统计\n\n请允许权限申请",
                "ok": "允许",
                "cancel": "取消"
            },
            "guideDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要获取设备唯一标识码用于用户识别、统计\n\n请在系统设置界面-应用权限，开启访问存储空间的权限",
                "ok": "去开启",
                "cancel": "取消"
            }
        },
        {
            "group": [
                "android.permission.ACCESS_FINE_LOCATION",
                "android.permission.ACCESS_COARSE_LOCATION",
                "android.permission.ACCESS_BACKGROUND_LOCATION"
            ],
            "applyDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要获取模糊、精确、后台定位，用于推荐本地好友\n\n请允许权限申请",
                "ok": "允许",
                "cancel": "取消"
            },

            "guideDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要获取模糊、精确、后台定位，用于推荐本地好友\n\n请在系统设置界面-应用权限，开启定位权限",
                "ok": "去开启",
                "cancel": "取消"
            },
            "specialDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)系统限制，需要继续开启后台定位，用于推荐本地好友\n\n请点击定位-始终允许，开启后台定位权限",
                "ok": "去开启",
                "cancel": "取消"
            }
        }
    ]
}

showDialog = false

{
    "showDialog": false,
    "timeLimit": 48,
    "permissions": [
        {
            "group": [
                "android.permission.WRITE_EXTERNAL_STORAGE",
                "android.permission.READ_EXTERNAL_STORAGE"
            ]
        },
        {
            "group": [
                "android.permission.READ_PHONE_STATE"
            ]
        },
        {
            "group": [
                "android.permission.ACCESS_FINE_LOCATION",
                "android.permission.ACCESS_COARSE_LOCATION",
                "android.permission.ACCESS_BACKGROUND_LOCATION"
            ],
            "specialDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)系统限制，需要继续开启后台定位，用于推荐本地好友\n\n请点击定位-始终允许，开启后台定位权限",
                "ok": "去开启",
                "cancel": "取消"
            }
        }
    ]
}

特殊权限列表

列表

信息

特殊权限仅在 Target 开始的版本有效，低于指定 Target 版本按之前的规范处理。
特殊权限具体的行为及处理不在本文档书写之内，项目只需确认 Target 版本。

权限	Target 版本
后台访问位置信息（即始终允许）	Target(29)	android.permission.ACCESS_BACKGROUND_LOCATION
请求所有文件访问	Target(30)	android.permission.MANAGE_EXTERNAL_STORAGE
悬浮窗(显示在所有其他应用之上)	Target(23)	android.permission.SYSTEM_ALERT_WINDOW
读写系统设置	Target(23)	android.permission.WRITE_SETTINGS
允许应用程序安装 Apk	Target(23)	android.permission.REQUEST_INSTALL_PACKAGES
后台获取传感器数据	Target(33)	android.permission.BODY_SENSORS_BACKGROUND
通知栏权限	Target(33)	android.permission.POST_NOTIFICATIONS

处理说明

特殊权限的申请必须在相关前置权限(如果有)、正常权限申请完成后再申请。
由于是内部逻辑，无法将理由弹窗暴露给游戏，需要游戏将理由文案传递进来，由 OmniSDK 控制。
特殊权限需要跳转系统特定界面处理。

几个常用权限示例

1.存储权限-storage（建议废弃，使用应用私有空间存储）

存储权限变更历史

Android 10 开始系统针对文件类型进行了分类，图片、音频、视频这三类文件将可以通过 MediaStore API 来进行访问，而其他类型的文件则需要使用系统的文件选择器来进行访问。
即原来通过 READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 权限获取存储空间所有文件类型读写的权限开始收紧。
存储空间访问权限开始分为三个范围：应用私有、其他应用私有、共享空间。
- 应用私有 在 Target(19) 开始不需要申请权限即可完全访问读写，其唯一“缺点”就是随应用卸载而删除数据。
- 注意：根据我们对大部分游戏的分析，游戏的资源更新、图片分享等存储需求，完全可以只使用应用私有 空间，不需要额外申请权限，建议游戏直接适配此方法。
- 使用 context.getExternalFilesDir(null) 方法获取其根路径再进行读写。根路径固定为： storage/Android/data/package-name/files/
- 示例：File file = new File(context.getExternalFilesDir(null) + "/game/", "update.txt");
Android 10 开始我们的应用向媒体库添加的图片、音频或视频，将会自动拥有其读写权限，不需要额外申请READ_EXTERNAL_STORAGE 和 WRITE_EXTERNAL_STORAGE 权限。
如果要读取其他应用程序向媒体库贡献的图片、音频或视频，则必须要申请 READ_EXTERNAL_STORAGE 权限才行。
WRITE_EXTERNAL_STORAGE 权限将会在未来的 Android 版本中废弃。即非文件类应用不能访问共享存储空间和其他应用的私有存储空间。如果想完全访问需要申请 MANAGE_EXTERNAL_STORAGE。
从 Android 13 开始，如果你的应用 Target 指定到了 33 或以上，那么 READ_EXTERNAL_STORAGE 权限就完全失去了作用，申请它将不会产生任何的效果。
从 Android 13 开始，Android 将图片、音频、视频这三类文件的权限变更为单独权限来申请：
- READ_MEDIA_IMAGES 管理手机的照片（权限组 READ_MEDIA_VISUAL）。
- READ_MEDIA_VIDEO 管理手机的视频（权限组 READ_MEDIA_VISUAL）。
- READ_MEDIA_AUDIO 管理手机的音频文件（权限组 READ_MEDIA_AURAL`）。
- 且可能审核会要求为相应领域类型的应用才可申请相关权限。
以上，建议游戏使用 应用私有 空间，进行读写自己的文件同时无需申请权限，避免复杂的适配。

Target <= 32

AndroidManifest.xml 声明

<application
    android:requestLegacyExternalStorage="true"> <!-- 如果 Target>=29 还需要添加这行 -->

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

申请方案示例

{
    "showDialog": true,
    "timeLimit": 48,
    "permissions": [
        {
            "group": [
                "android.permission.WRITE_EXTERNAL_STORAGE",
                "android.permission.READ_EXTERNAL_STORAGE"
            ],
            "applyDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要访问手机的存储空间，用于游戏资源更新等\n\n请允许权限申请",
                "ok": "允许",
                "cancel": "取消"
            },
            "guideDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要访问手机的存储空间，用于游戏资源更新等\n\n请在系统设置界面-应用权限，开启访问存储空间的权限",
                "ok": "去开启",
                "cancel": "取消"
            }
        }
    ]
}

Target >= 33

信息

android.permission.READ_EXTERNAL_STORAGE 失效，暂时可以不用管，等渠道审核要求。
按国内厂商要求，一般二年左右会有要求，具体以厂商通知为准。
建议使用 应用私有 空间，无需权限申请。

2.访问电话状态权限（建议废弃）

android.permission.READ_PHONE_STATE 权限是允许访问电话状态权限，对 imei，deviceId 等 id 的获取，即设备唯一标识码。
在 6.0 之前只需注册后就可以使用，Android 6.0 开始需要动态申请。
Android10 开始，READ_PHONE_STATE 被取消掉，申请无反应，使用相关 API，直接抛异常；换成系统权限 READ_PRIVILEGED_PHONE_STATE，此权限只能在系统 APP 中才可以被使用；普通应用无法申请。
国内改用 OAID，海外改用 Google ADId，但是用户可以重置。

AndroidManifest.xml 声明

<uses-permission 
    android:name="android.permission.READ_PHONE_STATE" 
    android:maxSdkVersion="28"/> 

申请方案示例

{
    "showDialog": true,
    "timeLimit": 48,
    "permissions": [
        {
            "group": [
                "android.permission.READ_PHONE_STATE"
            ],
            "applyDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要获取设备唯一标识码用于用户识别、统计\n\n请允许权限申请",
                "ok": "允许",
                "cancel": "取消"
            },
            "guideDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要获取设备唯一标识码用于用户识别、统计\n\n请在系统设置界面-应用权限，开启访问存储空间的权限",
                "ok": "去开启",
                "cancel": "取消"
            }
        }
    ]
}

3.位置权限

精确定位与模糊定位

Android 12 起且 Target 31，Android 官方提供精确定位和模糊定位的判断。之前版本不支持，由厂商提供其对应的 API 判断。
因此，Target ≤ 30 且支持模糊定位的机型（小米 / Vivo），需使用厂商提供的 API 进行判断，OmniSDK 目前不提供适配。
Target ≥ 31 时，直接使用系统 API 判断：

if (activity.getApplicationInfo().targetSdkVersion >= 31) {
    boolean hasFineLocation = OmniSDK.getInstance().isGrantedOrShownRationale(activity, "android.permission.ACCESS_FINE_LOCATION") == 0;
}

后台定位

Android 10 起且 Target 29，Android 引入后台定位权限 ACCESS_BACKGROUND_LOCATION。
Target = 29 时：应用需在 AndroidManifest 声明 ACCESS_BACKGROUND_LOCATION 权限，然后动态申请该权限且用户选择 “始终允许” 才能获取到后台定位能力。
Target ≥ 30 时：应用需在 AndroidManifest 声明 ACCESS_BACKGROUND_LOCATION 权限，然后用户在系统设置页面上选择 “始终允许” 后才能获取到后台定位能力。
注意，ACCESS_BACKGROUND_LOCATION 不可以单独申请，而是要应用程序在获得 ACCESS_FINE_LOCATION 或 ACCESS_COARSE_LOCATION 权限之后再申请，是一个特殊权限。
OmniSDK 对此针对性适配，项目按要求声明、请求即可。

定位申请示例

请按隐私协议内容要求申请，三种类型，协议没用哪一种就不要声明或申请，否则审核不过。

AndroidManifest.xml 声明

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

申请方案示例

{
    "showDialog": true,
    "timeLimit": 48,
    "permissions": [
        {
            "group": [
                "android.permission.ACCESS_FINE_LOCATION",
                "android.permission.ACCESS_COARSE_LOCATION",
                "android.permission.ACCESS_BACKGROUND_LOCATION"
            ],
            "applyDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要获取模糊、精确、后台定位，用于推荐本地好友\n\n请允许权限申请",
                "ok": "允许",
                "cancel": "取消"
            },
            "guideDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要获取模糊、精确、后台定位，用于推荐本地好友\n\n请在系统设置界面-应用权限，开启定位权限",
                "ok": "去开启",
                "cancel": "取消"
            },
            "specialDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)系统限制，需要继续开启后台定位，用于推荐本地好友\n\n请点击定位-始终允许，开启后台定位权限",
                "ok": "去开启",
                "cancel": "取消"
            }
        }
    ]
}

4.悬浮窗权限

特殊权限：Target >= 23 时，只能引导用户到设置界面开启。

AndroidManifest.xml 声明

<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

申请方案示例

{
    "showDialog": true,
    "timeLimit": 48,
    "permissions": [
        {
            "group": [
                "android.permission.SYSTEM_ALERT_WINDOW"
            ],
            "applyDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要悬浮窗权限\n\n请允许权限申请",
                "ok": "允许",
                "cancel": "取消"
            },
            "guideDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要悬浮窗权限\n\n请在系统设置界面，点击-允许显示悬浮窗，开启悬浮窗权限",
                "ok": "去开启",
                "cancel": "取消"
            },
            "specialDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)系统限制，需要在设置界面开启悬浮窗权限\n\n请在设置界面选中(游戏)开启悬浮窗权限",
                "ok": "去开启",
                "cancel": "取消"
            }
        }
    ]
}

5.蓝牙权限

蓝牙功能的权限变更历史

Target ≤ 28 时： 具备 BLUETOOTH 和 BLUETOOT_ADMIN 权限就能使用连接类 API 和广播类 API，扫描类 API需要具备大致定位权限（ACCESS_COARSE_LOCATION）。
Target 为 29 和 30 时：连接类 API 和广播类 API 权限无变化，扫描类 API 需要另外具备精确定位权限(ACCESS_FINE_LOCATION)。
Target ≥ 31 时： 新增细分的运行时蓝牙权限来替代 BLUETOOTH 和 BLUETOOTH_ADIMIN，为应用提供更灵活的权限申请方式。
1. BLUETOOTH_SCAN：允许扫描和发现设备，扫描类 API 需要同时具备该权限和精确定位权限(ACCESS_FINE_LOCATION)。
2. BLUETOOTH_CONNECT：允许连接和访问已配对的设备，连接类 API 需要具备该权限。
3. BLUETOOTH_ADVERTISE：允许向附近的蓝牙设备进行广播，广播类 API 需要具备该权限。

不同 Target 版本的不同蓝牙功能申请的权限对应关系表：

Target 版本	扫描类	连接类	广播
<=28	`android.permission.BLUETOOTH` `android.permission.BLUETOOTH_ADMIN` `android.permission.ACCESS_COARSE_LOCATION`	`android.permission.BLUETOOTH` `android.permission.BLUETOOTH_ADMIN`	`android.permission.BLUETOOTH` `android.permission.BLUETOOTH_ADMIN`
29-30	`android.permission.BLUETOOTH` `android.permission.BLUETOOTH_ADMIN` `android.permission. ACCESS_FINE_LOCATION`	`android.permission.BLUETOOTH` `android.permission.BLUETOOTH_ADMIN`	`android.permission.BLUETOOTH` `android.permission.BLUETOOTH_ADMIN`
>=31	`android.permission.BLUETOOTH_SCAN` `android.permission. ACCESS_FINE_LOCATION`	`android.permission.BLUETOOTH_CONNECT`	`android.permission.BLUETOOTH_ADVERTISE`

连接类功能申请蓝牙权限示例

Target < 31

符合隐私协议 & 在 AndroidManifest.xml 声明蓝牙权限
不需要申请

<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />

Target >= 31

AndroidManifest.xml 声明

<!-- Request legacy Bluetooth permissions on older devices. -->
<uses-permission android:name="android.permission.BLUETOOTH"
                     android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"
                     android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

申请方案示例

if (Build.VERSION.SDK_INT >= 31) {
    // 大于必须申请，否则在Android 12 以上 蓝牙API 使用时会崩溃。
    OmniSDK.getInstance().requestPermissions(this, jsonString);
} else {
    // 低于不需要申请
    boolean bluetooth = OmniSDK.getInstance().isGrantedOrShownRationale(activity, Manifest.permission.BLUETOOTH) == 0;
    boolean bluetoothAdmin = OmniSDK.getInstance().isGrantedOrShownRationale(activity, Manifest.permission.BLUETOOTH_ADMIN) == 0;
}

jsonString

{
    "showDialog": true,
    "timeLimit": 48,
    "permissions": [
        {
            "group": [
                "android.permission.BLUETOOTH_CONNECT"
            ],
            "applyDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要蓝牙权限\n\n请允许权限申请",
                "ok": "允许",
                "cancel": "取消"
            },
            "guideDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要蓝牙权限\n\n请在系统设置界面，开启蓝牙权限",
                "ok": "去开启",
                "cancel": "取消"
            }
        }
    ]
}

不同厂商蓝牙设置位置

MIUI 13 ：权限-连接附近的设备（BLUETOOTH_CONNECT）。

6.安装 APK 权限

提示

Target >= 26，Android 8 新增特殊权限，需要跳转特定界面申请。
Android 11 特性调整，安装外部来源应用需要重启 App：https://cloud.tencent.com/developer/news/637591 ，即无法收到结果回调。
Android 12 已经修复了此问题，授权或者取消授权后应用并不会重启应用。

AndroidManifest.xml 声明

<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

申请方案示例

{
    "showDialog": true,
    "timeLimit": 48,
    "permissions": [
        {
            "group": [
                "android.permission.REQUEST_INSTALL_PACKAGES"
            ],
            "applyDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要安装APk权限\n\n请允许权限申请",
                "ok": "允许",
                "cancel": "取消"
            },
            "guideDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要安装APk权限\n\n请在系统设置界面，开启-允许来自此来源的应用，打开安装APK权限",
                "ok": "去开启",
                "cancel": "取消"
            },
            "specialDialog": {
                "title": "温馨提示",
                "rationale": "(游戏)需要安装APk权限\n\n请在系统设置界面，开启-允许来自此来源的应用，打开安装APK权限",
                "ok": "去开启",
                "cancel": "取消"
            }
        }
    ]
}

渠道申请的权限列表

渠道申请的权限与权限列表
注：此文档收集为接入渠道里渠道文档或 sdk 有列明的。部分渠道会二次打包或分包，添加新东西，请以最终渠道审核包的 AndroidManifest.xml 权限列表为准。

描述​

官方要求描述​

版本生效与接口废弃​

1.获取权限状态​

接口说明​

接口​

返回值​

示例​

2.注册权限结果回调​

接口说明​

接口​

数据结构 PermissionResultModel​

3.申请权限​

接口说明​

接口​

PermissionRequestModel 定义​

JSON 数据结构示例​

特殊权限列表​

列表​

处理说明​

几个常用权限示例​

1.存储权限-storage（建议废弃，使用应用私有空间存储）​

存储权限变更历史​

Target <= 32​

Target >= 33​

2.访问电话状态权限（建议废弃）​

3.位置权限​

精确定位与模糊定位​

后台定位​

定位申请示例​

4.悬浮窗权限​

5.蓝牙权限​

蓝牙功能的权限变更历史​

连接类功能申请蓝牙权限示例​

6.安装 APK 权限​

渠道申请的权限列表​

描述

官方要求描述

版本生效与接口废弃

1.获取权限状态

接口说明

接口

返回值

示例

2.注册权限结果回调

接口说明

接口

数据结构 PermissionResultModel

3.申请权限

接口说明

接口

PermissionRequestModel 定义

JSON 数据结构示例

特殊权限列表

列表

处理说明

几个常用权限示例

1.存储权限-storage（建议废弃，使用应用私有空间存储）

存储权限变更历史

Target <= 32

Target >= 33

2.访问电话状态权限（建议废弃）

3.位置权限

精确定位与模糊定位

后台定位

定位申请示例

4.悬浮窗权限

5.蓝牙权限

蓝牙功能的权限变更历史

连接类功能申请蓝牙权限示例

6.安装 APK 权限

渠道申请的权限列表