OLA 文档中心

主题

2026-06-18

修改用户自定义设置 - SetConfig ​

函数简介 ​

通过JSON字符串批量修改用户自定义设置。键名大小写不敏感；布尔/数值支持字符串（如 "True"、"1"）。详见 JSON配置解析约定。

接口名称 ​

SetConfig

DLL调用 ​

int SetConfig(long ola, string configStr);

参数说明 ​

参数名类型说明
ola长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
configStr字符串配置项JSON字符串，格式为{"key":value,...}。

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
ola.SetConfig("db", "data/app.db");
csharp
using OLAPlug;

var ola = new OLAPlugServer();
ola.SetConfig("db", "data/app.db");
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
ola.SetConfig("db", "data/app.db")
java
import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
ola.SetConfig("db", "data/app.db");
cpp
var ola = com("OlaPlug.OlaSoft")
ola.SetConfig("db", "data/app.db");
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
ola.SetConfig("db", "data/app.db");
text
.局部变量 ola, OLAPlug
ola.创建 ()
ola.SetConfig("db", "data/app.db")
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
ola.SetConfig("db", "data/app.db");
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
ola.SetConfig("db", "data/app.db");
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
ola.SetConfig("db", "data/app.db");

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
SetConfig(instance, "db", "data/app.db");
csharp
long instance = CreateCOLAPlugInterFace();
SetConfig(instance, "db", "data/app.db");
python
from ctypes import CDLL, c_int, c_int64, create_string_buffer

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
SetConfig(instance, "db", "data/app.db")

返回值 ​

返回值说明
1成功。
0失败。

可用配置项 ​

编码与键鼠仿真（全局） ​

配置项类型默认值说明
DefaultEncoding整数型0接口入参默认编码：0=GBK，1=UTF-8，2=Unicode
DefaultReturnEncoding整数型1接口返回值默认编码：0=GBK，1=UTF-8，2=Unicode
SimModeType整数型0键鼠仿真模式：0=标准，1=Logitech 驱动，2=LogitechGHubNew，3=Razer，4=欧拉驱动(内置欧拉驱动会自动加载，无需手动 LoadDriver。自签名驱动需先 ImportDriverFromFile 或 ImportDriver。)
OLAMouseDeviceMode整数型0欧拉驱动鼠标模式 0~10；部分模式可能蓝屏，建议从 0 起试 (要先设置SimModeType为4欧拉驱动)
OLAKeypadDeviceMode整数型0欧拉驱动键盘模式 0~10；部分模式可能蓝屏，建议从 0 起试 (要先设置SimModeType为4欧拉驱动)
UseAbsoluteMovebool型true驱动鼠标是否使用绝对移动

真实鼠标轨迹（实例级） ​

配置项类型默认值说明
EnableRealMousebool型true是否启用真实鼠标轨迹；MoveTo / MoveToEx 是否走拟人轨迹也受此开关控制
RealMouseMode整数型6轨迹风格：1=标准用户，2=游戏玩家，3=非光学鼠标(慢)，4=平衡，5=机器人(直线)，6=自定义
MinMouseTrajectory整数型50最小轨迹距离（像素）；小于该值直接定位，不走轨迹
RealMouseBaseTimePer100Pixels整数型100每 100 像素的基础移动时间（毫秒）
RealMouseFlowFlag整数型161速度曲线组合位标志（1/2/4/8/16/32/64/128/256/512 可组合）
RealMouseNoise双精度浮点数5.0噪声，影响轨迹随机性
RealMouseDeviation整数型5偏差，影响路径曲率
RealMouseMinSteps整数型300最小步数
RealMouseTimeToSteps双精度浮点数2.5步间时间间隔系数
RealMouseOvershoots整数型0过冲点数
MouseDriftCheckTime整数型0鼠标漂移检测间隔（毫秒）；0=不检测
MousePosCallbackMinOffset整数型0MoveTo 终点矫正阈值（像素）；|offsetX| 与 |offsetY| 均小于该值时不矫正；0=不限制。配合 SetWindowCursor 或 SetMousePosCallback

键盘鼠标间隔与输入锁定（实例级） ​

配置项类型默认值说明
EnableRealKeypadbool型false是否启用真实键盘输入延时
KeyDownInterval整数型50键盘单击间隔（毫秒）
MouseClickInterval整数型50鼠标单击间隔（毫秒）
MouseDoubleClickInterval整数型200鼠标双击间隔（毫秒）
InputLockbool型false输入锁定；与 LockInput 行为一致
KeyboardHwnd长整数型0键盘消息目标窗口句柄
MouseHwnd长整数型0鼠标消息目标窗口句柄
CheckDisplayDeadInterval整数型50检测画面卡死间隔（毫秒）；0=不检测
SnapPrefetchInterval整数型33后台截图预取间隔（毫秒）；0=关闭 L1 缓存与预取 Worker
DxCaptureMaxFps整数型60DX hook 截图帧率上限（fps），供目标进程内节流；0=不限制。该值在DX 绑定/初始化时时生效；若运行中修改配置，需重新绑定窗口后才会应用到目标进程内的捕获节流

VNC 连接（实例级） ​

配置项类型默认值说明
VncServer字符串127.0.0.1VNC 服务器地址
VncPort整数型5900VNC 端口
VncPassword字符串（空）VNC 密码
|

路径、数据库与图像（全局） ​

配置项类型默认值说明
WorkPath字符串（空）工作路径
DbPath字符串（空）SQLite 数据库路径
DbPassword字符串（空）SQLite 数据库密码
DriverPath字符串（空）自定义驱动路径
SymbolServer字符串（空）符号服务器，如 https://msdl.microsoft.com
SharedMemoryNamePrefix字符串TSVN_共享内存/沙盒 IPC 前缀；绑定沙盒时与 OpenIpcPath 配合
JpegQuality整数型100JPG 压缩质量 0~100
MaxOverlap双精度浮点数0.5多图返回最大重叠度；0=完全不重叠
MatchColorWeight双精度浮点数0.7彩色找图颜色权重 0~1.0
ImageStitchMatchValue双精度浮点数0图片拼接匹配阈值 0~1
MultiTemplateAbortOnInvalidImagebool型true多模板路径 | 分隔时，某一图加载失败：true=整次失败，false=跳过无效图
MultiColorSimMode整数型0多点找色 sim：0=颜色相似度，1=允许部分点不匹配
EnableOcrOverlapCountingbool型falseOCR 是否允许重叠词同时返回

YOLO（全局） ​

配置项类型默认值说明
YoloRegionSortMode整数型0检测类任务 Regions 排序：0=置信度降序，1=同分比 x，2=同分比 y 再 x，3=从左到右，4=从上到下。仅对未单独设置 RegionSortMode 的模型生效
YoloAutoWarmupbool型true模型加载成功后是否自动预热，避免首次正式检测耗时过长
YoloAutoWarmupIterations整数型2自动预热推理次数，有效范围 0~100；0=跳过预热。每次使用 640×640 合成图做真实推理，用于触发 CUDA/TensorRT/ONNX 等首次初始化

OCR（全局） ​

配置项类型默认值说明
OcrAutoWarmupbool型trueOcrLoadModel / OcrLoadModelMemory / 内置模型加载成功后是否自动预热
OcrAutoWarmupIterations整数型2自动预热推理次数，0~100；0=跳过。加载阶段跑真实 det/rec 预热，避免首次正式识别耗时过长

窗口、虚拟机与绑定模式（全局） ​

配置项类型默认值说明
FindWindowMode整数型0找窗口：0=仅可见，1=全部，2=不可见
VMwareVersion整数型-1VMware 版本；-1=读注册表自动判断，支持 10/16/17/18/19
RemoteServerExeName字符串RemoteServer.exeSHM 远程模式下自动发现 B 端进程的 exe 名
BindModeMouseALL字符串（空）绑定模式鼠标方式全量列表（| 分隔）
BindModeKeypadALL字符串（空）绑定模式键盘方式全量列表
BindModePubALL字符串（空）绑定模式公共方式全量列表
BindModeMouseDefault字符串（空）常用绑定模式鼠标方式
BindModeKeypadDefault字符串（空）常用绑定模式键盘方式

配置示例 ​

json
{
  "EnableRealMouse": true,
  "RealMouseMode": 2,
  "YoloAutoWarmup": true,
  "YoloAutoWarmupIterations": 2,
  "OcrAutoWarmup": true,
  "OcrAutoWarmupIterations": 2,
  "SnapPrefetchInterval": 33,
  "DxCaptureMaxFps": 60,
  "DefaultReturnEncoding": 1
}

相关接口 ​