| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091 |
- #ifndef PERMISSIONBRIDGE_H
- #define PERMISSIONBRIDGE_H
- #include <QObject>
- #include <QVariantList>
- #include <QVariantMap>
- #include <QString>
- #include <QTimer>
- /**
- * 权限桥接:把 Android 侧的权限检测/申请能力暴露给 QML。
- *
- * Android 权限分两类(平台强制,不可绕过):
- * 1) 运行时权限(定位/电话/存储/相机) —— 可由应用主动弹窗申请,用户点"允许"即授予;
- * 2) 特殊权限(修改系统设置/所有文件访问/悬浮窗) —— 平台禁止静默授予,
- * 只能跳系统设置页;若用户已开启本应用的无障碍服务,可由无障碍服务自动点击开关。
- *
- * 设计要点:
- * - 非 Android 平台(Windows 调试)全部接口返回"已授权",保证 QML 在 PC 上不报错;
- * - 检测与申请分离:checkAll() 只读状态不打扰用户,request() 才触发交互;
- * - 状态变化通过 signals 通知 QML 刷新,避免 QML 轮询。
- */
- class PermissionBridge : public QObject
- {
- Q_OBJECT
- // 权限状态列表:每项含 group/name/special/autoClickSupport/granted
- Q_PROPERTY(QVariantList permissionList READ permissionList NOTIFY permissionListChanged)
- // 缺失的运行时权限数量(0 表示全部就绪)
- Q_PROPERTY(int missingCount READ missingCount NOTIFY permissionListChanged)
- // 无障碍服务是否已开启(决定特殊权限能否自动点击)
- Q_PROPERTY(bool accessibilityEnabled READ accessibilityEnabled NOTIFY accessibilityEnabledChanged)
- // 最近一次操作的中文结果提示,供 QML 顶部横幅显示
- Q_PROPERTY(QString lastMessage READ lastMessage NOTIFY lastMessageChanged)
- public:
- explicit PermissionBridge(QObject *parent = nullptr);
- ~PermissionBridge() override;
- QVariantList permissionList() const { return m_list; }
- int missingCount() const;
- bool accessibilityEnabled() const;
- QString lastMessage() const { return m_lastMessage; }
- public slots:
- /** 重新检测全部权限(只读,不触发任何弹窗) */
- Q_INVOKABLE void checkAll();
- /**
- * 申请某项权限。
- * 运行时权限 -> 系统弹窗;
- * 特殊权限 -> 若无障碍已开启则尝试自动点击,否则跳系统设置页。
- */
- Q_INVOKABLE void request(const QString &group);
- /** 一键补齐所有缺失权限:先批量申请运行时权限,特殊权限逐个处理 */
- Q_INVOKABLE void requestAll();
- /** 打开某项权限的系统设置页(手动路径,作为自动点击失败时的兜底) */
- Q_INVOKABLE void openSettings(const QString &group);
- /** 打开无障碍服务设置页 */
- Q_INVOKABLE void openAccessibilitySettings();
- /** 清除结果提示 */
- Q_INVOKABLE void clearMessage();
- signals:
- void permissionListChanged();
- void accessibilityEnabledChanged();
- void lastMessageChanged();
- /** 申请运行时权限后系统弹窗返回时触发,granted=true 表示全部已允许 */
- void runtimePermissionResult(bool granted);
- private:
- QVariantList m_list;
- QString m_lastMessage;
- QTimer *m_refreshTimer = nullptr;
- // ---- Android JNI ----
- void checkAllAndroid();
- void requestAndroid(const QString &group);
- void requestAllAndroid();
- void openSettingsAndroid(const QString &group);
- bool accessibilityEnabledAndroid() const;
- static QVariantList buildFallbackList();
- signals:
- void needRefresh();
- };
- #endif // PERMISSIONBRIDGE_H
|