브라우저 동영상 녹화
종속성 모델
워크플로를 세 계층으로 분리하세요:
- 브라우저 제어 및 소스 프레임: Codex 인앱 브라우저를 Browser 스킬/MCP를 통해 사용하세요. 사용자가 Codex 브라우저를 요청하거나 프로젝트에서 금지하지 않는 한 Chrome을 사용하지 마세요. 브라우저 계층은 실제 스크린샷과 실제 클릭/스크롤/탐색 상태를 제공합니다.
- 로컬 비디오 렌더러: 번들 Python 스크립트를 사용하여 스크린샷을 자연스러운 macOS 커서, 미묘한 클릭 스케일, 차분한 줌 팔로우 프레이밍이 있는 MP4로 렌더링합니다. 이는 스크린 녹화 MCP가 필요하지 않습니다.
- 선택적 네이티브 녹화기 통합: 네이티브 녹화 MCP는 호출 가능하고 실제 앱 녹화를 시작/중지하거나 생성된 프로젝트를 여는 데 명시적으로 유용한 경우에만 사용하세요. 사용할 수 없거나, 차단되었거나, Codex 브라우저 표면을 캡처할 수 없는 경우 스크린샷-비디오 렌더러로 폴백하고 그 이유를 설명하세요.
자체 포함 실행
이 스킬은 전체 스킬 폴더가 설치되어 있고 scripts/render_browser_demo.py가 포함되어 있다면 다른 Codex 인스턴스가 Python 렌더링을 수행하기에 충분합니다. Codex는 렌더러를 다시 만들지 말고 번들 스크립트를 실행해야 합니다.
필요한 로컬 도구:
python3- Python 패키지
Pillow ffmpeg및ffprobe
선택적 macOS 커서 추출은 swift와 /usr/sbin/screencapture를 사용합니다. 이들을 사용할 수 없는 경우 cursor_asset을 통해 투명 PNG를 제공하고 설정에서 cursor_hotspot을 지정하세요.
Browser 스킬/MCP는 새로운 Codex 인앱 브라우저 스크린샷을 위해 여전히 필요합니다. 사용할 수 없는 경우 사용 가능한 최고의 브라우저 자동화 스크린샷 소스를 사용하고 폴백임을 명시하세요.
선택적 네이티브 녹화기 지원
네이티브 앱 녹화의 경우 MCP가 다음을 지원하는지 확인하세요:
frameRate: 60사용.resolutionRawValue: "4K"사용.- 영역 녹화 시
ratioPresetRawValue: "4:3"사용. - 포함된 브라우저 뷰포트로 크롭할 때 명시적
selectedRegionOnScreen사용.
로컬 렌더러의 경우 4K 4:3은 3840x2880 을 의미합니다. 네이티브 녹화기가 4K 열거형을 노출하면 앱 측 해상도 프리셋으로 처리하고 해당 MCP를 통해 녹화할 때 4:3 영역 선택과 짝지으세요.
캡처 워크플로
먼저 browser:control-in-app-browser를 사용하세요. 문서를 로드한 후, Node/브라우저 API로 인앱 브라우저를 구동하세요:
- 4:3 4K 출력을 위해 뷰포트를
1920x1440으로 설정한 후, 마칠 때 재설정하세요. - 요청된 페이지로 이동하고 실제 클릭, 뒤로 가기, 검색, 스크롤을 수행하세요.
- 각 중요한 상태 변경 후 브라우저 전용 스크린샷을 저장하세요.
01-results-top.png,02-after-card-click.png,03-back-results.png와 같은 이름을 사용하세요. - 각 클릭/스크롤 대상의 뷰포트 좌표를 기록하세요. 최종 커서 경로는 해당 지점에 도달하고, 멈추며, 클릭한 후 다음 의미 있는 지점으로 이동해야 합니다.
사용자가 명시적으로 시스템 UI를 필요로 하지 않는 한 데스크톱 좌표 자동화는 피하세요. Codex 브라우저 가시성은 캡처 가능한 macOS 표면을 노출하지 않을 수 있습니다. 브라우저 API의 스크린샷이 신뢰할 수 있는 소스입니다.
모션 규칙
커서가 의도적으로 움직이도록 만드세요:
- 드물고 대부분 직선인 커서 경로를 사용하세요.
- 대상에서 클릭하기 전에 잠시 멈추세요.
- 관련 없는 UI 위를 배회하지 마세요.
- 클릭 후에 페이지 전환이 일어나도록 하고, 클릭 전에는 일어나지 않도록 하세요.
- 미묘한 클릭 피드백만 사용하세요: 스케일 딥/리바운드, 요청하지 않은 경우 장식용 링은 사용하지 마세요.
- 줌 팔로우는 커서보다 차분하게 유지하세요. 카메라는 클릭된 콘텐츠를 프레이밍해야 하며, 모든 작은 마우스 움직임을 쫓지 않아야 합니다.
기본 시각적 대상:
- 컴포지터에서 추출한 실제 macOS 포인터 또는 기존 투명 커서 에셋.
- 편집된 데모 녹화에서 일반적으로 사용되는 큰 커서 스타일에 맞춰 커서 스케일
3.0. - 미묘한 클릭 스케일 딥을 위한 클릭 애니메이션 강도
15. - 회전 강도는 수평 속도로부터 최대
8deg.
렌더 스크립트
결정론적 60fps 4:3 4K 출력을 위해 scripts/render_browser_demo.py를 사용하세요:
python3 /path/to/browser-video-recording/scripts/render_browser_demo.py \
--config /tmp/browser-demo-config.json \
--output /tmp/browser-demo-4x3-4k-60fps.mp4
시작 설정 생성:
python3 /path/to/browser-video-recording/scripts/render_browser_demo.py --write-template
설정 항목:
shots: 상태 이름을 스크린샷 PNG 경로에 매핑.scene_starts:[time, shotName, transition]항목.cursor_keys:[time, x, y]뷰포트 좌표 항목.camera_keys:[time, x, y, zoom]항목.click_times: 클릭 타임스탬프.duration,fps,output_size,source_size,cursor_scale.
선호 기본값:
{
"fps": 60,
"output_size": [3840, 2880],
"source_size": [1920, 1440]
}
cursor_asset이 생략되면 스크립트가 잠시 단색 오버레이를 표시하고 screencapture를 사용하여 실제 현재 macOS 커서를 투명 PNG로 추출합니다. 이는 로컬 렌더링 지원이며 MCP 종속성이 아닙니다.
검증
항상 전달된 비디오를 검증하세요:
ffprobe -v error \
-show_entries stream=codec_name,width,height,r_frame_rate \
-show_entries format=duration,size \
-of json /path/to/output.mp4
비디오 중간의 썸네일을 하나 이상 추출하고 검사하세요:
ffmpeg -y -ss 8 -i /path/to/output.mp4 -frames:v 1 -update 1 /tmp/browser-demo-thumb.png
다음을 확인하세요:
- 해상도는 요청된 출력이며, 일반적으로 4:3 4K의 경우
3840x2880입니다. - 프레임률은
60/1또는 이에 상응합니다. - 재생 시간이 요청과 일치합니다.
- 커서가 보이고, 자연스럽고, 대상에 위치합니다.
- 비디오가 브라우저 콘텐츠로 크롭되었으며 데스크톱이 아닙니다.
- 브라우저 뷰포트 오버라이드가 재설정되었습니다.