事前事項
-
対象ツール：
ldconsole.exe
LDPlayerのインストール先に配置されています。例：E:\leidian\LDPlayer14\ldconsole.exe -
対象：LDPlayer
-
基本構文：
ldconsole [parameter] -
対象インスタンスの指定：各コマンドでは、
--index<インデックス> または--name<名前> のいずれかを指定できます（一部のグローバルコマンド（globalsetting）では指定不要）。 -
パスに関する注意：
ldconsoleはネイティブ Windows プログラムです。--file/--localなどのパスを指定する場合は、Windows形式のバックスラッシュ（例：C:\Users\...）を使用してください。スラッシュ（/）を使用すると、正しく解釈されない場合があります。 -
マルチインスタンスのポート番号：ADBポート =
5555 + index × 2（index 0 → 5555） -
対応バージョン：雷電14および雷電9に対応しています。問題が発生した場合は、最新版へのアップデートをお試しください。
LDPlayer9：ダウンロード
LDPlayer14：ダウンロード
1. 情報の取得
LDPlayerの一覧、実行状態、詳細情報を確認できます。用途に応じて複数の一覧取得コマンドを提供しています。
| コマンド | 説明 | 戻り値 |
|---|---|---|
list |
すべてのLDPlayer名を一覧表示 | インスタンス名を1行ずつ表示 |
list2 |
すべてのインスタンスの詳細情報を一覧表示 | インデックス、タイトル、トップレベルウィンドウハンドル、バインドウィンドウハンドル、実行状態（0/1）、プロセスPID、VBox PID、幅、高さ、DPI |
list3 --index |
指定したインスタンスの簡易情報を表示 | インデックス、名前、状態、幅、高さ、DPI |
runninglist |
現在実行中のインスタンスのみを一覧表示 | 実行中のインスタンス一覧 |
isrunning --index |
指定したインスタンスの実行状態を確認 | 実行状態 |
⚠️ 注意：
list3に有効な--indexを指定しなかった場合（例：--index0のように連結して記述した場合）、99999,コンピューターのデスクトップ,...という特殊なエントリが返されることがあります。これは実際のLDPlayerではなく、物理PCのデスクトップを示すエントリです。
すべてのインスタンスを確認する場合は、
listまたはlist2を使用してください。
使用例
ldconsole.exe list
ldconsole.exe list2
ldconsole.exe list3 --index 0
ldconsole.exe runninglist
ldconsole.exe isrunning --index 6
💡 ヒント：ADBの接続状態は、システムコマンド adb devices でも確認できます。ADB接続がデフォルトで自動登録されます。
詳細は「10. ADBコマンドと接続」を参照してください。
2. 作成
新しいインスタンスを作成します。インデックスは自動的に割り当てられます。
構文
ldconsole.exe add [--name <名前>]
| パラメータ | 説明 |
|---|---|
--name <名前> |
任意。新しいインスタンス名を指定します。省略した場合は自動的に名前が設定されます。 |
使用例
ldconsole.exe add
ldconsole.exe add --name テスト端末A
3. 複製
既存のインスタンスを複製して、新しいインスタンスを作成します（マルチインスタンス）。
構文
ldconsole.exe copy [--name <新しい名前>] --from <元の名前 | 元のインデックス>
| パラメータ | 説明 |
|---|---|
--name <新しい名前> |
複製先のインスタンス名 |
--from <名前またはインデックス> |
複製元のインスタンス |
使用例
ldconsole.exe copy --name 新しいクローン --from 0
ldconsole.exe copy --name 新しいクローン --from LDPlayer
4. 削除
指定したインスタンスを削除します。
構文
ldconsole.exe remove --name <名前>
ldconsole.exe remove --index <インデックス>
使用例
ldconsole.exe remove --index 2
ldconsole.exe remove --name テスト端末A
⚠️ 注意：削除したインスタンスのデータおよび設定はすべて消去され、元に戻すことはできません。
操作前に必要なデータをバックアップしてください。
5. 名の変更
表示名を変更します。
構文
ldconsole.exe rename [--name <名前> | --index <インデックス>] --title <新しいタイトル>
| パラメータ | 説明 |
|---|---|
--title <新しいタイトル> |
新しい表示名 |
使用例
ldconsole.exe rename --index 0 --title メイン端末
ldconsole.exe rename --name LDPlayer --title メイン端末
6. バックアップ
指定したインスタンスをイメージファイルとしてバックアップします。環境の移行や保存に利用できます。
構文
ldconsole.exe backup [--name <名前> | --index <インデックス>] --file <バックアップファイルのパス>
| パラメータ | 説明 |
|---|---|
--file <パス> |
バックアップ先のパス。拡張子は .ldbk を指定する必要があります。 |
使用例
ldconsole.exe backup --index 0 --file "D:\backup\LDPlayer.ldbk"
⚠️ 注意：
backupはシステムおよびユーザーデータを含むインスタンス全体のイメージをバックアップします。容量の大きいインスタンスでは、処理に時間がかかる場合があります。
7. 復元
backup で作成したバックアップファイル（.ldbk）を指定したインスタンスに復元します。
構文
ldconsole.exe restore [--name <名前> | --index <インデックス>] --file <バックアップファイルのパス>
| パラメータ | 説明 |
|---|---|
--file <パス> |
バックアップファイルのパス。.ldbk 形式を指定する必要があります。 |
使用例
ldconsole.exe restore --index 0 --file "D:\backup\LDPlayer.ldbk"
8. 操作
LDPlayerの起動・終了、ウィンドウ、アプリ、デバイス操作、スクリプトなどを制御できます。
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位置情報を設定 |
sortWnd |
すべてのエミュレータウィンドウを自動的に整列 |
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 <パッケージ名> |
LDPlayerを起動し、指定したアプリを直接起動 |
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は「LDPlayerの起動」と「アプリの起動」を1つのコマンドで実行できます。
7. デバイス操作（action）
システムレベルのデバイスイベントを送信します。
--key |
--value |
機能 |
|---|---|---|
call.keyboard |
back / home / menu / volumeup / volumedown |
システム仮想キーを送信（1回につき1キーのみ指定。` |
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. QRコードスキャン（scan）
💡 説明：現在はご利用いただけません。今後のアップデートで対応予定です。
9. ウィンドウサイズ変更（zoomIn / zoomOut）
💡 説明：現在はご利用いただけません。今後のアップデートで対応予定です。
10. ファイル転送（push / pull）
💡 説明：現在はご利用いただけません。今後のアップデートで対応予定です。
11. アプリデータのバックアップ（backupapp / restoreapp）
💡 説明：現在はご利用いただけません。今後のアップデートで対応予定です。
12. マクロスクリプト（operate*）
💡 説明：現在はご利用いただけません。今後のアップデートで対応予定です。
9. LDPlayerの設定
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桁の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）
💡 説明：現在はご利用いただけません。今後のアップデートで対応予定です。
10. ADBコマンドと接続
内蔵ADBコマンドに加えて、システムにインストールされたADBを直接利用できます。LDPlayerではADB接続がデフォルトで自動登録されます。
LDPlayerが自動的にADB接続を登録するため、ldconsole を介さずに、システムADBまたはLDPlayer付属のADBから直接各インスタンスを操作できます。
ポート番号 = 5555 + index × 2
index 6 → 5567
adb connect 127.0.0.1:5567