feat: 为 MuMu/LDPlayer 添加路径/库检查并补充 i18n 提示

2026-07-15 17:30:27 +08:00 · 2025-12-12 17:58:17 +08:00
parent 9a8df0ea4e
commit 7fd6ffae14
6 changed files with 69 additions and 4 deletions
--- a/src/MaaWpfGui/Res/Localizations/en-us.xaml
+++ b/src/MaaWpfGui/Res/Localizations/en-us.xaml
@@ -534,6 +534,11 @@ Only supports Official(CN) and Bilibili server. Login account is not supported.<
    <system:String x:Key="ConnectionPreset">Connection Preset</system:String>
    <system:String x:Key="ScreenshotTest">Screenshot test</system:String>
    <system:String x:Key="MuMu12ExtrasEnabled">Enable MuMu's screenshot enhancement mode</system:String>
+    <system:String x:Key="MuMuEmulatorPathNotFound">MuMu Emulator 12 path not found.</system:String>
+    <system:String x:Key="MuMuExternalRendererMissing" xml:space="preserve">external_renderer_ipc.dll was not found under the selected MuMu installation.\n
+Expected relative path: nx_device/12.0/shell/sdk/external_renderer_ipc/external_renderer_ipc.dll or
+shell/sdk/external_renderer_ipc/external_renderer_ipc.dll\n
+Please verify the installation directory.</system:String>
    <system:String x:Key="MuMu12ExtrasEnabledTip" xml:space="preserve">
 MuMu V4.0.0 or later is required.
 It's strongly recommended to run a screenshot test immediately after enabling this feature.
@@ -554,6 +559,8 @@ Note:
    <system:String x:Key="MuMu12Display">Display Number</system:String>
    <system:String x:Key="MuMuExtrasNotEnabledMessage">Mumu screenshot enhancement not enabled, please check related settings</system:String>
    <system:String x:Key="LdExtrasEnabled">Enable LD's screenshot enhancement mode</system:String>
+    <system:String x:Key="LdPlayerEmulatorPathNotFound">LDPlayer emulator path not found.</system:String>
+    <system:String x:Key="LdPlayerOpenglMissing">ldopengl64.dll was not found in the selected LDPlayer path. Please verify the installation directory.</system:String>
    <system:String x:Key="LdExtrasEnabledTip" xml:space="preserve">
 LDPlayer 9 V9.1.32 or later is required.
 It's strongly recommended to run a screenshot test immediately after enabling this feature.
--- a/src/MaaWpfGui/Res/Localizations/ja-jp.xaml
+++ b/src/MaaWpfGui/Res/Localizations/ja-jp.xaml
@@ -534,6 +534,12 @@ HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Notifications\Settin
    <system:String x:Key="ConnectionPreset">接続構成</system:String>
    <system:String x:Key="ScreenshotTest">スクリーンショットテスト</system:String>
    <system:String x:Key="MuMu12ExtrasEnabled">MuMu のスクリーンショット拡張モードを有効にする</system:String>
+    <system:String x:Key="MuMuEmulatorPathNotFound">MuMu Emulator 12 のパスが見つかりません。</system:String>
+    <system:String x:Key="MuMuExternalRendererMissing" xml:space="preserve">external_renderer_ipc.dll が選択した MuMu インストール内に見つかりませんでした。\n
+想定される相対パス：
+nx_device/12.0/shell/sdk/external_renderer_ipc/external_renderer_ipc.dll または
+shell/sdk/external_renderer_ipc/external_renderer_ipc.dll\n
+インストールディレクトリを確認してください。</system:String>
    <system:String x:Key="MuMu12ExtrasEnabledTip" xml:space="preserve">
 MuMu V4.0.0 以降を利用する必要があり、MuMu 12 Arknights Global には対応していません。
 この機能を有効にした後、すぐにスクリーンショットテストを実行することを強くお勧めします。
@@ -554,6 +560,8 @@ C:\\Program Files\\Netease\\MuMuPlayer-12.0 を入力してください。\n
    <system:String x:Key="MuMu12Display">表示番号</system:String>
    <system:String x:Key="MuMuExtrasNotEnabledMessage">MuMu スクリーンショットの強化 が有効になっていません。関連する設定を確認してください</system:String>
    <system:String x:Key="LdExtrasEnabled">LD のスクリーンショット拡張モードを有効にする</system:String>
+    <system:String x:Key="LdPlayerEmulatorPathNotFound">LDPlayer のインストールパスが見つかりません。</system:String>
+    <system:String x:Key="LdPlayerOpenglMissing">選択した LDPlayer パスに ldopengl64.dll が見つかりません。インストールディレクトリを確認してください。</system:String>
    <system:String x:Key="LdExtrasEnabledTip" xml:space="preserve">
 LDPlayer 9 V9.1.32以降が必要です。
 この機能を有効にした後、すぐにスクリーンショットテストを実行することを強くお勧めします。
--- a/src/MaaWpfGui/Res/Localizations/ko-kr.xaml
+++ b/src/MaaWpfGui/Res/Localizations/ko-kr.xaml
@@ -534,6 +534,12 @@ HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Notifications\Settin
    <system:String x:Key="ConnectionPreset">연결 프리셋</system:String>
    <system:String x:Key="ScreenshotTest">스크린샷 테스트</system:String>
    <system:String x:Key="MuMu12ExtrasEnabled">MuMu 스크린샷 향상 모드 활성화</system:String>
+    <system:String x:Key="MuMuEmulatorPathNotFound">MuMu Emulator 12 경로를 찾을 수 없습니다.</system:String>
+    <system:String x:Key="MuMuExternalRendererMissing" xml:space="preserve">선택한 MuMu 설치 디렉터리에서 external_renderer_ipc.dll을 찾을 수 없습니다.\n
+예상 상대 경로:
+nx_device/12.0/shell/sdk/external_renderer_ipc/external_renderer_ipc.dll 또는
+shell/sdk/external_renderer_ipc/external_renderer_ipc.dll\n
+설치 디렉터리를 확인하세요.</system:String>
    <system:String x:Key="MuMu12ExtrasEnabledTip" xml:space="preserve">
 MuMu V4.0.0 이상 버전이 필요합니다.
 이 기능을 활성화한 후 즉시 스크린샷 테스트를 실행하는 것을 강력히 권장합니다.
@@ -554,6 +560,8 @@ C:\\Program Files\\Netease\\MuMuPlayer-12.0으로 입력해야 합니다.\n
    <system:String x:Key="MuMu12Display">표시 번호</system:String>
    <system:String x:Key="MuMuExtrasNotEnabledMessage">MuMu의 스크린샷 향상가 활성화되지 않았습니다. 관련 설정을 확인하세요</system:String>
    <system:String x:Key="LdExtrasEnabled">LD 스크린샷 향상 모드 활성화</system:String>
+    <system:String x:Key="LdPlayerEmulatorPathNotFound">LDPlayer 에뮬레이터 경로를 찾을 수 없습니다.</system:String>
+    <system:String x:Key="LdPlayerOpenglMissing">선택한 LDPlayer 경로에서 ldopengl64.dll을 찾을 수 없습니다. 설치 디렉터리를 확인하세요。</system:String>
    <system:String x:Key="LdExtrasEnabledTip" xml:space="preserve">
 LDPlayer 9 V9.1.32 이상이 필요합니다.
 이 기능을 활성화한 후 즉시 스크린샷 테스트를 실행하는 것을 강력히 권장합니다.
--- a/src/MaaWpfGui/Res/Localizations/zh-cn.xaml
+++ b/src/MaaWpfGui/Res/Localizations/zh-cn.xaml
@@ -534,6 +534,12 @@ HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Notifications\Settin
    <system:String x:Key="ConnectionPreset">连接配置</system:String>
    <system:String x:Key="ScreenshotTest">截图测试</system:String>
    <system:String x:Key="MuMu12ExtrasEnabled">启用 MuMu 截图增强模式</system:String>
+    <system:String x:Key="MuMuEmulatorPathNotFound">未找到 MuMu Emulator 12 路径。</system:String>
+    <system:String x:Key="MuMuExternalRendererMissing" xml:space="preserve">external_renderer_ipc.dll 未在所选 MuMu 安装目录中找到。\n
+期望的相对路径：
+nx_device/12.0/shell/sdk/external_renderer_ipc/external_renderer_ipc.dll 或
+shell/sdk/external_renderer_ipc/external_renderer_ipc.dll\n
+请确认安装目录。</system:String>
    <system:String x:Key="MuMu12ExtrasEnabledTip" xml:space="preserve">
 需使用官版或方舟专版 MuMu V4.0.0 或更新版本，国际版暂不支持。
 强烈建议在开启本功能后立刻运行一次截图测试。
@@ -554,6 +560,8 @@ C:\\Program Files\\Netease\\MuMuPlayer-12.0。\n
    <system:String x:Key="MuMu12Display">屏幕编号</system:String>
    <system:String x:Key="MuMuExtrasNotEnabledMessage">Mumu 截图增强未生效，请检查相关设置</system:String>
    <system:String x:Key="LdExtrasEnabled">启用 LD 截图增强模式</system:String>
+    <system:String x:Key="LdPlayerEmulatorPathNotFound">未找到 LDPlayer 模拟器路径。</system:String>
+    <system:String x:Key="LdPlayerOpenglMissing">在所选 LDPlayer 路径中未找到 ldopengl64.dll，请确认安装目录。</system:String>
    <system:String x:Key="LdExtrasEnabledTip" xml:space="preserve">
 需使用官版或国际版雷电模拟器 9 V9.1.32 或更新版本。
 强烈建议在开启本功能后立刻运行一次截图测试。
--- a/src/MaaWpfGui/Res/Localizations/zh-tw.xaml
+++ b/src/MaaWpfGui/Res/Localizations/zh-tw.xaml
@@ -534,6 +534,12 @@ HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Notifications\Settin
    <system:String x:Key="ConnectionPreset">連接配置</system:String>
    <system:String x:Key="ScreenshotTest">截圖測試</system:String>
    <system:String x:Key="MuMu12ExtrasEnabled">啟用 MuMu 截圖增強模式</system:String>
+    <system:String x:Key="MuMuEmulatorPathNotFound">找不到 MuMu Emulator 12 路徑。</system:String>
+    <system:String x:Key="MuMuExternalRendererMissing" xml:space="preserve">external_renderer_ipc.dll 未在所選 MuMu 安裝目錄中找到。\n
+期望的相對路徑：
+nx_device/12.0/shell/sdk/external_renderer_ipc/external_renderer_ipc.dll 或
+shell/sdk/external_renderer_ipc/external_renderer_ipc.dll\n
+請確認安裝目錄。</system:String>
    <system:String x:Key="MuMu12ExtrasEnabledTip" xml:space="preserve">
 需使用官版或方舟專版 MuMu V4.0.0 或更新版本，國際版暫不支援。
 強烈建議在開啟本功能後立刻執行一次截圖測試。
@@ -554,6 +560,8 @@ C:\\Program Files\\Netease\\MuMuPlayer-12.0。\n
    <system:String x:Key="MuMu12Display">螢幕號碼</system:String>
    <system:String x:Key="MuMuExtrasNotEnabledMessage">Mumu 截圖增強未生效，請檢查相關設定</system:String>
    <system:String x:Key="LdExtrasEnabled">啟用 LD 截圖增強模式</system:String>
+    <system:String x:Key="LdPlayerEmulatorPathNotFound">找不到 LDPlayer 模擬器路徑。</system:String>
+    <system:String x:Key="LdPlayerOpenglMissing">在所選 LDPlayer 路徑中未找到 ldopengl64.dll，請確認安裝目錄。</system:String>
    <system:String x:Key="LdExtrasEnabledTip" xml:space="preserve">
 需使用官版或國際版雷電模擬器 9 V9.1.32 或更新版本。
 強烈建議在開啟本功能後立刻執行一次截圖測試。
--- a/src/MaaWpfGui/ViewModels/UserControl/Settings/ConnectSettingsUserControlModel.cs
+++ b/src/MaaWpfGui/ViewModels/UserControl/Settings/ConnectSettingsUserControlModel.cs
@@ -348,11 +348,25 @@ public class ConnectSettingsUserControlModel : PropertyChangedBase
            {
                if (_enable && !string.IsNullOrEmpty(value) && !Directory.Exists(value))
                {
-                    MessageBoxHelper.Show("MuMu Emulator 12 Path Not Found");
-                    AutoDetectEmulatorPath();
+                    MessageBoxHelper.Show(LocalizationHelper.GetString("MuMuEmulatorPathNotFound"));
+                    MessageBoxHelper.Show(LocalizationHelper.GetString("MuMu12ExtrasEnabledTip"));
                    return;
                }

+                // 当路径存在时，检查 external_renderer_ipc.dll 是否可用（兼容 MuMu 5/12 路径）
+                if (!string.IsNullOrEmpty(value) && Directory.Exists(value))
+                {
+                    var dllPath1 = Path.Combine(value, "nx_device", "12.0", "shell", "sdk", "external_renderer_ipc.dll");
+                    var dllPath2 = Path.Combine(value, "shell", "sdk", "external_renderer_ipc.dll");
+
+                    if (!File.Exists(dllPath1) && !File.Exists(dllPath2))
+                    {
+                        MessageBoxHelper.Show(LocalizationHelper.GetString("MuMuExternalRendererMissing"));
+                        MessageBoxHelper.Show(LocalizationHelper.GetString("MuMu12ExtrasEnabledTip"));
+                        return;
+                    }
+                }
+
                Instances.AsstProxy.Connected = false;
                SetAndNotify(ref _emulatorPath, value);
                ConfigurationHelper.SetValue(ConfigurationKeys.MuMu12EmulatorPath, value);
@@ -514,11 +528,23 @@ public class ConnectSettingsUserControlModel : PropertyChangedBase
            {
                if (_enable && !string.IsNullOrEmpty(value) && !Directory.Exists(value))
                {
-                    MessageBoxHelper.Show("LD Emulator Path Not Found");
-                    AutoDetectEmulatorPath();
+                    MessageBoxHelper.Show(LocalizationHelper.GetString("LdPlayerEmulatorPathNotFound"));
+                    MessageBoxHelper.Show(LocalizationHelper.GetString("LdExtrasEnabledTip"));
                    return;
                }

+                // 当路径存在时，检查 ldopengl64.dll 是否存在
+                if (!string.IsNullOrEmpty(value) && Directory.Exists(value))
+                {
+                    var libPath = Path.Combine(value, "ldopengl64.dll");
+                    if (!File.Exists(libPath))
+                    {
+                        MessageBoxHelper.Show(LocalizationHelper.GetString("LdPlayerOpenglMissing"));
+                        MessageBoxHelper.Show(LocalizationHelper.GetString("LdExtrasEnabledTip"));
+                        return;
+                    }
+                }
+
                Instances.AsstProxy.Connected = false;
                SetAndNotify(ref _emulatorPath, value);
                ConfigurationHelper.SetValue(ConfigurationKeys.LdPlayerEmulatorPath, value);