Android 출시 영상은(는) 무엇을 하나요?
실제 앱을 에뮬레이터에서 실행하면서 Play 프로모션 비디오(16:9), 소셜 미디어용 세로형 비디오(9:16, 음성 해설 유/무 각각), 그리고 스토어 이미지를 제작하는 방법과 도구 모음입니다. 목표는 단순한 화면 녹화가 아닌 완성된 에이전시 영화입니다.
이 스킬은 product-launch-motion(AbubakrChan, MIT)을 Android에 맞게 조정한 것입니다. 해당 스킬은 필수이며 함께 번들로 제공되지 않습니다: https://github.com/AbubakrChan/product-launch-motion 에서 설치(커밋 edbfb105에서 테스트됨)하고, 필름 코드를 작성하기 전에 다음 문서를 읽으십시오:
SKILL.mdreferences/technique.mdreferences/prompts.mdlegacy/references/03-word-locked-sync.mdlegacy/references/07-sound-and-master.md
Android용으로 변경된 사항: 커서 대신 터치 표시기, 재구성된 모션 대신 실제 60fps 캡처, 화면에서 분리된 모든 요소에 대한 불투명 표면, 보컬 컷 아티팩트가 검사된 음악, 음성 인식으로 확인된 나레이션, Play 스토어 규칙입니다.
도구는 tools/ 디렉토리에 있으며(인덱스는 references/tools.md), 자세한 내용은 references/에 있습니다. 이 파일은 방법과 규칙을 설명합니다.
1. 결과물
| 항목 | 사양 |
|---|---|
| Play / YouTube 비디오 | 1920x1080, 60fps, H.264, AAC 48kHz, -14 LUFS 통합, true peak <= -1 dBTP |
| 소셜 세로형 비디오 | 1080x1920, 동일 사양, 16:9를 자르지 않고 독립적으로 구성 |
| 음성 해설 유/무 각각 | 네 개의 마스터. 나레이션 버전은 별도로 제작되며 음악 전용 버전을 절대 대체하지 않음 |
| Play 스크린샷 | 최대 8개, 1080x1920, 24비트 PNG(알파 채널 없음) 또는 JPEG |
| 피처 그래픽 | 1024x500, 알파 채널 없음; 중앙(약 x 362 ~ 662)은 비워둠: Play가 재생 버튼을 그곳에 배치함 |
| 소셜 스틸 | 1080x1920 |
| 미리보기 | 각 최대 14MB, Artifact로 표시 |
길이: 약 40초, 최대 50초를 넘지 않음.
9:16 비디오에서 릴스, 쇼츠, 틱톡이 UI로 덮는 영역(상단 14%, 하단 20%, 오른쪽 가장자리에서 약 120px)에는 중요한 내용(텍스트, 로고, 버튼)을 배치하지 않음.
2. 프로덕션 규칙 (승인 후 유지)
- 완성된 제품. 모든 프레임을 유료 에이전시 영화로 판단하십시오.
- 실제 모션. 휴대폰 내부에서 움직이는 모든 것은 60fps로 녹화된 앱입니다. 어떤 모션도 애니메이션 스크린샷으로 재구성되지 않습니다. 끊기는 클립은 다시 녹화합니다.
- 커서 없음. Android에는 마우스가 없습니다. 각 터치는 실제 터치가 발생한 위치와 시간에(캡처의 탭 로그에서) 부드러운 원과 Material 리플 효과로 표시됩니다.
- 화면에 다른 앱 없음(메시징 앱, 지도, 브라우저, 계정 선택기). 앱이 버튼에 다른 앱 이름을 언급하면 그 단어는 읽을 수 있습니다. 다른 앱은 절대 나타나지 않습니다.
- 표면 없이 떠 있는 요소 없음. 휴대폰 화면에서 분리된 모든 요소는 자체 불투명 표면 위에 있어야 합니다: 해당 섹션의 카드 자체 또는 앱의 컨테이너 형태로, 고유의 모서리 반경, 색상 및 부드러운 그림자를 가집니다. 텍스트가 휴대폰 이미지 위에 직접 놓이거나 다른 텍스트와 겹쳐서는 안 됩니다.
- 앱과 동일해야 함. 분리된 요소는 보이는 프레임의 정확한 크롭으로 시작하여, 공중으로 떠오르면서 짧은 블러를 거쳐 해당 크롭에 대해 보정된 벡터 복제본으로 전환됩니다. 만들어진 배지, 아이콘, 버튼 또는 데이터는 없습니다.
- 브랜드나 앱에 없는 것은 넣지 않음. 최종 버튼에 재생 글리프, 전체 화면 색상 전환, 텍스트를 읽기 쉽게 하기 위한 배경 상자 등이 없습니다. 대신 크기를 조정하십시오.
- 브랜드로 시작하고 끝남, 두 형식 모두 축을 중심으로 배치.
- 살아있는 모션. 뻣뻣한 블록보다는 비트에 맞춰 늘어나고 가늘어지며 교차하는 긴 스트로크가 더 좋게 보입니다.
- 신뢰할 수 있는 데이터: 앱 도메인의 실제 시장 가치를 사용하며, 실제 개인 데이터는 절대 사용하지 않습니다.
- 리스팅 언어의 텍스트는 올바른 분음 부호를 사용하고, 줄표(em-dash)는 사용하지 않습니다.
- 리뷰어는 프로덕션 전에 스크립트, 음악, 음성 및 브랜드 발음을 승인하며, 사전 확인되지 않은 것은 보지 않습니다(섹션 11).
3. 역할 및 승인
- 감독(메인 세션): 리뷰어와 대화하고, 하위 에이전트를 시작하며, 검토 및 게시합니다. 리뷰어에 대한 질문은 AskUserQuestion을 통해 전달됩니다.
- 분석 하위 에이전트: 제품, 브랜드, 흐름, 로컬 환경, 샘플 데이터, 녹화 계획 및 스크립트. 앱을 빌드하거나 에뮬레이터를 시작하지 않습니다.
- 승인: Artifact의 스토리보드(Playwright로 그린 키 프레임을 보여주기 전에 확인), 마디별 스크립트, 음악, 음성 캐스팅, 브랜드 발음, 녹화 중 모니터 회전 허가.
- 프로덕션 하위 에이전트: 빌드, 에뮬레이터, 캡처, 필름, 오디오, 나레이션, 렌더링, 스틸, 검사 및 결과물. 작업 디렉토리의
PROGRESS.md에 진행 상황을 기록합니다. - 종료: 감독이 검토 및 게시합니다. 리뷰어 노트는 승인될 때까지 프로덕션으로 다시 전송됩니다(SendMessage).
4. 로컬 환경 및 데이터
- 로컬 에뮬레이터만 사용. 시딩 전에 모든 에뮬레이터 호스트 변수가 설정되었는지 확인하십시오: 하나라도 누락된 상태로 관리 SDK를 통해 시딩하면 프로덕션에 기록됩니다.
- 신뢰할 수 있는 데이터 대상 시장에 맞게: 이름, 장소, 가격 및 사진. 상업적 사용이 허가된 라이선스의 사진, 출처 명시, 타사 브랜드 없음.
- 위치 설정:
adb -s <시리얼> emu geo fix <경도> <위도>. - 릴리스 또는 프로필 빌드, 디버그 오버레이 없이 에뮬레이터를 가리키도록 설정. 녹화를 위해서만 존재하는 패치(환경 배너 숨기기, 대기 건너뛰기)는 커밋되지 않은 상태로 유지되며 마지막에 되돌려집니다.
- 텔레메트리(충돌 보고, 분석)는 해당 빌드에서 비활성화하거나 프로덕션에 도달하지 않음을 입증해야 합니다.
- 깨끗한 상태 표시줄 SystemUI 데모 모드 사용(
tools/capture/demo.sh): 9:41, 완전 충전 및 Wi-Fi, 알림 없음. - 시스템 애니메이션 배율 1로 녹화(0으로 설정하면 앱이 휴대폰처럼 움직이지 않음).
- 공유 백엔드: 공유되는 것(스테이징 데이터베이스 등)이 쓰기를 수신하면 전후의 행 수를 셉니다. 시뮬레이션된 제공자와 함께하는 로컬 API는 공유 데이터베이스에 가상 데이터를 남길 수 있습니다.
5. 실제 60fps 캡처
에뮬레이터 내부의 screenrecord로는 충분하지 않습니다: 1080x2400에서 약 41fps(720x1600에서 53), 스크롤이 끊겨 보입니다. 테스트용으로만 사용하십시오(tools/capture/clip.py). 옵션:
- Windows 호스트 + GPU (테스트 완료). Windows에서
-gpu host로 에뮬레이터 실행, 모니터를 세로로 회전하여 휴대폰이 1:1로 맞도록 함, ffmpeg의ddagrab(Desktop Duplication)을 60fps로 사용하여 휴대폰 화면을 크롭하고 회전,hevc_amf(AMD, 테스트 완료) 또는h264_nvenc/hevc_nvenc(NVIDIA, 테스트 안 됨)로 거의 무손실로 인코딩.tools/capture/capture.py(ClipGPU)가 녹화하고, 에뮬레이터 클럭으로 모든 탭과 스와이프를 기록하며, 클립을 WSL로 이동합니다. - 실물 휴대폰 + scrcpy (테스트 안 됨). 휴대폰 재생 빈도로
scrcpy --record사용; 탭 로그 및 동기화는 조정이 필요할 수 있습니다. - macOS / Linux 호스트: 지원되지 않음.
그런 다음 sync60.py가 각 탭을 해당 시각적 변화와 정렬하고, measure2.py, stutter.py, jumps.py가 결과를 측정하며(테스트 설정에서 초당 53~59 고유 프레임 제공), app_fps.sh는 앱 자체가 에뮬레이터 내부에서 60fps로 그려지는지 알려줍니다. Windows 점검(잠금 해제된 세션, 화면 시간 초과, 여유 메모리)과 함께 단계별 설명: references/capture-60fps.md.
6. 필름
DIRECTION.md(앱 테마의 브랜드 색상 및 글꼴, 로고, 개념, 마디별 스크립트, 규칙), PLAN.md를 작성한 후에만 코딩합니다. 하나의 HTML 페이지(film/index.html?f=16x9 또는 ?f=9x16)이며 모든 것은 seek(t)의 순수 함수입니다: 폐쇄형 스프링, CSS 전환 불가, 타이머 없음. tools/video/film/core.js가 엔진입니다(스프링, 트랙, 회전 숫자). 일반적인 벡터 휴대폰 프레임(제조사 브랜딩 없음) 내부에서는 seek(t)에서 프레임별로 재생되는 실제 녹화 영상만 재생되며, 탭 로그에서 그려진 터치 표시기가 함께 표시됩니다.
Playwright로 렌더링: 프레임당 4개의 서브프레임을 ffmpeg tmix로 평균 내어 60fps로, 여유 메모리에 맞게 병렬 세그먼트로 크기 조정. 30fps 및 절반 해상도의 드래프트. 마디별 콘택트 시트 및 리뷰용 단일 프레임. 회전 숫자는 프레임별로 확인: 사이에 잘못된 값이 표시되어서는 안 됩니다. 자세한 내용: references/film.md.
7. 음악
- Mixkit 트랙, Mixkit 라이선스(https://mixkit.co/license/) 하에 사용; 제목과 저자는 크레딧에 포함. 감독이 선택하고, 리뷰어가 편집 전에 듣습니다.
tools/music/에 카탈로그(제목, 저자, 장르, 길이, 링크)와 템포/에너지 분석이 있습니다; 오디오는 번들로 포함되지 않습니다. - 자체 비트 그리드(
video/scripts/grid.py): 측정된 템포 및 첫 비트 위상. 컷은 공격 전 딥에서 약 14ms의 동일 전력 크로스페이드로 비트에 맞춥니다. - 보컬 컷 검사. 일부 트랙은 귀에 단어처럼 들리는(때로는 무례한) 잘린 보컬 히트를 전달합니다.
fingerprint.py와music_check.py가 히트의 스펙트럼 지문(250Hz~6kHz의 40개 로그 밴드, 코사인 유사도)을 편집의 모든 비트와 비교합니다: 어떤 것도 0.88에 도달해서는 안 됩니다. 해당 마디는 제외하고 에코를 낮춥니다. - 음향 효과 합성, 트랙의 음계에 맞춰 조정되고 측정된 피크에 배치됩니다(
audio.py). - 믹스 시작점: 트랙 x 0.5 + 효과 x 0.62, -14 LUFS, true peak <= -1 dBTP.
자세한 내용:
references/audio.md.
8. 나레이션
- Gemini TTS, 모델
gemini-3.8-flash-tts. 키는 오직 환경 변수GEMINI_API_KEY에서만 가져옵니다: 절대 출력하거나, 명령줄에 표시하거나, 저장소나 채팅에 포함하지 않습니다.tts.py는 헤더로만 전송하고 오류에서 제거합니다. - 하루에 소수의 무료 생성. 모든 요청이 기록됩니다. 429 오류는 보고되고 재시도되지 않습니다. 예산을 잘 사용하십시오: 음성당 짧은 캐스팅 라인, 그런 다음 테이크당 전체 스크립트를 한 번에 요청합니다.
- 캐스팅: 자연스럽고 따뜻한 목소리, 로봇 같지 않아야 합니다. 좋은 후보: Sulafat(따뜻함), Laomedeia(생동감), Leda(젊음).
- 브랜드 발음: 생성 전에 리뷰어에게 문의하십시오. 감독의 프롬프트 노트에 포함("...처럼 발음, ...처럼")되며, 화면에는 절대 표시되지 않습니다. faster-whisper large-v3(
transcribe.py)가 힌트 유무에 관계없이 확인합니다. 모델은 번들로 제공되지 않습니다: https://huggingface.co/Systran/faster-whisper-large-v3 - 음성이 먼저. 각 대사는 필름 내에서 자체 창을 가지며 핵심 단어는 해당 시각적 변화에 맞춰집니다(
segment.py,place.py,timing_table.py,pace.py). - 나레이션 믹스(
narrated_mix.py): 음악이 각 대사 아래에서 음성보다 9~12dB 낮게 덕킹되며, 램프가 적용됩니다.check_margin.py는 음성이 손실되는 지점을 찾고,audio_artifacts.py는 클릭 및 컷을 찾습니다. 자세한 내용:references/narration.md.
9. 스토어 이미지 및 Play 메타데이터
- 스크린샷: 9:16 필름의 깨끗한 프레임(
store_shots.mjs, 프레임당 단일seek(t), 모션 블러 없음) 또는 헤드라인이 있는 실제 스크린샷. 1080x1920, 24비트 PNG, 알파 채널 없음(png_srgb.py). 첫 번째는 가치 제안을 명시합니다. - 피처 그래픽 1024x500: 브랜드, 한 줄 및 휴대폰, 중앙은 비워둠.
- 소셜 스틸 1080x1920, 섹션 1의 안전 영역을 준수.
- Play 메타데이터 규칙, 비디오에도 적용: "#1", "최고", 수상, 사용 후기, 다운로드 유도, 날짜가 있는 혜택 또는 반복되는 키워드, 앱이 하지 않는 일에 대한 언급 금지.
자세한 내용:
references/store-assets.md.
10. 전달
- 메인 Artifact: 네 개의 미리보기, 스틸, 리스팅 텍스트 및 음악 크레딧.
- 형식당 하나의 다운로드 페이지(Artifact
downloads기능). 마스터는 14MB 파트로 분할되며(tools/delivery/split.sh), 브라우저에서 재조립되고 저장하기 전에 SHA-256으로 확인됩니다(tools/delivery/downloads/index.html,tools/editor/test-downloads.mjs로 테스트됨). 한 번의 게시는 최대 64MB를 전송합니다: 여러 배치로 동일한 URL에 파트를 업로드합니다. - 선택적으로 마스터를 Windows 폴더에 복사합니다(구성의
masters_dir_wsl). - 리뷰어가 요청할 때만 Play 또는 소셜에 업로드합니다.
11. 아무것도 보여주기 전에
모든 콘택트 시트를 실제 크기와 컨텍스트에서 직접 보고, references/checks.md의 검사를 실행하십시오: 필름(overlaps.mjs, purity.mjs, errors.mjs), 렌더링(jumps.py, stutter.py), 오디오(-14 LUFS, true peak, 보컬 형태 히트 없음, Whisper 기준 전체 음성) 및 시각적 목록(커서 없음, 다른 앱 없음, 디버그 배너 없음, 깨끗한 상태 표시줄, 개인 데이터 없음, 잘린 텍스트 없음, 철자 오류 없음).
12. 머신 관리
무거운 배치를 실행하기 전에 항상 uptime, free -g 및 Windows 여유 메모리를 확인하십시오. 렌더는 메모리 제한 범위 내에서 실행되며, 한 번에 하나의 Gradle 빌드, 긴 배치 동안 온도를 모니터링합니다(CPU 85°C 또는 GPU 80°C 초과 시 일시 중지). Windows 여유 메모리는 2GB 미만으로 떨어지지 않도록 합니다. 다른 세션의 프로세스나 에뮬레이터를 종료하지 마십시오. 자세한 내용: references/checks.md, "Machine care" 섹션.
13. 정리
Android 에뮬레이터 및 시작된 다른 에뮬레이터를 종료하고, 모니터 및 화면 시간 초과 설정을 복원하고, 녹화 전용 패치 및 임시 구성을 되돌리고, Windows 캡처 폴더를 비우고, 아직 보류 중인 작업을 명확히 명시합니다.
참조
references/capture-60fps.md: Windows 호스트 캡처, 단계별.references/film.md: 필름 페이지 계약, 엔진, 렌더링, 리뷰 시트.references/audio.md: 음악 선택, 비트 그리드, 보컬 컷 검사, 효과, 믹스.references/narration.md: Gemini TTS, 캐스팅, Whisper 검사, 배치, 나레이션 믹스.references/store-assets.md: 스크린샷, 피처 그래픽, Play 규칙.references/checks.md: 사전 리뷰 체크리스트 및 머신 관리.references/lessons.md: 어렵게 얻은 교훈, 규칙 형태.references/tools.md: 모든 도구, 기능 및 호출 방법.