SuperAPI AI 工具集

playwright-recording

编程与开发

查看项目

更新于 11-08 16:04

技能介绍

用途

playwright-recording 用于让 Playwright 将浏览器中的交互过程录制为视频,主要面向演示视频、应用走查、UI 流程素材的采集,文中特别强调可作为 Remotion 视频合成的演示片段。资料没有说明该技能是否提供托管服务或额外交费方式,相关内容暂未提供。

环境安装

资料给出的初始化与安装命令:

npm init -y
npm install -D playwright @playwright/test
npx playwright install chromium

基本录制方式

通过 chromium 启动浏览器,在 newContext 中设置 viewport 和 recordVideo(目录与尺寸),打开页面后执行 goto、click、waitForTimeout 等操作,最后关闭 context 以保存视频。示例脚本可通过 ts-node 或 tsx 运行:

npx ts-node scripts/record-demo.ts
# 或
npx tsx scripts/record-demo.ts

录制配置

  • 视口尺寸:资料列出 1920x1080(推荐用于 Remotion)、1280x720、1080x1080、390x844(iPhone 14)等选项。
  • 慢动作:slowMo 配置在 browser launch 上,而不是 context 上,示例为 slowMo: 100。
  • 视频尺寸:recordVideo 的 size 建议与 viewport 保持一致以获得清晰输出。

常见录制模式

资料提供了多种可复用脚本模式:

  1. 表单提交演示:逐项 fill 输入并等待结果选择器出现。
  2. 多页导航:点击导航链接并用 waitForLoadState('networkidle') 等待加载。
  3. 滚动演示:通过 page.evaluate 循环调用 window.scrollBy 实现平滑滚动。
  4. 登录流程:填充账号密码、提交并等待跳转到 dashboard。

视觉增强

资料说明 Playwright 默认不显示光标,可通过注入 CSS 和 DOM 实现光标高亮与点击涟漪效果(clickWithRipple 自定义函数)。同时明确警告:注入的光标、控制面板、覆盖层等 DOM 元素都会被录制进视频;若需要无 UI 干扰的录制,应使用终端控制方式(如 Ctrl+C、最长时长计时器)。

输出与处理

  • 录制完成后可通过 page.video() 获取视频路径,并用 fs 移动到 ./public/demos/。
  • Playwright 默认输出 WebM;资料给出用 ffmpeg 转为 MP4 的命令:
ffmpeg -i recording.webm -c:v libx264 -crf 20 -preset medium -movflags faststart public/demos/demo.mp4
  • 可用 ffprobe 获取时长。

交互式录制

资料给出页内注入 ESC 监听并轮询停止信号的做法,并提示 page.evaluate() 在页面导航期间会抛错,应使用 try/catch 继续录制,而不是把错误当作停止信号。

其它实用细节

  • 笔记本窗口缩放:通过 deviceScaleFactor 配合缩小 viewport,在录制时输出 1080p。
  • Cookie 横幅处理:提供 OneTrust、Cookiebot 等常见选择器列表及 dismissCookieBanners 函数。
  • 提升演示质量的建议:使用 slowMo(50-100ms)、在操作间加 waitForTimeout、等待动画结束、按 Remotion 尺寸录制、正式录制前先测试、使用全新上下文、页面导航后重新注入光标或监听器。

适用场景

产品功能演示、登录/表单/多页流程走查、滚动展示,以及为 Remotion 视频准备演示素材。

限制与注意事项

资料未提供该技能的收费、平台支持范围或录制时长上限等信息,暂未提供。已知限制主要是:注入的可视化元素会出现在录制画面中;在导航期间执行 page.evaluate() 可能报错,需要通过异常捕获来处理。