用途
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 保持一致以获得清晰输出。
常见录制模式
资料提供了多种可复用脚本模式:
- 表单提交演示:逐项 fill 输入并等待结果选择器出现。
- 多页导航:点击导航链接并用 waitForLoadState('networkidle') 等待加载。
- 滚动演示:通过 page.evaluate 循环调用 window.scrollBy 实现平滑滚动。
- 登录流程:填充账号密码、提交并等待跳转到 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() 可能报错,需要通过异常捕获来处理。