android-midscene-automation 0.1.40 → 0.1.41

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # 更新记录
+## v0.1.41
+- 修复部分华为设备录屏启动时报编码器错误的问题：使用设备默认编码参数，视频流启动失败时降低分辨率和码率重试，并输出各次尝试的诊断日志。
+
 ## v0.1.40
+- 开启录屏时，在 Appium 服务端日志结束后汇总所有录像片段的脚本名称和保存位置；未生成视频时明确提示。
+- 录屏启动失败、录像不完整或保存失败时，日志明确提示对流程执行的影响并提供排查建议，保留原始错误信息。
 - 回放录屏支持按连接脚本分段保存 MP4，返回父脚本继续执行时另存片段；历史结果可选择片段播放，HTML 报告按节点时间自动切换视频，删除历史结果时一并清理全部片段。
 
 ## v0.1.39

package/README.md

@@ -1229,7 +1229,12 @@ Linux: ~/.local/share/android-midscene-automation
 
 # 项目更新记录
 
+## v0.1.41
+- 修复部分华为设备录屏启动时报编码器错误的问题：使用设备默认编码参数，视频流启动失败时降低分辨率和码率重试，并输出各次尝试的诊断日志。
+
 ## v0.1.40
+- 开启录屏时，在 Appium 服务端日志结束后汇总所有录像片段的脚本名称和保存位置；未生成视频时明确提示。
+- 录屏启动失败、录像不完整或保存失败时，日志明确提示对流程执行的影响并提供排查建议，保留原始错误信息。
 - 回放录屏支持按连接脚本分段保存 MP4，返回父脚本继续执行时另存片段；历史结果可选择片段播放，HTML 报告按节点时间自动切换视频，删除历史结果时一并清理全部片段。
 
 ## v0.1.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "android-midscene-automation",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/oooooooko/android-midscene-automation.git"

package/server/appium-recorder/appium-runner.ts

@@ -1536,10 +1536,17 @@ export async function replayAppiumScript(
       if (runOptions.recordVideo) {
         if (scope.privacy.enabled) throw new Error('本次运行包含敏感变量，为避免泄露已禁止录屏，请关闭录制回放视频');
         lines.push('正在启动后台录屏...');
-        recording = await startReplayVideo(targetDeviceId, signal);
-        replayContext.getStore()!.selectVideoScript = recording.selectScript;
-        await recording.selectScript(script.id, script.name);
-        lines.push('后台录屏已启动（MP4 / H.264 / 15fps / 2Mbps，无音频）');
+        try {
+          recording = await startReplayVideo(targetDeviceId, signal, message => lines.push(message));
+          replayContext.getStore()!.selectVideoScript = recording.selectScript;
+          await recording.selectScript(script.id, script.name);
+        } catch (error) {
+          if (!isReplayStopped(error)) {
+            lines.push('[录屏提示] 录屏启动失败，尚未执行任何流程节点。请检查设备连接、其他录屏或投屏占用，以及报告目录的写入权限和磁盘空间；也可关闭“录制回放视频”后重新回放。详细原因见下方错误日志。');
+          }
+          throw error;
+        }
+        lines.push('后台录屏已启动（MP4 / H.264 / 最高15fps，无音频）');
       }
       if (hasFlowSteps(script.steps)) lines.push('按流程图路径回放...');
       await replayScriptSteps(sessionId, targetDeviceId, script.steps, lines, [script.id], {
@@ -1581,9 +1588,15 @@ export async function replayAppiumScript(
             for (const [index, segment] of (video.segments || [video]).entries()) {
               lines.push(`回放视频 ${index + 1}（${segment.scriptName || script.name}）已保存：${segment.filePath}`);
             }
-            if (video.warning) lines.push(`录屏警告：${video.warning}`);
+            if (video.warning) {
+              lines.push(`录屏警告：${video.warning}`);
+              lines.push('[录屏提示] 本次录像可能不完整，请结合节点日志和截图确认执行结果；需要完整录像时，请检查设备连接和录屏占用后重新回放。');
+            }
           }
-        } catch (error) { lines.push(`回放视频保存失败：${errorDetail(error)}`); }
+        } catch (error) {
+          lines.push(`回放视频保存失败：${errorDetail(error)}`);
+          lines.push('[录屏提示] 本次录像未能完整保存。请检查报告目录的写入权限、磁盘空间及设备连接；录像保存失败不等同于流程节点失败，请以节点执行日志为准。');
+        }
       }
       let managedAppiumStopped = false;
       if (signal?.aborted && managedAppium) {
@@ -1600,6 +1613,17 @@ export async function replayAppiumScript(
         if (!managedAppiumStopped) await managedAppium.stop();
         lines.push('----- Appium 服务端原始日志结束 -----');
       }
+      if (runOptions.recordVideo) {
+        if (video) {
+          for (const [index, segment] of (video.segments || [video]).entries()) {
+            lines.push(`录屏位置 ${index + 1}（${segment.scriptName || script.name}）：${segment.filePath}`);
+          }
+        } else {
+          lines.push(scope.privacy.enabled
+            ? '录屏位置：无（敏感变量保护，本次不保留录像）'
+            : '录屏位置：无（未生成可用视频，请查看上方录屏提示）');
+        }
+      }
     }
 
     if (signal?.aborted && !stopped) {

package/server/appium-recorder/replay-video.ts

@@ -33,15 +33,33 @@ export async function isFinalizedMp4(path: string) {
   } finally { await file.close(); }
 }
 
-export async function startReplayVideo(deviceId: string, signal?: AbortSignal) {
+export async function startReplayVideo(deviceId: string, signal?: AbortSignal, onLog?: (message: string) => void) {
   signal?.throwIfAborted();
   const dir = appDataPath(loadConfig().runtime.reportOutputPath.trim() || 'output');
   await mkdir(dir, { recursive: true });
-  const fileName = `replay-${Date.now()}-${randomUUID()}.mp4`;
-  const filePath = join(dir, fileName);
-  const startupSignal = AbortSignal.any([...(signal ? [signal] : []), AbortSignal.timeout(30000)]);
-  const source = await openRecordingSource(deviceId, startupSignal);
-  return recordVideoStream(source, filePath, fileName, startupSignal);
+  const failures: string[] = [];
+  for (const profile of [
+    { label: '标准（1280 / 2Mbps）', maxSize: 1280, videoBitRate: 2000000 },
+    { label: '兼容（800 / 1Mbps）', maxSize: 800, videoBitRate: 1000000 },
+  ]) {
+    signal?.throwIfAborted();
+    const fileName = `replay-${Date.now()}-${randomUUID()}.mp4`;
+    const filePath = join(dir, fileName);
+    const startupSignal = AbortSignal.any([...(signal ? [signal] : []), AbortSignal.timeout(15000)]);
+    try {
+      onLog?.(`录屏启动：${profile.label}，使用设备默认编码参数`);
+      const source = await openRecordingSource(deviceId, startupSignal, profile);
+      return await recordVideoStream(source, filePath, fileName, startupSignal);
+    } catch (error) {
+      signal?.throwIfAborted();
+      const detail = error instanceof Error ? error.message : String(error);
+      failures.push(`${profile.label}：${detail}`);
+      // 仅编码/视频流启动异常才降级，ADB、磁盘、服务端版本错误直接保留原错误。
+      if (!/录屏视频流|关键帧|codec|encod|capture|timeout|timed out/i.test(detail)) throw error;
+      onLog?.(`录屏启动失败：${failures.at(-1)}`);
+    }
+  }
+  throw new Error(`录屏兼容重试失败，尚未执行流程节点。请检查设备编码器或其他录屏占用。\n${failures.join('\n')}`);
 }
 
 // 独立于连接层，便于用真实 H.264 数据验证封装、断流和终止收尾。

package/server/appium-recorder/scrcpy-recording-source.ts

@@ -24,7 +24,11 @@ function adbCommand(args: string[], signal?: AbortSignal) {
   });
 }
 
-export async function openRecordingSource(deviceId: string, signal: AbortSignal) {
+export type RecordingProfile = { label: string; maxSize: number; videoBitRate: number };
+
+export async function openRecordingSource(deviceId: string, signal: AbortSignal, profile: RecordingProfile = {
+  label: '标准', maxSize: 1280, videoBitRate: 2000000,
+}) {
   const require = createRequire(import.meta.url);
   const bin = join(dirname(require.resolve('@midscene/android-playground/package.json')), 'bin');
   const version = (await readFile(join(bin, 'scrcpy-server.version'), 'utf8')).trim();
@@ -52,8 +56,9 @@ export async function openRecordingSource(deviceId: string, signal: AbortSignal)
     const options = new AdbScrcpyOptions3_3_3({
       scid: Math.floor(Math.random() * 0x7fffffff).toString(16).padStart(8, '0'),
       audio: false, control: false, videoCodec: 'h264', sendFrameMeta: true,
-      maxSize: 1280, maxFps: 15, videoBitRate: 2000000,
-      captureOrientation: '@', videoCodecOptions: 'profile=1,max-bframes=0,i-frame-interval=2',
+      maxSize: profile.maxSize, maxFps: 15, videoBitRate: profile.videoBitRate,
+      // 不强制 profile/max-bframes 等厂商兼容性差的参数，交给设备选择。
+      captureOrientation: '@',
     });
     client = await waitForVideoTask(AdbScrcpyClient.start(adb, remotePath, options).then(value => {
       if (closing || signal.aborted) { void value.close(); throw signal.reason || new Error('录屏已取消'); }
@@ -75,6 +80,6 @@ export async function openRecordingSource(deviceId: string, signal: AbortSignal)
     return { stream: video.stream, close, diagnostics: () => logs };
   } catch (error) {
     await close();
-    throw error;
+    throw new Error(`${error instanceof Error ? error.message : String(error)}${logs}`, { cause: error });
   }
 }