菜单

【雷电模拟器】ldconsole命令行开发者使用说明（更新于26-08-31）

本说明面向开发者，介绍如何通过 ldconsole 命令行接口操控 LDPlayer 模拟器：查询状态、创建/复制/删除/重命名多开、备份恢复、启动关闭、应用管理、设备动作、脚本调用及 ADB 接入。

前置约定

  • 适用工具：ldconsole.exe，模拟器安装目录下，例如 E:\leidian\LDPlayer14\ldconsole.exe
  • 模拟器：雷电模拟器
  • 通用语法：ldconsole <command> [parameter]
  • 指定实例：每个命令均可用 --index <索引> 或 --name <名称> 二选一（部分全局命令如 globalsetting 无需指定）
  • 路径注意：ldconsole 为原生 Windows 程序，--file / --local 等路径参数请使用 Windows 反斜杠（如 C:\Users\...），正斜杠可能被误解析
  • 多实例端口公式：ADB 端口 = 5555 + index × 2（index 0 → 5555）
  • 基准版本：支持雷电14和雷电9版本。如果过程中遇到问题，可以试试升级到最新版本。
    雷电9最新版本一一点击下载
    雷电14最新版本一一点击下载

一、获取模拟器信息

查询模拟器列表、运行状态与详细参数。LDPlayer 提供多个粒度不同的列表命令。

命令 说明 返回
list 列出全部模拟器名称 每行一个实例名
list2 列出全部实例详细信息 索引, 标题, 顶层句柄, 绑定句柄, 运行状态(0/1), 进程PID, VBox PID, 宽, 高, DPI
list3 --index <idx> 列出单实例精简信息 索引, 名, 状态, 宽, 高, DPI
runninglist 仅列出正在运行的实例 运行中的实例列表
isrunning --index <idx> 查询某实例是否运行中 运行状态

⚠️ 注意：list3 不带有效 --index（如误写成 --index0 连写）会回退输出哨兵条目 99999,电脑桌面,...，该条目代表物理电脑桌面而非真实实例。查全部实例请用 list 或 list2。

举例

bash 复制代码 
ldconsole.exe list
ldconsole.exe list2
ldconsole.exe list3 --index 0
ldconsole.exe runninglist
ldconsole.exe isrunning --index 6

💡 提示：查询 ADB 连接状态可用系统命令 adb devices（LDPlayer 默认自动注册，详见第十节）。

二、创建模拟器

新建一个模拟器实例，系统自动分配索引。

使用

bash 复制代码 
ldconsole.exe add [--name <名称>]
参数 说明
--name <名称> 可选，指定新实例名称；省略则自动命名

举例

bash 复制代码 
ldconsole.exe add
ldconsole.exe add --name 测试机A

三、复制模拟器

基于已有实例克隆出新实例（多开）。

使用

bash 复制代码 
ldconsole.exe copy [--name <新名称>] --from <源名称 | 源索引>
参数 说明
--name <新名称> 新实例名称
--from <名称或索引> 被复制的源实例

举例

bash 复制代码 
ldconsole.exe copy --name 新分身 --from 0
ldconsole.exe copy --name 新分身 --from LDPlayer

四、删除模拟器

删除指定模拟器实例。

使用

bash 复制代码 
ldconsole.exe remove --name <名称>
ldconsole.exe remove --index <索引>

举例

bash 复制代码 
ldconsole.exe remove --index 2
ldconsole.exe remove --name 测试机A

⚠️ 不可逆：删除会清除该实例的所有数据与配置，操作前请确认已备份。

五、重命名模拟器

修改模拟器显示名称。

使用

bash 复制代码 
ldconsole.exe rename [--name <名称> | --index <索引>] --title <新标题>
参数 说明
--title <新标题> 新的显示名称

举例

bash 复制代码 
ldconsole.exe rename --index 0 --title 我的主力机
ldconsole.exe rename --name LDPlayer --title 我的主力机

六、备份模拟器

将指定实例整机备份为镜像文件，便于迁移或存档。

使用

bash 复制代码 
ldconsole.exe backup [--name <名称> | --index <索引>] --file <备份文件路径>
参数 说明
--file <路径> 输出备份路径，后缀必须为 .ldbk ，否则报错

举例

bash 复制代码 
ldconsole.exe backup --index 0 --file "D:\backup\LDPlayer.ldbk"

⚠️ 注意：backup 备份的是整机镜像（含系统与数据），备份大实例会耗时较长。

七、导入模拟器（恢复备份）

将此前 backup 生成的备份文件（.ldbk）恢复到指定实例。

使用

bash 复制代码 
ldconsole.exe restore [--name <名称> | --index <索引>] --file <备份文件路径>
参数 说明
--file <路径> 备份文件路径，须为 .ldbk 后缀

举例

bash 复制代码 
ldconsole.exe restore --index 0 --file "D:\backup\LDPlayer.ldbk"

八、控制模拟器

对模拟器生命周期、窗口、应用、设备与脚本进行综合控制。

1. 启动模拟器（launch）

bash 复制代码 
ldconsole.exe launch [--name <名称> | --index <索引>]
ldconsole.exe launch --index 0

2. 关闭模拟器（quit）

bash 复制代码 
ldconsole.exe quit [--name <名称> | --index <索引>]
ldconsole.exe quitall          # 关闭全部实例

3. 重启模拟器（reboot）

bash 复制代码 
ldconsole.exe reboot [--name <名称> | --index <索引>]

4. 窗口控制

命令 说明
locate --name/--index --LLI <经度,纬度> 设置模拟器 GPS 定位（如 --LLI 116.39,39.91）
sortWnd 将所有模拟器窗口自动排列（平铺）
bash 复制代码 
ldconsole.exe locate --index 0 --LL 116.39,39.91
ldconsole.exe sortWnd

5. 限制 CPU（downcpu）

💡 说明： 功能暂不可用，需等后续更新。

6. 应用控制

命令 参数 说明
installapp --filename <apk路径> 或 --packagename <包名> 安装应用
uninstallapp --packagename <包名> 卸载应用
runapp --packagename <包名> 启动应用
killapp --packagename <包名> 关闭应用
launchex --packagename <包名> 启动模拟器并直达指定应用
bash 复制代码 
ldconsole.exe installapp --index 0 --filename "D:\apps\game.apk"
ldconsole.exe uninstallapp --index 0 --packagename com.miHoYo.Yuanshen
ldconsole.exe runapp --index 0 --packagename com.miHoYo.Yuanshen
ldconsole.exe killapp --index 0 --packagename com.miHoYo.Yuanshen
ldconsole.exe launchex --index 0 --packagename com.miHoYo.Yuanshen

💡 说明：launchex = 启动模拟器 + 启动 App 一步完成。

7. 设备动作（action）

向模拟器注入系统级设备事件。

--key --value 功能
call.keyboard back / home / menu / volumeup / volumedown 注入系统虚拟按键（每次一个键，勿用 | 拼接）
call.input 文本字符串 向当前聚焦输入框注入文本
rock （无） 触发摇一摇
call.locate 经度,纬度 实时定位注入
call.network offline / connect 断网 / 恢复网络
call.gravity 传感器参数 重力/陀螺仪注入
bash 复制代码 
ldconsole.exe action --index 0 --key call.keyboard --value home
ldconsole.exe action --index 0 --key call.input --value "搜索内容"
ldconsole.exe rock --index 0
ldconsole.exe locate --index 0 --LLI 113.264,23.129
ldconsole.exe action --index 0 --key call.network --value offline |connect
ldconsole.exe action --index 0 --key call.gravity --value x,y,z

💡 说明： menu映射暂不可用，需等后续更新。

8. 扫码（scan）

💡 说明： 功能暂不可用，需等后续更新。

9. 窗口缩放（zoomIn / zoomOut）

💡 说明： 功能暂不可用，需等后续更新。

10. 文件传输（push / pull）

💡 说明： 功能暂不可用，需等后续更新。

11. 应用数据备份（backupapp / restoreapp）

💡 说明： 功能暂不可用，需等后续更新。

12. 宏脚本（operate*）

💡 说明： 功能暂不可用，需等后续更新。

九、配置模拟器

1. 单实例配置（modify）

bash 复制代码 
ldconsole.exe modify [--name|--index] [--resolution w,h,dpi] [--cpu 1|2|3|4]
       [--memory 256|512|768|1024|1536|2048|4096|8192]
       [--manufacturer <厂商>] [--model <型号>] [--pnumber <手机号>]
       [--imei <auto|15位>] [--imsi <auto|15位>] [--simserial <auto|20位>]
       [--androidid <auto|16位十六进制>] [--mac <auto|12位>]
       [--autorotate <1|0>] [--lockwindow <1|0>] [--root <1|0>]
参数 说明
--resolution w,h,dpi 虚拟屏分辨率与 DPI，如 1080,1920,480（注意可能翻转横竖屏）
--cpu / --memory 分配 CPU 核数 / 内存(MB，限列表值)
--imei / --mac / --imsi / --androidid 设备身份；auto 表示随机重刷（多开防封常用）
--root <1或0> 开启 / 关闭 root
--autorotate / --lockwindow 自动旋转 / 锁定窗口
bash 复制代码 
ldconsole.exe modify --index 0 --resolution 1080,1920,480 --cpu 4 --memory 4096 --imei auto --mac auto --root 0

⚠️ 注意：root 0 会关闭 root；imei/mac auto 会重刷设备身份。修改后需重启实例（quit + launch）生效。

2. 全局默认配置（globalsetting）

💡 说明： 功能暂不可用，需等后续更新。

十、ADB 命令与接入

LDPlayer 既提供内置 adb 子命令，也支持直接使用系统 adb。LDPlayer 默认自动注册 ADB 连接。

因 LDPlayer 自动注册，可直接使用系统/自带 adb 操作实例，无需 ldconsole 中转：

batch 复制代码 
端口 = 5555 + index*2，index 6 → 5567
adb connect 127.0.0.1:5567
最近修改: 2026-08-31