前置說明
- 適用工具：ldconsole.exe，位於模擬器安裝目錄，例如
E:\LDPlayer\LDPlayer14\ldconsole.exe - 模擬器：雷電模擬器
- 通用語法：ldconsole [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 | 列出所有執行個體的詳細資訊 | 索引, 標題, 頂層 Handle, 綁定 Handle, 執行狀態(0/1), 行程 PID, VBox PID, 寬, 高, DPI |
| list3 --index | 列出單一執行個體的精簡資訊 | 索引, 名稱, 狀態, 寬, 高, DPI |
| runninglist | 僅列出正在執行的執行個體 | 執行中的執行個體清單 |
| isrunning --index | 查詢指定執行個體是否正在執行 | 執行狀態 |
⚠️ 注意：list3 若未帶入有效的 --index（例如誤寫成 --index0 連寫），會改為輸出特殊識別項目
99999,電腦桌面,...。此項目代表實體電腦桌面，並非真正的模擬器執行個體。若要查詢全部執行個體，請使用 list 或 list2。 範例
ldconsole.exe list
ldconsole.exe list2
ldconsole.exe list3 --index 0
ldconsole.exe runninglist
ldconsole.exe isrunning --index 6
💡 提示：若要查詢 ADB 連線狀態，可使用系統指令 adb devices（LDPlayer 預設會自動註冊，詳見第十節）。
二、建立模擬器
建立新的模擬器執行個體，系統會自動分配索引。 用法
ldconsole.exe add [--name <名稱>]
| 參數 | 說明 |
|---|---|
| --name <名稱> | 選填，指定新執行個體名稱；若省略，系統會自動命名 |
範例
ldconsole.exe add
ldconsole.exe add --name 測試機A
三、複製模擬器
以現有執行個體為基礎，複製出新的執行個體（多開）。 用法
ldconsole.exe copy [--name <新名稱>] --from <來源名稱 | 來源索引>
| 參數 | 說明 |
|---|---|
| --name <新名稱> | 新執行個體名稱 |
| --from <名稱或索引> | 要複製的來源執行個體 |
範例
ldconsole.exe copy --name 新分身 --from 0
ldconsole.exe copy --name 新分身 --from LDPlayer
四、刪除模擬器
刪除指定的模擬器執行個體。 用法
ldconsole.exe remove --name <名稱>
ldconsole.exe remove --index <索引>
範例
ldconsole.exe remove --index 2
ldconsole.exe remove --name 測試機A
⚠️ 無法復原：刪除後會清除該執行個體的所有資料與設定，操作前請先確認已完成備份。
五、重新命名模擬器
修改模擬器的顯示名稱。 用法
ldconsole.exe rename [--name <名稱> | --index <索引>] --title <新標題>
| 參數 | 說明 |
|---|---|
| --title <新標題> | 新的顯示名稱 |
範例
ldconsole.exe rename --index 0 --title 我的主力機
ldconsole.exe rename --name LDPlayer --title 我的主力機
六、備份模擬器
將指定執行個體完整備份為映像檔，方便移轉或封存。 用法
ldconsole.exe backup [--name <名稱> | --index <索引>] --file <備份檔路徑>
| 參數 | 說明 |
|---|---|
| --file <路徑> | 備份檔輸出路徑；副檔名必須為 .ldbk，否則會發生錯誤 |
範例
ldconsole.exe backup --index 0 --file "D:\backup\LDPlayer.ldbk"
⚠️ 注意：backup 會備份完整映像（包含系統與資料）；執行個體資料量較大時，備份可能需要較長時間。
七、匯入模擬器（還原備份）
將先前透過 backup 產生的備份檔（.ldbk）還原至指定執行個體。 用法
ldconsole.exe restore [--name <名稱> | --index <索引>] --file <備份檔路徑>
| 參數 | 說明 |
|---|---|
| --file <路徑> | 備份檔路徑，副檔名須為 .ldbk |
範例
ldconsole.exe restore --index 0 --file "D:\backup\LDPlayer.ldbk"
八、控制模擬器
可控制模擬器的生命週期、視窗、應用程式、裝置與腳本。
1. 啟動模擬器（launch）
ldconsole.exe launch [--name <名稱> | --index <索引>]
ldconsole.exe launch --index 0
2. 關閉模擬器（quit）
ldconsole.exe quit [--name <名稱> | --index <索引>]
ldconsole.exe quitall # 關閉所有執行個體
3. 重新啟動模擬器（reboot）
ldconsole.exe reboot [--name <名稱> | --index <索引>]
4. 視窗控制
| 指令 | 說明 |
|---|---|
| locate --name/--index --LLI <經度,緯度> | 設定模擬器的 GPS 定位（例如 --LLI 116.39,39.91） |
| sortWnd | 自動排列所有模擬器視窗（並排） |
ldconsole.exe locate --index 0 --LL 116.39,39.91
ldconsole.exe sortWnd
5. 限制 CPU（downcpu）
💡 說明：此功能目前暫不可用，請等待後續版本更新。
6. 應用程式控制
| 指令 | 參數 | 說明 |
|---|---|---|
| installapp | --filename 或 --packagename <套件名稱> | 安裝應用程式 |
| uninstallapp | --packagename <套件名稱> | 解除安裝應用程式 |
| runapp | --packagename <套件名稱> | 啟動應用程式 |
| killapp | --packagename <套件名稱> | 關閉應用程式 |
| launchex | --packagename <套件名稱> | 啟動模擬器並直接開啟指定應用程式 |
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 | 感測器參數 | 重力 / 陀螺儀資料注入 |
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）
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 | 自動旋轉 / 鎖定視窗 |
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 連線，因此可直接使用系統或內建 adb 操作執行個體，無需透過 ldconsole 轉接：
連接埠 = 5555 + index*2，index 6 → 5567
adb connect 127.0.0.1:5567