设置模块总览 - Overview
本分类做什么
全局级 插件配置:版本、路径、机器码、字符串编码、大块 GetConfig/SetConfig 与 SetConfigByKey 键值。多数 绑定模式、截图后端、键鼠、数据库路径 等均通过此处或 SetConfigByKey 配置,是本仓库中 影响面最大 的分类之一。
一、信息与只读
| 接口 | 差异 |
|---|---|
| Ver | 插件 版本号 字符串。 |
| GetBasePath | 插件 安装/加载根路径。 |
| GetMachineCode | 机器码(常与 授权 绑定)。 |
二、路径
| 接口 | 差异 |
|---|---|
| GetPath、SetPath | 全局工作路径;与 文件 读写配合。 |
三、编码
| 接口 | 影响范围 |
|---|---|
| SetDefaultEncode | 字符串参数/返回 的默认编码(GBK/UTF-8/Unicode 等,见详情页)。 |
与 Config相关:后者管 库内 KV;本处管 整插件字符串约定。
四、GetConfig / SetConfig(大块配置)
| 接口 | 差异 |
|---|---|
| GetConfig | 读取 整段 配置(常为 JSON/INI 结构,见详情页)。 |
| SetConfig | 写回 整段。 |
适用:一次改 多个相关键(如绑定+截图+键鼠一组)。
五、SetConfigByKey(单键)
| 接口 | 差异 |
|---|---|
| SetConfigByKey | 单个 key 修改;部分键 无需创建 OLA 对象 即可调用(见详情页与更新日志)。 |
与 SetConfig 差异:热改一项、脚本更短;不必 读-改-写整文件。
六、与其它模块
| 模块 | 典型键 |
|---|---|
| 窗口/绑定 | 绑定模式、截图模式 |
| 图像识别 | 匹配阈值、弹窗开关 |
| 数据库 | DbPath、默认库 |
七、快速选型
| 需求 | 建议 |
|---|---|
| 改一项后台键鼠参数 | SetConfigByKey |
| 迁移整机配置 | GetConfig → 编辑 → SetConfig |
| 乱码 | SetDefaultEncode + 文档中的 ReturnEncoding 相关键 |
八、注意
- 键名 随版本扩展;以 官方配置文档/更新说明 为准。
- SetConfig 覆盖错误可导致 无法绑定,先 备份。
