데모 비디오 크리에이터
브라우저 작업을 자동화하여 세련된 제품 데모 비디오를 만듭니다.
개요
- 계획 데모 시퀀스 (페이지, 상호작용, 타이밍)
- 녹화 Playwright CDP 스크린캐스트로 프레임 캡처
- 인코딩 FFmpeg로 비디오 변환
빠른 시작
사전 요구 사항
- Clawdbot 브라우저 실행 중 (
browser action=start profile=clawd) - 브라우저를 통해 접근 가능한 앱 (localhost 또는 원격)
- 인코딩을 위한 FFmpeg 설치
녹화 워크플로
- Clawdbot 브라우저가 실행 중이지 않으면 시작합니다.
- 수동으로 또는
browser action=open명령어로 앱에 접속합니다. - 대상 앱에 맞게
scripts/record-demo.js를 커스터마이징합니다. - 실행:
node scripts/record-demo.js - 인코딩:
bash scripts/frames-to-video.sh
데모 계획
자세한 내용은 references/demo-planning.md를 참조하세요:
- 데모 시퀀스 구조화
- 타이밍과 페이싱
- 상호작용 패턴
- 데모를 설득력 있게 만드는 요소
스크립트
scripts/record-demo.js
템플릿 Playwright 스크립트로, 다음 기능을 제공합니다:
- CDP를 통해 Clawdbot 브라우저에 연결
- 스크린캐스트 캡처 시작 (JPEG 프레임)
- 데모 시퀀스 실행 (탐색, 클릭, 호버, 타이핑)
- 출력 디렉토리에 프레임 저장
각 데모에 맞게 커스터마이징하세요:
DEMO_SEQUENCES배열 - 페이지와 상호작용 정의OUTPUT_DIR- 프레임을 저장할 위치FRAME_SKIP- 매 N번째 프레임 건너뛰기 (값이 낮을수록 프레임 증가)
scripts/frames-to-video.sh
프리셋이 포함된 FFmpeg 인코딩 스크립트:
mp4- H.264, 좋은 품질/크기 균형 (기본값)gif- 임베딩용 애니메이션 GIFwebm- VP9, 더 작은 파일 크기
사용법: ./frames-to-video.sh [입력_디렉토리] [출력_이름] [포맷]
상호작용 패턴
// 탐색
await page.goto('http://localhost/dashboard');
await page.waitForTimeout(2000);
// 요소 클릭
await page.locator('button:has-text("Create")').click();
await page.waitForTimeout(500);
// 호버 (툴팁, 호버 상태 표시)
await page.locator('.card').first().hover();
await page.waitForTimeout(1000);
// 텍스트 입력
await page.locator('input[placeholder="Search"]').fill('query');
await page.waitForTimeout(500);
// 키 누르기
await page.keyboard.press('Enter');
await page.keyboard.press('Escape');
// 스크롤
await page.evaluate(() => window.scrollBy(0, 300));
팁
- 타이밍: 페이지 로드 시 2초, 상호작용 사이 0.5~1초, 결과 표시 시 1.5초
- 프레임 스킵: 부드러운 비디오에는 3
5, 작은 파일에는 810 사용 - 품질: JPEG 품질 85~90이 크기와 선명도의 균형을 맞춥니다
- 해상도: 브라우저 창 크기가 출력 해상도를 결정합니다
- 루프: GIF는 매끄럽게 반복되어야 합니다 - 시작한 곳에서 끝나도록 합니다