| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224 |
- #ifndef WIF_SERVICE_H
- #define WIF_SERVICE_H
- #include <QObject>
- #include <QString>
- #include <QJsonObject>
- #include <QJsonDocument>
- /**
- * 集成网飞 (WIF) 系统基础服务 AIDL 的 C++ 包装.
- *
- * 调用 {@link #bind} 在 Activity 上下文上绑定服务, 之后可通过
- * {@link #request} 发起一次异步调用; 响应会通过 {@link responseReceived} 信号返回.
- *
- * 该类在 Android 以外的平台为空操作, 所有方法可安全调用, 信号永远不会触发.
- */
- class WifService : public QObject
- {
- Q_OBJECT
- public:
- explicit WifService(QObject *parent = nullptr);
- ~WifService() override;
- /** 绑定 AIDL 服务. 多次调用安全, 只生效一次. */
- void bind();
- /** 解绑. */
- void unbind();
- /**
- * 发起一次请求.
- *
- * @param type 对应 AidlConstants.TYPE_*, 例如 "location" / "reboot" / "device_info".
- * @param param 可选, 请求 param 字段, 序列化为 JSON 对象. 传空对象表示无 param.
- * @return 0 表示提交成功, -1 表示服务未就绪.
- */
- Q_INVOKABLE int request(const QString &type, const QJsonObject ¶m = QJsonObject());
- /** QML 友好的 request 重载, param 使用 QVariantMap, 会自动转为 JSON 对象. */
- Q_INVOKABLE int requestMap(const QString &type, const QVariantMap ¶m = QVariantMap());
- /**
- * 发起一次请求 (高级). 用于直接控制完整 JSON 负载的场景.
- *
- * @param json 形如 {"param":{...},"type":"xxx"} 的完整请求 JSON.
- */
- Q_INVOKABLE int requestRaw(const QString &json);
- /** 便捷封装: reboot (无 param). */
- Q_INVOKABLE int reboot();
- /** 便捷封装: 获取位置信息. */
- Q_INVOKABLE int requestLocation();
- /** 便捷封装: 获取设备信息 (SN / cpu_serial / ethernet_mac). */
- Q_INVOKABLE int requestDeviceInfo();
- /** 便捷封装: 设置系统时间. timeMs 为 epoch millis. */
- Q_INVOKABLE int setTime(qint64 timeMs);
- /** 便捷封装: 设置热点开关 / 配置. */
- Q_INVOKABLE int setHotspot(const QString &ssid, const QString &password);
- /** 便捷封装: 设置 WiFi. */
- Q_INVOKABLE int setWifi(const QString &ssid, const QString &password,
- bool isStatic = false,
- const QString &ip = QString(),
- const QString &dns1 = QString(),
- const QString &dns2 = QString());
- /** 便捷封装: 设置以太网. */
- Q_INVOKABLE int setEthernet(const QString &ip, const QString &netmask,
- const QString &gateway,
- const QString &dns1, const QString &dns2);
- /** 便捷封装: 切换以太网接口开关. */
- Q_INVOKABLE int setEthernetEnable(const QString &iface, bool enable);
- /** 便捷封装: 状态栏显示/隐藏. visible=true 显示, false 隐藏. */
- Q_INVOKABLE int setStatusBarVisible(bool visible);
- /** 便捷封装: 设置屏幕亮度 (0..255). */
- Q_INVOKABLE int setBrightness(int brightness);
- /** 便捷封装: 设置音量 (0..100). */
- Q_INVOKABLE int setVolume(int volume);
- /** 便捷封装: 开关定位. */
- Q_INVOKABLE int setLocationEnable(bool enable);
- /** 便捷封装: 启动桌面 (返回 launcher). */
- Q_INVOKABLE int startHome();
- /** 便捷封装: 恢复出厂设置. */
- Q_INVOKABLE int factoryReset();
- /** 便捷封装: 安装应用. apkPath 完整路径. */
- Q_INVOKABLE int install(const QString &apkPath, bool autoStart = false);
- /** 便捷封装: 卸载应用. */
- Q_INVOKABLE int uninstall(const QString &packageName);
- /** 便捷封装: 启动应用. */
- Q_INVOKABLE int startApp(const QString &packageName);
- /** 便捷封装: 锁定 / 解锁某项功能. */
- Q_INVOKABLE int setFunctionLock(const QString &function, const QString &password);
- /** 便捷封装: 设置锁屏方式. */
- Q_INVOKABLE int setScreenLock(const QString &newLockType, const QString &newLock,
- const QString ¤tLockType = QString(),
- const QString ¤tLock = QString());
- /** 便捷封装: 添加桌面 widget. */
- Q_INVOKABLE int addAppWidget(const QString &packageName, const QString &className,
- int screen, int cellX, int cellY, int spanX, int spanY);
- /** 便捷封装: 配置安装白名单. */
- Q_INVOKABLE int configInstallWhitelist(const QString &action, const QString &packageName);
- /** 便捷封装: 自启动 Launcher. */
- Q_INVOKABLE int setCustomLauncher(const QString &packageName);
- /** 便捷封装: 重启 4G 模组. */
- Q_INVOKABLE int rebootModem();
- /** 便捷封装: 自定义开机动画, filePath 完整路径. */
- Q_INVOKABLE int setCustomBootAnimation(const QString &filePath);
- /** 便捷封装: 自动校时开关. */
- Q_INVOKABLE int setAutoTime(bool enable);
- /** 便捷封装: 风扇控制. level: 0..N. */
- Q_INVOKABLE int setFanControl(int level);
- /** 便捷封装: 清除应用数据. */
- Q_INVOKABLE int clearAppStorage(const QString &packageName);
- /** 便捷封装: Kiosk (自助模式) 开关. */
- Q_INVOKABLE int setKioskMode(bool enable);
- /** 便捷封装: OTA 更新, filePath 完整路径. */
- Q_INVOKABLE int otaUpdate(const QString &filePath);
- /** 服务是否已连接 (仅 Android 有效). */
- Q_PROPERTY(bool connected READ isConnected NOTIFY connectedChanged)
- bool isConnected() const;
- /** 由 JNI 回调设置连接状态. */
- void setConnected(bool connected);
- /** 便捷封装: 重命名包别名. */
- Q_INVOKABLE int setAlias(const QString &packageName, const QString &alias);
- /** AidlConstants 对应常量 (与 Java 端 com.wif.bslib.AidlConstants 一致). */
- static QString ACTION_BASE_SERVICE() { return QStringLiteral("com.wif.aidl.baseservice"); }
- static QString PACKAGE_BASE_SERVICE() { return QStringLiteral("com.wif.baseservice"); }
- static QString TYPE_REBOOT() { return QStringLiteral("reboot"); }
- static QString TYPE_STATUS_BAR() { return QStringLiteral("status_bar"); }
- static QString TYPE_HOTSPOT() { return QStringLiteral("hotspot"); }
- static QString TYPE_HOTSPOT_CONFIG() { return QStringLiteral("hotspot_config"); }
- static QString TYPE_WIFI() { return QStringLiteral("wifi"); }
- static QString TYPE_VOLUME() { return QStringLiteral("volume"); }
- static QString TYPE_BRIGHTNESS() { return QStringLiteral("brightness"); }
- static QString TYPE_FACTORY_RESET() { return QStringLiteral("factory_reset"); }
- static QString TYPE_INSTALL() { return QStringLiteral("install"); }
- static QString TYPE_INSTALL_AND_START() { return QStringLiteral("install_and_start"); }
- static QString TYPE_UNINSTALL() { return QStringLiteral("uninstall"); }
- static QString TYPE_ALIAS() { return QStringLiteral("alias"); }
- static QString TYPE_WIFI_CONFIG() { return QStringLiteral("wifi_config"); }
- static QString TYPE_ETHERNET_CONFIG() { return QStringLiteral("ethernet_config"); }
- static QString TYPE_ETHERNET_ENABLE() { return QStringLiteral("ethernet_enable"); }
- static QString TYPE_LOCATION() { return QStringLiteral("location"); }
- static QString TYPE_SET_TIME() { return QStringLiteral("set_time"); }
- static QString TYPE_AUTO_TIME() { return QStringLiteral("auto_time"); }
- static QString TYPE_FAN_CONTROL() { return QStringLiteral("fan_control"); }
- static QString TYPE_START_HOME() { return QStringLiteral("start_home"); }
- static QString TYPE_REBOOT_MODEM() { return QStringLiteral("reboot_modem"); }
- static QString TYPE_CUSTOM_LAUNCHER() { return QStringLiteral("custom_launcher"); }
- static QString TYPE_DEVICE_INFO() { return QStringLiteral("device_info"); }
- static QString TYPE_CLEAR_SCREEN_LOCK() { return QStringLiteral("clear_screen_lock"); }
- static QString TYPE_SET_SCREEN_LOCK() { return QStringLiteral("set_screen_lock"); }
- static QString TYPE_CLEAR_APP_STORAGE() { return QStringLiteral("clear_app_storage"); }
- static QString TYPE_CONFIG_INSTALL_WHITELIST() { return QStringLiteral("config_install_whitelist"); }
- static QString TYPE_LOCATION_ENABLE() { return QStringLiteral("location_enable"); }
- static QString TYPE_ADD_APP_WIDGET() { return QStringLiteral("add_app_widget"); }
- static QString TYPE_CUSTOM_BOOT_ANIMATION() { return QStringLiteral("custom_boot_animation"); }
- static QString TYPE_OTA_UPDATE() { return QStringLiteral("ota_update"); }
- static QString TYPE_FUNCTION_LOCK() { return QStringLiteral("function_lock"); }
- static QString TYPE_KIOSK_MODE() { return QStringLiteral("kiosk_mode"); }
- /** 响应 code. */
- static int SUCCESS() { return 1; }
- static int FAIL() { return 0; }
- static int PARAM_ERROR() { return -1; }
- signals:
- /**
- * 服务连接状态变化.
- * @param connected true=已连接, false=已断开.
- */
- void connectedChanged(bool connected);
- /**
- * 服务回调响应.
- * @param type 对应请求的 type.
- * @param code 1 成功 / 0 失败 / -1 参数错误.
- * @param msg 失败时的提示消息, 可能为空.
- * @param json 完整响应 JSON 字符串, 业务层 data 字段以 JSON 形式承载.
- */
- void responseReceived(const QString &type, int code, const QString &msg, const QString &json);
- private slots:
- void onResponseFromJni(const QString &type, int code,
- const QString &msg, const QString &json);
- private:
- class Private;
- Private *d;
- Q_DISABLE_COPY(WifService)
- };
- #endif // WIF_SERVICE_H
|