雷电模拟器操作模块

kyjidan · 发表于 4 小时前

一、模块简介
本模块把雷电模拟器9 自带的 ldconsole.exe 命令行接口封装为火山视窗全中文方法，提供实例管理、应用管理、ADB 控制、截图、点击输入等能力，用于开发多开群控、自动化测试等工具。
重要说明：经实测，雷电9（v9.5.29）安装目录中不存在 ldconsole.dll， ldconsole.exe 本身也不导出任何函数（无法 LoadLibrary 调用）。因此本模块采用 "进程 + 管道"方式调用 ldconsole.exe——这也是雷电官方提供的唯一自动化接口。对使用者来说封装后都是中文方法调用，没有区别。
二、文件清单
text
雷电模拟器操作模块\
├── 雷电操作.wsv 模块源码（唯一必需文件）
├── 雷电操作.vgrp 模块定义文件（按模块方式安装时需要）
├── 使用说明.md 本文件
└── 示例工程\
├── 雷电操作示例.vsln 解决方案（编译入口）
└── 雷电操作示例\
├── 雷电操作示例.vprj 项目文件
└── 主程序.wsv 示例窗口程序
三、安装方法（二选一）
方式A（推荐，模块化）：
把雷电操作整个文件夹（含雷电操作.wsv 和雷电操作.vgrp）复制到火山安装目录的 plugins\vprj_win\classlib\user\ 下；
在火山 IDE 中：项目"模块"处右键 → 添加模块 → 选择雷电操作.vgrp。
方式B（最简单）：直接把雷电操作.wsv 复制到你的项目源码目录，并在项目文件列表中加入该文件即可（无需 .vgrp）。
依赖：仅"视窗基本类"（任何项目默认都有）。界面示例另需 MFC 或 WTL 界面基本类。 Win32 / x64 均可编译，无第三方 DLL。
四、方法速查
基础核心
方法说明
自动定位安装目录() 自动从注册表/常见位置定位 ldconsole.exe，返回完整路径
执行控制命令(命令参数, 是否等待, 输出内容) 执行任意 ldconsole 命令（本模块所有功能的基础，也是扩展命令的入口）
运行进程(完整命令行, 输出字节集, 是否等待) 通用"运行程序并取输出"（可复用于其它控制台程序）
实例管理
取实例列表() / 取实例数量() / 取实例标题(序号) / 取实例信息(序号, 信息) / 是否运行中(序号) / 启动实例(序号, 是否等待) / 重启实例 / 关闭实例 / 关闭全部实例() / 复制实例(源序号, 新标题) / 删除实例(序号) / 重命名实例 / 修改实例配置(序号, 配置项, 配置值) / 限制CPU占用(序号, 百分比) / 排列模拟器窗口()
修改实例配置常用配置项： resolution = "1280,720,240"、cpu = 1~4、memory = 256~8192、 imei/imsi/simserial/androidid/mac = auto 或指定值、pnumber、manufacturer、 model、root = 0/1、autorotate = 0/1、lockwindow = 0/1
应用管理
安装应用(序号, APK路径) / 卸载应用(序号, 包名) / 运行应用(序号, 包名) / 停止应用(序号, 包名) / 备份应用 / 恢复应用
ADB 控制与输入
方法对应 adb 命令
执行ADB命令(序号, 命令, 输出) 任意 ADB 命令（万能入口）
截图(序号, 保存路径) screencap + pull，存为 PNG
点击坐标(序号, x, y) input tap
滑动屏幕(序号, x1, y1, x2, y2, 毫秒) input swipe
输入文本(序号, 文本) input text（仅 ASCII，中文见下文常见问题）
模拟按键(序号, 键码) input keyevent（3=HOME 4=返回 26=电源…）
上传文件(序号, 本地, 手机) / 下载文件(序号, 手机, 本地) push / pull
<font color="#ff0000">五、多线程用法（群控核心）</font>
每条命令都是独立进程，不同线程操作不同实例互不干扰，直接并行即可：
volcano
变量工作线程 <类型 = 线程类> // 每个实例一个线程，或用线程池
方法线程类_线程运行 <接收事件类型 = 整数>
参数来源对象 <类型 = 线程类>
参数标记值 <类型 = 整数>
{
// 本线程专职控制实例1（其它线程控制0、2、3...）
循环判断首 ()
{
雷电操作类.点击坐标 (1, 400, 300)
雷电操作类.输入文本 (1, "hello")
如果 (雷电操作类.截图 (1, "D:\\snap\\vm1.png"))
{
// 配合 CV图像AI库做模板匹配找图后点击
}
}
循环判断尾 (来源对象.是否需要退出 (200) == 假)
}
注意事项：
窗口控件更新回到主线程（参考官方"多线程"示例：线程里更新控件属性后调刷新显示()）；
多线程写同一文件（如日志、截图文件名）需要区分名字或加互斥锁；
启动实例等待完成模式会阻塞到模拟器完全启动，批量启动请放线程或用异步模式；
运行进程等待模式无超时上限，正常 ldconsole 命令秒级返回，勿对可能挂死的程序使用。
六、找图点击的推荐组合
text
截图(序号, "D:\\snap\\vm0.png")
→ CV图像AI库: CV矩阵类读入图片 → 模板匹配找小图位置
→ 得到坐标 → 点击坐标(序号, x, y)
七、常见问题
Q: 提示找不到 ldconsole.exe？设置雷电操作类.控制程序路径 = "D:\\你的目录\\LDPlayer9\\ldconsole.exe"（放启动方法最前面），或确认模块自动定位：注册表 HKCU\SOFTWARE\leidian\LDPlayer9\InstallDir。
Q: 输入文本不支持中文？ Android 的 input text 不支持中文。方案一：模拟器内装 ADBKeyboard 输入法后用执行ADB命令发广播；方案二：用模拟按键 + 剪贴板。ASCII 字符可直接用输入文本。
Q: 想备份/恢复整个模拟器（不只是应用）？用万能入口：执行控制命令 ("backup --index 0 --file "D:\\bak.lds"", 真, 输出)，恢复用 restore。
Q: 想用实例标题而不是序号？用取实例列表() 原始文本自行匹配标题列，或继续用序号（群控场景推荐序号）。
八、依赖与验证状态声明（重要）
依赖声明：本模块为零第三方依赖——只使用火山官方"视窗基本类"（多字节到文本、取文本注册项2、文本到整数、字节集类、文本数组类等）与 Windows 系统自带 API （CreateProcessW、匿名管道、注册表）。不包含任何第三方模块的代码或调用， Win32 / x64 通用，无需额外 DLL。
✅ 已实测验证：ldconsole v9.5.29 全部 44 个命令表（来自本机帮助输出）、 list2/isrunning 输出格式、输出为 GBK 编码、list2 字段含义（未运行状态实例）。
✅ 纯官方实现：核心方法"运行进程"由标准 Win32 控制台捕获流程（创建管道→隐藏窗口启动进程→循环读取输出→取退出码）自行编写；火山侧全部使用官方基础类方法（签名均经视窗基本类源码核对）。
⚠️ 未编译验证：本模块未在本机 VolDev 中编译（未检测到安装）。首次编译如有报错，把编译器报错原样发回即可快速修正。
⚠️ list2 运行中实例的字段（字段5为进程ID）基于未运行状态推断，启动一个实例后调取实例列表() 即可核对；运行状态精确判断以是否运行中() 方法为准。

复制代码

雷电模拟器操作模块.rar (13.84 KB, 下载次数: 3)

fengyishen · 发表于半小时前

感谢分享，体力活吖，一直想封装来着，太多命令了，一直没动

		自动登录	找回密码
密码			立即注册

[AI开发] 雷电模拟器操作模块