204 lines
15 KiB
Markdown
204 lines
15 KiB
Markdown
|
# 三方应用对接授权文档
|
|||
|
|
|
|||
|
|
一、概述
|
|||
|
|
|
|||
|
|
徐工车机项目的隐私授权系统通过 Android Settings.System 存储授权状态（0/1值），第三方应用通过读取这些
|
|||
|
|
Key 的值来判断用户是否已授权，进而决定是否允许对应功能的访问。
|
|||
|
|
|
|||
|
|
二、读取授权状态
|
|||
|
|
|
|||
|
|
2.1 权限授权状态
|
|||
|
|
|
|||
|
|
全局开关和有效期
|
|||
|
|
|
|||
|
|
┌────────────────────────────────────────┬──────┬──────────────────────┐
|
|||
|
|
│ Key │ 类型 │ 说明 │
|
|||
|
|
├────────────────────────────────────────┼──────┼──────────────────────┤
|
|||
|
|
│ xcmg_permission_global_switch │ int │ 0 = 关闭，1 = 开启 │
|
|||
|
|
├────────────────────────────────────────┼──────┼──────────────────────┤
|
|||
|
|
│ xcmg_permission_authorization_duration │ int │ 1 = 180天，2 = 360天 │
|
|||
|
|
├────────────────────────────────────────┼──────┼──────────────────────┤
|
|||
|
|
│ xcmg_permission_authorization_date │ long │ 授权开始时间戳(毫秒) │
|
|||
|
|
└────────────────────────────────────────┴──────┴──────────────────────┘
|
|||
|
|
|
|||
|
|
具体权限Key及使用场景
|
|||
|
|
|
|||
|
|
┌────────────────────────────────────────────┬──────────────────────────────────────┐
|
|||
|
|
│ Key │ 使用场景 │
|
|||
|
|
├────────────────────────────────────────────┼──────────────────────────────────────┤
|
|||
|
|
│ xcmg_permission_contacts_bluetooth_phone │ 联系人权限 - 蓝牙电话读取联系人 │
|
|||
|
|
├────────────────────────────────────────────┼──────────────────────────────────────┤
|
|||
|
|
│ xcmg_permission_microphone_voice_assistant │ 麦克风权限 - 语音助手录音 │
|
|||
|
|
├────────────────────────────────────────────┼──────────────────────────────────────┤
|
|||
|
|
│ xcmg_permission_microphone_bluetooth_phone │ 麦克风权限 - 蓝牙电话通话 │
|
|||
|
|
├────────────────────────────────────────────┼──────────────────────────────────────┤
|
|||
|
|
│ xcmg_permission_location_voice_assistant │ 位置权限 - 语音助手获取位置 │
|
|||
|
|
├────────────────────────────────────────────┼──────────────────────────────────────┤
|
|||
|
|
│ xcmg_permission_location_map │ 位置权限 - 地图/导航获取位置 │
|
|||
|
|
├────────────────────────────────────────────┼──────────────────────────────────────┤
|
|||
|
|
│ xcmg_permission_location_carlink │ 位置权限 - 亿连手机互联获取位置 │
|
|||
|
|
├────────────────────────────────────────────┼──────────────────────────────────────┤
|
|||
|
|
│ xcmg_permission_camera_dvr │ 摄像头权限 - 行车记录仪录像 │
|
|||
|
|
└────────────────────────────────────────────┴──────────────────────────────────────┘
|
|||
|
|
|
|||
|
|
读取示例（Java）：
|
|||
|
|
|
|||
|
|
// 读取某个具体权限状态
|
|||
|
|
int locationMapPermission = Settings.System.getInt(
|
|||
|
|
context.getContentResolver(), "xcmg_permission_location_map", 0);
|
|||
|
|
// 1 = 已授权, 0 = 未授权
|
|||
|
|
|
|||
|
|
// 判断授权是否有效（完整判断逻辑）
|
|||
|
|
boolean isAuthorized = false;
|
|||
|
|
int globalSwitch = Settings.System.getInt(
|
|||
|
|
context.getContentResolver(), "xcmg_permission_global_switch", 0);
|
|||
|
|
if (globalSwitch == 1) {
|
|||
|
|
long authDate = Settings.System.getLong(
|
|||
|
|
context.getContentResolver(), "xcmg_permission_authorization_date", 0);
|
|||
|
|
int duration = Settings.System.getInt(
|
|||
|
|
context.getContentResolver(), "xcmg_permission_authorization_duration", 0);
|
|||
|
|
int totalDays = (duration == 1) ? 180 : 360;
|
|||
|
|
long daysPassed = (System.currentTimeMillis() - authDate) / (1000 * 60 * 60 * 24);
|
|||
|
|
if (daysPassed < totalDays) {
|
|||
|
|
// 有效期未过，读取具体权限
|
|||
|
|
int permission = Settings.System.getInt(
|
|||
|
|
context.getContentResolver(), "xcmg_permission_location_map", 0);
|
|||
|
|
isAuthorized = (permission == 1);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
三、判断逻辑
|
|||
|
|
|
|||
|
|
流程图：
|
|||
|
|
|
|||
|
|
┌─────────────┐ 否 ┌──────────┐
|
|||
|
|
│ 隐私已授权? ├────────────►│ 未授权 │
|
|||
|
|
└──────┬──────┘ └──────────┘
|
|||
|
|
│是
|
|||
|
|
▼
|
|||
|
|
┌─────────────┐ 否 ┌──────────┐
|
|||
|
|
│ 全局开关开启?├────────────►│ 未授权 │
|
|||
|
|
└──────┬──────┘ └──────────┘
|
|||
|
|
│是
|
|||
|
|
▼
|
|||
|
|
┌─────────────┐ 是 ┌──────────┐
|
|||
|
|
│ 授权已过期? ├────────────►│ 未授权 │
|
|||
|
|
└──────┬──────┘ └──────────┘
|
|||
|
|
│否
|
|||
|
|
▼
|
|||
|
|
┌─────────────┐ 否 ┌──────────┐
|
|||
|
|
│ 具体权限=1? ├────────────►│ 未授权 │
|
|||
|
|
└──────┬──────┘ └──────────┘
|
|||
|
|
│是
|
|||
|
|
▼
|
|||
|
|
┌──────────┐
|
|||
|
|
│ 已授权 │
|
|||
|
|
└──────────┘
|
|||
|
|
|
|||
|
|
四、具体弹窗代码
|
|||
|
|
|
|||
|
|
三方应用在读取权限Key为0（未授权）后，需弹出"允许/不允许"授权提示框。推荐通过广播触发系统弹窗（方式1），
|
|||
|
|
系统已内置对话框和处理逻辑；
|
|||
|
|
|
|||
|
|
方式1：广播触发系统弹窗（推荐）
|
|||
|
|
|
|||
|
|
发送广播后，系统 PrivacyPolicyMonitorService 会自动弹出权限授权请求对话框，包含"允许"和"不允许"按钮，
|
|||
|
|
用户点击"允许"后系统自动将对应 Settings.System Key 设为1，并继续检查下一个未授权权限。
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 请求权限授权，触发系统弹出"允许/不允许"对话框
|
|||
|
|
* @param context 上下文
|
|||
|
|
* @param targetPackageName 目标应用包名（用于系统判断所需权限列表）
|
|||
|
|
* @param permissionKey 具体的权限Key
|
|||
|
|
*/
|
|||
|
|
public static void requestPermission(Context context, String targetPackageName, String permissionKey) {
|
|||
|
|
Intent intent = new Intent("com.yaxon.carcontrol.ACTION_OPEN_PERMISSION_UI");
|
|||
|
|
intent.putExtra("package_name", targetPackageName);
|
|||
|
|
intent.putExtra("permission_key", permissionKey);
|
|||
|
|
intent.addFlags(Intent.FLAG_INCLUDE_STOPPED_PACKAGES);
|
|||
|
|
context.sendBroadcast(intent);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 使用示例：百度地图检测到位置权限未授权
|
|||
|
|
if (locationPermission == 0) {
|
|||
|
|
requestPermission(context, "com.title.mapautosdk", "xcmg_permission_location_map");
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
系统弹窗样式：
|
|||
|
|
┌─────────────────────────────────────┐
|
|||
|
|
│ 提示 │
|
|||
|
|
│ │
|
|||
|
|
│ 位置权限-地图：是否允许开启 │
|
|||
|
|
│ 位置权限？ │
|
|||
|
|
│ │
|
|||
|
|
│ 开启后，地图将被授权可获取位置信息 │
|
|||
|
|
│ │
|
|||
|
|
│ [允许] [不允许] │
|
|||
|
|
└─────────────────────────────────────┘
|
|||
|
|
|
|||
|
|
用户操作结果：
|
|||
|
|
- 点击"允许" → Settings.System 写入该 Key=1 → 继续检查下一个未授权权限 → 全部授权后自动启动目标应用
|
|||
|
|
- 点击"不允许" → Settings.System 写入该 Key=0 → 流程结束
|
|||
|
|
|
|||
|
|
五、应用包名与权限Key对照表
|
|||
|
|
|
|||
|
|
┌──────────────────────────────┬──────────────────────────────────────────────────────────┐
|
|||
|
|
│ 应用包名 │ 权限Key │
|
|||
|
|
├──────────────────────────────┼──────────────────────────────────────────────────────────┤
|
|||
|
|
│ com.yaxon.bluetooth │ xcmg_permission_contacts_bluetooth_phone │
|
|||
|
|
│ │ xcmg_permission_microphone_bluetooth_phone │
|
|||
|
|
├──────────────────────────────┼──────────────────────────────────────────────────────────┤
|
|||
|
|
│ com.txznet.txz │ xcmg_permission_microphone_voice_assistant │
|
|||
|
|
│ (同行者语音助手) │ xcmg_permission_location_voice_assistant │
|
|||
|
|
├──────────────────────────────┼──────────────────────────────────────────────────────────┤
|
|||
|
|
│ com.txznet.adapter │ xcmg_permission_microphone_voice_assistant │
|
|||
|
|
│ (同行者语音适配) │ xcmg_permission_location_voice_assistant │
|
|||
|
|
├──────────────────────────────┼──────────────────────────────────────────────────────────┤
|
|||
|
|
│ com.txzing.voiceassistant │ xcmg_permission_microphone_voice_assistant │
|
|||
|
|
│ (语音助手) │ xcmg_permission_location_voice_assistant │
|
|||
|
|
├──────────────────────────────┼──────────────────────────────────────────────────────────┤
|
|||
|
|
│ com.title.mapautosdk │ xcmg_permission_location_map │
|
|||
|
|
│ (百度地图) │ │
|
|||
|
|
├──────────────────────────────┼──────────────────────────────────────────────────────────┤
|
|||
|
|
│ net.easyconn │ xcmg_permission_location_carlink │
|
|||
|
|
│ (亿连手机互联) │ │
|
|||
|
|
├──────────────────────────────┼──────────────────────────────────────────────────────────┤
|
|||
|
|
│ com.yaxon.dvr │ xcmg_permission_camera_dvr │
|
|||
|
|
│ (行车记录仪) │ │
|
|||
|
|
└──────────────────────────────┴──────────────────────────────────────────────────────────┘
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
六、Key 速查（可直接复制）
|
|||
|
|
|
|||
|
|
**全局控制：**
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
xcmg_permission_global_switch // 全局开关 0=关闭 1=开启
|
|||
|
|
xcmg_permission_authorization_duration // 有效期 1=180天 2=360天
|
|||
|
|
xcmg_permission_authorization_date // 授权开始时间戳(毫秒)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**权限 Key：**
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
xcmg_permission_contacts_bluetooth_phone // 联系人权限 - 蓝牙电话读取联系人
|
|||
|
|
xcmg_permission_microphone_voice_assistant // 麦克风权限 - 语音助手录音
|
|||
|
|
xcmg_permission_microphone_bluetooth_phone // 麦克风权限 - 蓝牙电话通话
|
|||
|
|
xcmg_permission_location_voice_assistant // 位置权限 - 语音助手获取位置
|
|||
|
|
xcmg_permission_location_map // 位置权限 - 地图/导航获取位置
|
|||
|
|
xcmg_permission_location_carlink // 位置权限 - 亿连手机互联获取位置
|
|||
|
|
xcmg_permission_camera_dvr // 摄像头权限 - 行车记录仪录像
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**应用包名：**
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
com.yaxon.bluetooth // 蓝牙
|
|||
|
|
com.txznet.txz // 同行者语音助手
|
|||
|
|
com.txznet.adapter // 同行者语音适配
|
|||
|
|
com.txzing.voiceassistant // 语音助手
|
|||
|
|
com.title.mapautosdk // 百度地图
|
|||
|
|
net.easyconn // 亿连手机互联
|
|||
|
|
com.yaxon.dvr // 行车记录仪
|
|||
|
|
```
|