모션 프리플라이트 QA은(는) 무엇을 하나요?
코드로 렌더링된 모션 그래픽 및 숏폼 비디오 광고를 위한 결정론적 브로드캐스트 및 소셜 플랫폼 품질 게이트입니다. 블라인드 재렌더링, 잘린 캡션, 음소거/압축된 오디오, iOS/QuickTime 재생 버그를 제거하기 위해 설계되었습니다.
사전 요구사항
- Python 3.9+ (표준 라이브러리만 사용 — 서드파티 Python 패키지 필요 없음)
- PATH에 FFmpeg 및 FFprobe
표준 QA 워크플로 (모든 전달 전에 실행)
1단계: 렌더링된 비디오 감사
대상 플랫폼(reels, tiktok, shorts, youtube, linkedin, square 또는 auto)에 대해 8개 게이트 기술 감사를 실행합니다:
python3 scripts/audit_video.py path/to/video.mp4 --platform reels
자동화된 파이프라인에 연결할 때는 --json을 사용하여 기계 판독 가능한 출력을 생성합니다.
확인하는 항목:
- 컨테이너 및 코덱: H.264(
libx264) 또는 HEVC MP4 호환성. - 픽셀 포맷 (
yuv420p): QuickTime, Safari 및 Instagram iOS에서 검은 화면으로 렌더링되는yuv444p/10비트 내보내기를 감지합니다. - Web Faststart (
moov가mdat보다 앞에): 버퍼링 지연 없이 즉시 프로그레시브 모바일 재생이 가능한지 확인합니다. - 종횡비 및 해상도: 대상 플랫폼 치수(예: 9:16 세로의 경우
1080x1920)와 일치하는지 확인합니다. - 프레임 레이트 일관성: 표준 FPS(
24,30,60또는120)를 확인하고 비표준 가변 프레임 레이트를 플래그합니다. - 훅 무결성 (블랙 프레임 스캔): 시작 부분의 데드 블랙 인트로(> 0.25초) 또는 중간의 예상치 못한 블랙 갭을 플래그합니다.
- 오디오 라우드니스 (EBU R128): 통합 라우드니스(
I, LUFS) 및 트루 피크(TP, dBTP)를 소셜 표준인-14 LUFS/-1.0 dBTP와 비교하여 측정합니다. - 파일 크기 및 비트레이트 예산: 공격적인 플랫폼 재압축을 유발하는 비대한 필름 그레인 내보내기를 플래그합니다.
2단계: 안전 영역 콘택트 시트 생성
플랫폼 HUD 위험 영역을 반투명 빨간색으로 마스킹하고 타이틀 안전 경계를 녹색으로 표시한 6프레임 시각적 증명 시트를 생성합니다:
python3 scripts/safe_zone_overlay.py path/to/video.mp4 --platform reels --out qa_contact_sheet.png
qa_contact_sheet.png를 검사합니다(시각적으로 또는 이미지 판독 도구 사용):
- 빨간색 영역 = UI 위험 영역 (상단 헤더, 오른쪽 좋아요/댓글/공유 레일, 하단 캡션/오디오 서랍).
- 녹색 상자 = 타이틀 안전 영역. 빨간색 영역에 닿는 모든 헤드라인, 통계, 제품 콜아웃 또는 CTA는 전달 전에 재배치되어야 합니다.
- 단일 문제 타임스탬프를 전체 해상도로 검사하려면
--at <seconds> --out proof_frame.png를 추가합니다.
3단계: 전달용 자동 마스터링 (기술 경고 또는 실패 시)
픽셀 포맷 수정, +faststart 삽입, 2패스 EBU R128 라우드니스 정규화(-14 LUFS, -1.0 dBTP) 적용, 비트레이트 최적화:
python3 scripts/fix_delivery.py path/to/video.mp4 --out path/to/video_master.mp4 --crf 20
무거운 필름 그레인 또는 노이즈가 많은 배경의 경우 --crf 23을 사용하여 타이포그래피가 뭉개지지 않으면서 파일 크기를 줄입니다. 그런 다음 마스터링된 파일에 대해 1단계를 다시 실행하여 100/100 PASS를 확인합니다.
참조 문서
references/platform-safe-zones.md— Instagram Reels, TikTok, YouTube Shorts, LinkedIn 및 16:9 와이드스크린에 대한 정확한 2026년 안전 영역 좌표 및 픽셀 여백.references/delivery-specs.md— 코덱, 색 공간, 라우드니스, 비트레이트 및 일반적인 코드-비디오 실패 수정 방법.