permission_settings_dialog.dart 1.97 KB
import 'package:app_settings/app_settings.dart';
import 'package:flutter/material.dart';

import 'permission_dialog_shell.dart';

/// 权限被永久拒绝后的「去设置」引导弹窗
///
/// 与首次使用的用途说明弹窗共用样式骨架,
/// 差异在于文案面向「已拒绝」场景,主按钮直接跳转系统应用设置页。
class PermissionSettingsDialog extends StatelessWidget {
  const PermissionSettingsDialog({super.key, required this.permission});

  /// 权限名称,兼容「相机」与「相机权限」两种写法
  final String permission;

  /// 各权限被拒绝后的引导说明
  static const Map<String, String> _descriptions = {
    '相机': '未开启相机权限,无法拍摄。您可以在"设置"中开启后重试。',
    '相册': '未开启相册权限,无法选择图片。您可以在"设置"中开启后重试。',
    '麦克风': '未开启麦克风权限,无法录音评测。您可以在"设置"中开启后重试。',
  };

  static const String _fallbackDescription = '未开启对应权限,无法使用相关功能。您可以在"设置"中开启后重试。';

  @override
  Widget build(BuildContext context) {
    final name = normalizePermissionName(permission);
    return PermissionDialogShell(
      title: permissionDialogTitle(permission),
      description: _descriptions[name] ?? _fallbackDescription,
      primaryText: '去设置',
      onPrimary: () {
        Navigator.of(context).pop();
        // 引导用户到系统应用设置页面手动开启权限
        AppSettings.openAppSettings(asAnotherTask: true);
      },
      secondaryText: '取消',
      onSecondary: () => Navigator.of(context).pop(),
    );
  }
}

/// 展示权限被永久拒绝后的「去设置」引导弹窗
Future<void> showPermissionSettingsDialog(BuildContext context, String permission) {
  return showDialog<void>(
    context: context,
    builder: (BuildContext context) => PermissionSettingsDialog(permission: permission),
  );
}