Browse Source
- 升级 permission_handler 依赖至 12.0.0+1 - 创建 PermissionUtil 工具类统一处理权限请求逻辑 - 在 AgentController 和 PairingController 中使用 PermissionUtil 替代原有权限检查方法 - 改进权限请求时的用户引导界面和提示信息 - 在权限设置页面集成新的权限请求流程newdev_shunjiawei
lxm
1 year ago
5 changed files with 396 additions and 209 deletions
@ -1,134 +1,202 @@ |
|||||
import 'package:flutter/material.dart'; |
import 'package:flutter/material.dart'; |
||||
import 'package:get/get.dart'; |
|
||||
import 'package:permission_handler/permission_handler.dart'; |
import 'package:permission_handler/permission_handler.dart'; |
||||
import 'package:app_settings/app_settings.dart'; |
import 'package:app_settings/app_settings.dart'; |
||||
|
import 'dart:developer'; |
||||
|
import 'logger.dart'; |
||||
|
|
||||
|
// class Logger { |
||||
|
// static void e(String tag, String message) { |
||||
|
// debugPrint('[$tag] ERROR: $message'); |
||||
|
// } |
||||
|
// } |
||||
|
|
||||
class PermissionUtil { |
class PermissionUtil { |
||||
/// 检查并请求多个权限 |
static final PermissionUtil instance = PermissionUtil._(); |
||||
/// |
PermissionUtil._(); |
||||
/// [permissions] 要检查的权限列表，如 [Permission.microphone, Permission.location] |
|
||||
/// [rationaleTitle] 弹窗标题 |
OverlayEntry? _explanationOverlayEntry; |
||||
/// [rationaleMessage] 权限用途说明内容（支持多行） |
|
||||
/// |
Future<bool> requestPermission({ |
||||
/// 返回是否所有权限都已被授予 |
required BuildContext context, |
||||
static Future<bool> checkAndRequestPermissions({ |
required Permission permissionType, |
||||
required List<Permission> permissions, |
required String permissionName, |
||||
required String rationaleTitle, |
required String explanationText, |
||||
required List<String> rationaleMessage, |
required String permanentDenialText, |
||||
|
String settingsButtonText = '前往设置', |
||||
|
String cancelButtonText = '取消', |
||||
}) async { |
}) async { |
||||
try { |
try { |
||||
Map<Permission, PermissionStatus> statuses = {}; |
final PermissionStatus status = await permissionType.status; |
||||
|
log('初始权限状态 for $permissionName: $status'); |
||||
// 检查是否都已授权 |
|
||||
bool allGranted = true; |
// 处理已授权状态（包括授予状态和临时通知权限） |
||||
for (var permission in permissions) { |
if (status == PermissionStatus.granted || |
||||
final status = await permission.status; |
status == PermissionStatus.provisional) { |
||||
if (!status.isGranted) { |
log('$permissionName 权限已授予或临时授权。'); |
||||
allGranted = false; |
return true; |
||||
statuses[permission] = status; |
} |
||||
|
|
||||
|
// 处理永久拒绝状态 |
||||
|
if (status == PermissionStatus.permanentlyDenied) { |
||||
|
log('$permissionName 权限被永久拒绝，显示引导对话框。'); |
||||
|
await _showPermanentDenialDialog( |
||||
|
context: context, |
||||
|
permissionName: permissionName, |
||||
|
permanentDenialText: permanentDenialText, |
||||
|
settingsButtonText: settingsButtonText, |
||||
|
cancelButtonText: cancelButtonText, |
||||
|
); |
||||
|
return false; |
||||
|
} |
||||
|
|
||||
|
// 处理初始拒绝/未决定状态 |
||||
|
if (status == PermissionStatus.denied) { |
||||
|
log('$permissionName 权限被拒绝或未决定，显示说明横幅并请求。'); |
||||
|
_showExplanationOverlay( |
||||
|
context: context, |
||||
|
permissionName: permissionName, |
||||
|
explanationText: explanationText, |
||||
|
); |
||||
|
|
||||
|
final PermissionStatus newStatus = await permissionType.request(); |
||||
|
log('请求后 $permissionName 的新权限状态: $newStatus'); |
||||
|
|
||||
|
_hideExplanationOverlay(); |
||||
|
|
||||
|
// 处理请求后的状态 |
||||
|
if (newStatus == PermissionStatus.granted || |
||||
|
newStatus == PermissionStatus.provisional) { |
||||
|
log('$permissionName 权限在请求后被授予或临时授权。'); |
||||
|
return true; |
||||
|
} else if (newStatus == PermissionStatus.permanentlyDenied) { |
||||
|
log('$permissionName 权限在请求后被永久拒绝，再次显示引导对话框。'); |
||||
|
await _showPermanentDenialDialog( |
||||
|
context: context, |
||||
|
permissionName: permissionName, |
||||
|
permanentDenialText: permanentDenialText, |
||||
|
settingsButtonText: settingsButtonText, |
||||
|
cancelButtonText: cancelButtonText, |
||||
|
); |
||||
} |
} |
||||
|
return false; |
||||
} |
} |
||||
|
|
||||
if (allGranted) return true; |
// 处理受限状态 |
||||
|
if (status == PermissionStatus.restricted || |
||||
// 判断是否包含永久拒绝 |
status == PermissionStatus.limited) { |
||||
bool hasPermanentDenied = |
log('$permissionName 权限受限或受限访问: $status'); |
||||
statuses.values.any((status) => status.isPermanentlyDenied); |
await _showRestrictedPermissionDialog(context, permissionName); |
||||
|
return false; |
||||
// 显示提示弹窗 |
} |
||||
_showPermissionDialog( |
|
||||
isPermanent: hasPermanentDenied, |
|
||||
title: rationaleTitle, |
|
||||
messages: rationaleMessage, |
|
||||
onConfirm: () async { |
|
||||
if (hasPermanentDenied) { |
|
||||
AppSettings.openAppSettings(); |
|
||||
} else { |
|
||||
final newStatuses = await permissions.request(); |
|
||||
final allGrantedNow = |
|
||||
newStatuses.values.every((status) => status.isGranted); |
|
||||
if (!allGrantedNow) { |
|
||||
print("部分权限被拒绝: $newStatuses"); |
|
||||
} |
|
||||
} |
|
||||
}, |
|
||||
); |
|
||||
|
|
||||
|
// 其他未知状态处理 |
||||
|
log('$permissionName 处于未知状态: $status'); |
||||
return false; |
return false; |
||||
} catch (e) { |
} catch (e) { |
||||
print("权限检查异常: $e"); |
Logger.e('PermissionUtil', '请求 $permissionName 权限失败: $e'); |
||||
|
_hideExplanationOverlay(); |
||||
return false; |
return false; |
||||
} |
} |
||||
} |
} |
||||
|
|
||||
/// 权限说明弹窗 |
void _showExplanationOverlay({ |
||||
static void _showPermissionDialog({ |
required BuildContext context, |
||||
required bool isPermanent, |
required String permissionName, |
||||
required String title, |
required String explanationText, |
||||
required List<String> messages, |
|
||||
required VoidCallback onConfirm, |
|
||||
}) { |
}) { |
||||
Get.generalDialog( |
_hideExplanationOverlay(); // 确保移除旧叠加层 |
||||
barrierDismissible: false, |
|
||||
barrierLabel: '权限提示', |
_explanationOverlayEntry = OverlayEntry( |
||||
transitionBuilder: (context, anim1, anim2, child) { |
builder: (context) => Positioned( |
||||
return SlideTransition( |
top: MediaQuery.of(context).padding.top + 10, |
||||
position: Tween<Offset>( |
left: 16, |
||||
begin: Offset(0, -1), |
right: 16, |
||||
end: Offset(0, 0), |
child: Material( |
||||
).animate(CurvedAnimation(parent: anim1, curve: Curves.easeOut)), |
borderRadius: BorderRadius.circular(12), |
||||
child: child, |
elevation: 4, |
||||
); |
color: Colors.white, |
||||
}, |
child: Padding( |
||||
pageBuilder: (context, anim1, anim2) { |
padding: const EdgeInsets.all(16), |
||||
return SafeArea( |
child: Column( |
||||
child: Align( |
mainAxisSize: MainAxisSize.min, |
||||
alignment: Alignment.topCenter, |
crossAxisAlignment: CrossAxisAlignment.start, |
||||
child: Padding( |
children: [ |
||||
padding: const EdgeInsets.only(top: 80, left: 24, right: 24), |
Text( |
||||
child: Material( |
'需要$permissionName权限', |
||||
borderRadius: BorderRadius.circular(12), |
style: const TextStyle( |
||||
color: Colors.white, |
fontWeight: FontWeight.bold, |
||||
child: Padding( |
fontSize: 16, |
||||
padding: const EdgeInsets.all(16), |
|
||||
child: Column( |
|
||||
mainAxisSize: MainAxisSize.min, |
|
||||
crossAxisAlignment: CrossAxisAlignment.start, |
|
||||
children: [ |
|
||||
Text(title, |
|
||||
style: TextStyle( |
|
||||
fontSize: 18, fontWeight: FontWeight.bold)), |
|
||||
const SizedBox(height: 12), |
|
||||
...messages.map((msg) => Padding( |
|
||||
padding: const EdgeInsets.only(bottom: 8), |
|
||||
child: Text("• $msg"), |
|
||||
)), |
|
||||
const SizedBox(height: 20), |
|
||||
Row( |
|
||||
mainAxisAlignment: MainAxisAlignment.end, |
|
||||
children: [ |
|
||||
TextButton( |
|
||||
onPressed: () => Get.back(), |
|
||||
child: const Text('取消'), |
|
||||
), |
|
||||
const SizedBox(width: 8), |
|
||||
TextButton( |
|
||||
onPressed: () { |
|
||||
Get.back(); |
|
||||
onConfirm(); |
|
||||
}, |
|
||||
child: Text(isPermanent ? '前往设置' : '授权'), |
|
||||
), |
|
||||
], |
|
||||
), |
|
||||
], |
|
||||
), |
), |
||||
), |
), |
||||
), |
const SizedBox(height: 8), |
||||
|
Text( |
||||
|
explanationText, |
||||
|
style: const TextStyle(fontSize: 14), |
||||
|
), |
||||
|
], |
||||
), |
), |
||||
), |
), |
||||
); |
), |
||||
}, |
), |
||||
|
); |
||||
|
|
||||
|
Future.delayed(Duration.zero, () { |
||||
|
if (_explanationOverlayEntry != null) { |
||||
|
Overlay.of(context).insert(_explanationOverlayEntry!); |
||||
|
log('权限说明叠加层已显示。'); |
||||
|
} |
||||
|
}); |
||||
|
} |
||||
|
|
||||
|
void _hideExplanationOverlay() { |
||||
|
_explanationOverlayEntry?.remove(); |
||||
|
_explanationOverlayEntry = null; |
||||
|
} |
||||
|
|
||||
|
Future<void> _showPermanentDenialDialog({ |
||||
|
required BuildContext context, |
||||
|
required String permissionName, |
||||
|
required String permanentDenialText, |
||||
|
required String settingsButtonText, |
||||
|
required String cancelButtonText, |
||||
|
}) async { |
||||
|
await showDialog<void>( |
||||
|
context: context, |
||||
|
barrierDismissible: false, |
||||
|
builder: (context) => AlertDialog( |
||||
|
title: Text('需要$permissionName权限'), |
||||
|
content: Text(permanentDenialText), |
||||
|
actions: [ |
||||
|
TextButton( |
||||
|
onPressed: () => Navigator.pop(context), |
||||
|
child: Text(cancelButtonText), |
||||
|
), |
||||
|
ElevatedButton( |
||||
|
onPressed: () { |
||||
|
Navigator.pop(context); |
||||
|
AppSettings.openAppSettings(); |
||||
|
}, |
||||
|
child: Text(settingsButtonText), |
||||
|
), |
||||
|
], |
||||
|
), |
||||
|
); |
||||
|
} |
||||
|
|
||||
|
Future<void> _showRestrictedPermissionDialog( |
||||
|
BuildContext context, String permissionName) async { |
||||
|
await showDialog( |
||||
|
context: context, |
||||
|
builder: (context) => AlertDialog( |
||||
|
title: Text('$permissionName权限受限'), |
||||
|
content: const Text('此功能在当前设备上不可用或受限，请检查设备设置或系统限制'), |
||||
|
actions: [ |
||||
|
TextButton( |
||||
|
onPressed: () => Navigator.pop(context), |
||||
|
child: const Text('确定'), |
||||
|
), |
||||
|
], |
||||
|
), |
||||
); |
); |
||||
} |
} |
||||
} |
} |
||||
|
|||||
Loading…
Reference in new issue