PermissionBridge.h 3.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091
  1. #ifndef PERMISSIONBRIDGE_H
  2. #define PERMISSIONBRIDGE_H
  3. #include <QObject>
  4. #include <QVariantList>
  5. #include <QVariantMap>
  6. #include <QString>
  7. #include <QTimer>
  8. /**
  9. * 权限桥接:把 Android 侧的权限检测/申请能力暴露给 QML。
  10. *
  11. * Android 权限分两类(平台强制,不可绕过):
  12. * 1) 运行时权限(定位/电话/存储/相机) —— 可由应用主动弹窗申请,用户点"允许"即授予;
  13. * 2) 特殊权限(修改系统设置/所有文件访问/悬浮窗) —— 平台禁止静默授予,
  14. * 只能跳系统设置页;若用户已开启本应用的无障碍服务,可由无障碍服务自动点击开关。
  15. *
  16. * 设计要点:
  17. * - 非 Android 平台(Windows 调试)全部接口返回"已授权",保证 QML 在 PC 上不报错;
  18. * - 检测与申请分离:checkAll() 只读状态不打扰用户,request() 才触发交互;
  19. * - 状态变化通过 signals 通知 QML 刷新,避免 QML 轮询。
  20. */
  21. class PermissionBridge : public QObject
  22. {
  23. Q_OBJECT
  24. // 权限状态列表:每项含 group/name/special/autoClickSupport/granted
  25. Q_PROPERTY(QVariantList permissionList READ permissionList NOTIFY permissionListChanged)
  26. // 缺失的运行时权限数量(0 表示全部就绪)
  27. Q_PROPERTY(int missingCount READ missingCount NOTIFY permissionListChanged)
  28. // 无障碍服务是否已开启(决定特殊权限能否自动点击)
  29. Q_PROPERTY(bool accessibilityEnabled READ accessibilityEnabled NOTIFY accessibilityEnabledChanged)
  30. // 最近一次操作的中文结果提示,供 QML 顶部横幅显示
  31. Q_PROPERTY(QString lastMessage READ lastMessage NOTIFY lastMessageChanged)
  32. public:
  33. explicit PermissionBridge(QObject *parent = nullptr);
  34. ~PermissionBridge() override;
  35. QVariantList permissionList() const { return m_list; }
  36. int missingCount() const;
  37. bool accessibilityEnabled() const;
  38. QString lastMessage() const { return m_lastMessage; }
  39. public slots:
  40. /** 重新检测全部权限(只读,不触发任何弹窗) */
  41. Q_INVOKABLE void checkAll();
  42. /**
  43. * 申请某项权限。
  44. * 运行时权限 -> 系统弹窗;
  45. * 特殊权限 -> 若无障碍已开启则尝试自动点击,否则跳系统设置页。
  46. */
  47. Q_INVOKABLE void request(const QString &group);
  48. /** 一键补齐所有缺失权限:先批量申请运行时权限,特殊权限逐个处理 */
  49. Q_INVOKABLE void requestAll();
  50. /** 打开某项权限的系统设置页(手动路径,作为自动点击失败时的兜底) */
  51. Q_INVOKABLE void openSettings(const QString &group);
  52. /** 打开无障碍服务设置页 */
  53. Q_INVOKABLE void openAccessibilitySettings();
  54. /** 清除结果提示 */
  55. Q_INVOKABLE void clearMessage();
  56. signals:
  57. void permissionListChanged();
  58. void accessibilityEnabledChanged();
  59. void lastMessageChanged();
  60. /** 申请运行时权限后系统弹窗返回时触发,granted=true 表示全部已允许 */
  61. void runtimePermissionResult(bool granted);
  62. private:
  63. QVariantList m_list;
  64. QString m_lastMessage;
  65. QTimer *m_refreshTimer = nullptr;
  66. // ---- Android JNI ----
  67. void checkAllAndroid();
  68. void requestAndroid(const QString &group);
  69. void requestAllAndroid();
  70. void openSettingsAndroid(const QString &group);
  71. bool accessibilityEnabledAndroid() const;
  72. static QVariantList buildFallbackList();
  73. signals:
  74. void needRefresh();
  75. };
  76. #endif // PERMISSIONBRIDGE_H