#ifndef PERMISSIONBRIDGE_H #define PERMISSIONBRIDGE_H #include #include #include #include #include /** * 权限桥接:把 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