게임에 대한 영상 만들기
Playgama를 위한 게임 영상을 만드는 방법입니다. 영상은 Playgama가 아닌 게임 자체의 모습을 닮습니다: 게임의 색상, 폰트, 패널 및 사운드를 그대로 사용합니다. Playgama는 로고(시작 부분 3초 인트로와 모서리의 작은 버그)와 링크만 추가합니다. 나머지 작업은 세 가지에 집중됩니다: 스토리는 사실적이고 구체적이며, 게임플레이는 깔끔하게 촬영되고, 첫 1초가 다음 1초를 잡아당깁니다.
번들 파일:
| 파일 | 설명 |
|---|---|
assets/playgama-ai-logo.svg, .png | 공식 Playgama AI 로고(591×133): 보라색 알약 모양에 playgama 워드마크, 그 옆에 회색 상자에 "AI"가 오려진 형태입니다. PNG는 4배 투명도입니다. |
assets/template/ | HyperFrames 스타터 비디오(1920x1080): 인트로, 세 개의 게임플레이 슬롯, 제목, 엔드 카드, 음악 및 음성 트랙이 포함됩니다. 상단의 하나의 테마 블록에 게임의 비주얼 스타일이 저장됩니다. |
assets/sting-preview.mp4 | 인트로 애니메이션이 어떻게 보여야 하는지 보여주는 미리보기, 게임 영상이 시작되는 자리 표시자로 전환됩니다. |
assets/sting.html | 순수 CSS(7KB, 라이브러리 없음)로 작성된 인트로 애니메이션 단독입니다. 어떤 페이지나 비디오 도구에든 넣을 수 있습니다. |
assets/playgama-ai-sting.html | 재생, 속도, 스크러빙 컨트롤이 있는 리뷰 페이지로 구현된 동일한 애니메이션입니다. 브라우저에서 열고 게임 스크린샷을 올리면 로고가 게임 위에 표시되는 것을 확인하거나 디자이너에게 전달할 수 있습니다. |
scripts/film.mjs, scripts/vclock.js | 모든 웹 게임을 프레임 단위로 촬영하여 어떤 크기로든 부드러운 MP4로 만듭니다. |
scripts/doctor.mjs, scripts/new-video.mjs | 시스템을 확인하고 설치할 항목을 알려줍니다. 비디오 폴더(템플릿, gsap, puppeteer)를 생성합니다. |
scripts/palette.mjs | 게임의 스크린샷에서 샘플링한 게임 색상입니다. 코드에 테마가 없을 때 사용합니다. |
scripts/voice.mjs | 음성 해설: ElevenLabs, OpenAI, Gemini, Cartesia(또는 무료 드래프트 음성)에서 가져오고, 귀로 선택할 수 있는 페이지를 제공하며, 음악이 음성 아래로 낮아진 음성 트랙을 생성합니다. |
references/story-and-script.md | 형식, 실제 예시 대사가 포함된 비트 시트, 화면 자료에 대한 규칙. |
references/game-look.md | 게임의 비주얼 스타일 가져오기: 색상, 폰트, 패널, 모션, 사운드를 찾을 위치, 템플릿의 테마. |
references/filming.md | 촬영 방법: 준비, 설정 및 프레임별 스크립트, 순간 선택, 첫 프레임. |
references/voice-and-music.md | 음성 해설(텍스트 음성 변환 또는 직접 녹음), "Playgama" 발음, 테이크 확인, 음악 레벨. |
references/edit-and-render.md | HyperFrames에서 조합: 템플릿, 카드, 세로 컷, 체크, 렌더링, 리뷰. |
필요한 것
macOS, Linux, Windows에서 동일하게 작동합니다.
node scripts/doctor.mjs로 시스템을 확인하고 설치할 항목을 알려줍니다.node scripts/new-video.mjs <folder>로 비디오 폴더를 생성합니다: 템플릿,gsap.min.js, 그리고 촬영을 위한 puppeteer가 포함됩니다. 이후 모든 명령은 해당 폴더에서 실행하세요.
- 촬영: Node 22+ (HyperFrames에서 필요), PATH에 ffmpeg와 ffprobe, 그리고 puppeteer가 필요합니다.
film.mjs는 실행 디렉토리 또는 스크립트 옆에서 이를 찾습니다. 게임은 URL(개발 서버 또는 빌드 위의 정적 서버)에서 실행 가능해야 합니다. - 조합 및 렌더링: HyperFrames (
npx [email protected]; 첫 실행 시 약 370MB의 패키지와 헤드리스 브라우저를 다운로드합니다). - 자체 음성이 아닌 경우: ElevenLabs 또는
scripts/voice.mjs가 작동하는 다른 서비스의 키가 필요합니다. 한 번 설정(references/voice-and-music.md)하고, Whisper 또는 다른 음성-텍스트 변환 도구로 테이크를 확인하세요. - 음악: 사용 허가를 받은 악기 트랙.
워크플로우
이 순서대로 작업하세요. 각 단계는 다음 단계를 준비하며, 두 번의 승인 포인트가 시간을 절약해 줍니다.
- 영상에 동의합니다. 다른 작업을 시작하기 전에 형식, 길이 및 목표를 결정합니다(아래 표 참조). 영상의 용도를 물어보세요: 플레이어용인지, 스토어 페이지용인지, 다른 개발자용인지, Playgama 챌린지나 카탈로그용인지.
- 실제 스토리를 수집합니다. 실제 프롬프트, 타임스탬프, 커밋, 버그, 숫자 및 스크린샷을 수집합니다(
references/story-and-script.md). 게임이 AI 에이전트로 빌드된 경우, 채팅 기록이 가장 풍부한 소스입니다: 읽어보고 시간과 정확한 인용을 기록하세요. - 게임의 비주얼 스타일을 가져옵니다 (
references/game-look.md): 자체 파일에서 색상, 폰트, 패널, 로고, 음악 및 UI 사운드를 가져옵니다. 이를 템플릿의 테마 블록에 작성하세요. - 스크립트를 작성한 후 승인을 위해 멈춥니다. 음성 대사와 화면에 표시될 내용을 각 행에 하나씩 작성합니다. 개발자가 음성 제작 전에 문구와 비주얼 스타일을 승인합니다: 녹음된 음성을 다시 녹음하려면 다시 녹음해야 합니다.
- 게임플레이를 촬영하고 스크린샷을 찍습니다.
scripts/film.mjs를 사용하여 전달 크기로 촬영합니다(아래 "게임의 사진" 및references/filming.md참조). 스크립트의 각 비트당 하나의 테이크를 계획하고, 각각 몇 초씩, 게임 자체의 컨트롤이나 디버그 훅으로 준비합니다. - 스틸 이미지를 만듭니다. 게임의 비주얼 스타일로 제작합니다. 실제 코드(실제 줄 번호 포함), 실제 프롬프트와 에이전트 단계, 웹 페이지 및 표지를 사용합니다.
- 음성을 녹음하고 음악을 선택합니다 (
references/voice-and-music.md,scripts/voice.mjs). 인간이 음성 테이크를 듣습니다. 텍스트-음성 변환은 어떤 대본도 포착할 수 없는 방식으로 실패하기 때문입니다. - 조합하고 렌더링합니다. 템플릿을 사용하여(
references/edit-and-render.md). 체크를 실행하고, 렌더링한 후 몇 초마다 프레임을 추출하여 완료라고 부르기 전에 모든 프레임을 확인합니다. - 패키징합니다: 썸네일(1280x720, 게임의 최고의 프레임, 게임 자체 폰트로 최대 4개의 큰 단어), 제목 및 게임 링크가 포함된 설명.
형식을 먼저 선택하세요
| 비디오 | 형태 | 길이 | 시작 방식 |
|---|---|---|---|
| Short / Reels / TikTok | 9:16, 1080x1920 | 15–35 초 | 첫 프레임에 게임플레이; 로고는 작은 모서리 버그로만 표시 |
| 트레일러 / 프로모 | 16:9, 1920x1080 | 30–90 초 | 인트로(3초), 그 다음 최고의 게임플레이 |
| "제작 방법" 스토리 | 16:9 | 3–6 분 | 훅 라인이 있는 게임플레이, 그 다음 인트로 또는 제목 |
| 튜토리얼 ("Playgama MCP로 게시") | 16:9 | 각 파트당 1–3 분 | 인트로, 그 다음 결과를 먼저, 그다음 단계 |
Short는 첫 1초에 결정됩니다. 시청자가 머물거나 스와이프합니다. 한눈에 읽히는 전체 화면 게임플레이로 시작하는 Short는 긴 코멘트 카드, 게임 메뉴, 채팅 상자 등 읽을 거리로 시작하는 것보다 훨씬 더 많은 시청자를 유지합니다. 따라서 Short는 인트로나 텍스트로 절대 시작하지 않습니다.
게임의 비주얼 스타일
영상은 게임처럼 보입니다: 게임을 해본 사람이라면 어떤 프레임에서든 알아볼 수 있어야 합니다. 비주얼 스타일은 Playgama가 아닌 게임 자체에서 가져옵니다(references/game-look.md):
- 색상: UI와 코드에서 가져옵니다: 배경, 패널, 텍스트, 버튼 및 강조 색상입니다. 코드에 테마가 없으면
scripts/palette.mjs로 메뉴와 HUD를 샘플링합니다. - 폰트: 모든 폰트는 게임과 일치해야 하며, 코드 폰트도 포함됩니다.
- 제목은 게임의 제목 또는 로고 폰트, 레이블과 프롬프트는 UI 또는 텍스트 폰트를 사용합니다.
- 코드와 도구 호출은 게임의 정신에 맞는 고정폭 폰트를 사용합니다: 픽셀 아트에는 픽셀 폰트, 어둡거나 레트로 게임에는 타자기 폰트.
- 템플릿의 DM Mono는 자리 표시자일 뿐입니다.
- 패널 및 버튼: 게임 패널 모양의 카드, 엔드 카드의 버튼은 게임의 메인 버튼과 같은 모양, 자체 아이콘 및 로고.
- 모션 및 사운드: 게임의 UI처럼 움직입니다(바운시, 차분함, 또는 픽셀 단계). 게임 자체의 음악과 UI 사운드를 우선 사용합니다.
- 검은 슬라이드가 아닌 사진 위의 카드. 어두워진 게임 프레임 위에 프롬프트나 단계를 배치하고, 게임플레이 아래쪽을 게임의 배경색으로 어둡게 한 후 제목을 낮게 배치합니다. 이름만 있는 카드보다는 실제 사진을 나란히 배치하는 것이 좋습니다.
색상, 폰트 및 패널 모양은 템플릿의 스타일 최상단에 있는 하나의 테마 블록에 들어갑니다.
게임의 사진
키트에는 게임 푸티지가 포함되어 있지 않습니다. 게임의 모든 사진은 개발자 본인의 게임에서 scripts/film.mjs(references/filming.md)로 직접 촬영합니다. 이는 비디오, 썸네일, 카드 뒤의 프레임 및 리뷰 페이지를 포함합니다.
- 클립: 각 비트당 하나의 테이크, 예:
node scripts/film.mjs --url http://localhost:5173 --out clips/gameplay-1.mp4 --seconds 6. - 스크린샷: 동일한 명령에
--still <seconds>를 추가하면 해당 시점의 PNG 하나가 저장됩니다. 단계에서 게임 사진이 필요할 때마다 하나씩 찍습니다:- 메뉴와 HUD, 비주얼 스타일 읽기용 (
scripts/palette.mjs); - 프롬프트 카드나 제목 뒤의 프레임;
- 썸네일 및 엔드 카드;
- 게임 위의 인트로, 모서리 버그가 HUD와 겹치지 않는지 확인. 스크린샷을
assets/playgama-ai-sting.html에 드롭하거나 첫 번째 클립을 템플릿에 넣고npx [email protected] snapshot . --at 3.5 --describe false실행.
- 메뉴와 HUD, 비주얼 스타일 읽기용 (
- 세로 컷은 1080x1920으로 촬영하며, 게임의 카메라를 이에 맞게 재구성합니다.
- 게임을 여기서 실행할 수 없는 경우(네이티브 빌드, 로그인 장벽, 온라인 전용 게임), 개발자에게 전달 크기의 화면 녹화 및 스크린샷을 요청하세요. 화면에 커서나 알림이 없어야 합니다. 다른 게임, 스토어 페이지 또는 이 키트의 예제 사진으로 빈 공간을 채우지 마세요.
Playgama가 추가하는 것
로고와 링크만 추가합니다. Playgama의 보라색과 어두운 판은 로고와 인트로에 속하며, 비디오 자체에는 속하지 않습니다.
- 로고:
assets/playgama-ai-logo.svg공식 파일입니다: 보라색#9747ff알약 모양에 흰색 워드마크, 그리고 회색#d2d2d2상자에 "AI"가 오려져 있습니다.- 그대로 사용하세요: 색상 변경, 늘리기, 효과 추가, 간격 변경 또는 다시 그리지 마세요.
- "AI"는 구멍이므로 로고 뒤의 내용이 보입니다.
- 알약 높이의 최소 절반 이상의 여유 공간을 확보하세요.
- 모서리 버그로 사용할 때 1920 프레임에서 약 200px 너비입니다. 게임의 HUD가 해당 모서리에 있으면 HUD를 가리지 않도록 다른 모서리로 이동하세요(
references/edit-and-render.md).
- 링크: Playgama로 연결되는 링크는 게임 자체 페이지로 연결됩니다: 엔드 카드와 설명에 포함됩니다.
인트로 스팅
Playgama의 아이덴트, 예를 들어 트레일러 전에 퍼블리셔 로고가 나오는 것과 같습니다: 약 3초, assets/template/index.html에 미리 제작되어 있습니다. 모든 비디오에서 자체 색상과 타이밍을 유지하며, 그 이후는 게임의 것입니다. assets/sting-preview.mp4가 자리 표시자로 전환되는 모습을 보여줍니다. 개발자 게임 위에서 보려면 게임의 스크린샷 또는 클립을 찍으세요("게임의 사진" 참조).
- 구성: 부드러운 보라색 글로우가 있는 어두운 배경에서 보라색 알약이 중심에서 자랍니다(0.05초, 0.55초 동안). 흰색 playgama 워드마크가 왼쪽에서 오른쪽으로 나타납니다(0.42초). 회색 상자가 알약 옆에 튀어나오고(0.92초), "A"와 "I"가 그 안에서 잘립니다(1.12초, 1.27초). 알약 위로 빛의 띠가 지나갑니다(1.55초).
- 전환: 로고 전체가 19% 크기로 오른쪽 상단 모서리로 날아가며, 1920×1080 프레임의 상단과 오른쪽에서 39px 떨어집니다(2.75초, 0.62초 동안). 게임플레이가 아래에서 페이드 업되는 동안(3.0초) 버그로 그 자리에 남습니다.
- 부분은 공식 파일의 자체 모양에서 240px 높이로 그려지므로 인트로가 정확히 로고로 끝납니다.
- 변경: 타이밍을 유지하세요. 콜드 오프닝(스토리)을 먼저 넣으려면 인트로를 나중에 시작하세요: 템플릿에서
S를 설정합니다(references/edit-and-render.md). 9:16 컷의 경우 빌드를 생략하고 첫 프레임부터 버그를 모서리에 표시합니다.
실수로부터 얻은 규칙
- 화면에는 실제 자료만 표시합니다.
- 실제 프롬프트, 실제 숫자, 실제 타임스탬프 및 실제 코드를 표시합니다.
- 숫자가 예시용이어야 한다면, 화면에 "예시 데이터"라고 표시하는 동안 내내 표시하세요.
- 인용, 댓글, 플레이어 수 또는 리뷰를 절대 조작하지 마세요. 조작된 숫자를 확인한 시청자는 나머지도 신뢰하지 않습니다.
- 화면의 프롬프트는 개발자의 말입니다.
- 비디오 언어로 번역하되, 단어를 바꾸지 마세요.
- 긴 프롬프트는 요약하지 말고 "[…]"로 자릅니다.
- 에이전트 단계는 실제 도구 호출을 실제 순서로 표시합니다. 예:
create_application→start_archive_upload→get_archive_status(통과) →publish_sandbox(공개 링크).
- 자신의 아트만 사용합니다. 다른 게임의 캐릭터, 로고 또는 아트를 표시하지 마세요. 게임이 "비슷하더라도" 다른 게임을 언급하지 말고 장르를 말하세요("공포 탈출 게임").
- Playgama는 "플레이-가-마"로 발음합니다. 영어 음성은 "play-GAY-ma"라고 말하지 않도록 조정합니다(
references/voice-and-music.md). - 모든 음성 테이크를 텍스트(대본)와 비교하여 확인하고, 사람이 듣습니다. 텍스트-음성 변환은 문장을 반복하거나, 아무도 쓰지 않은 문장을 추가하거나, 자체 지침을 소리 내어 읽거나, 마지막 음절을 삼키는 경우가 있었습니다. 각각 자체적으로는 괜찮게 들렸던 테이크에서 발생했습니다.
- 첫 번째 게임플레이 프레임은 1초 이내에 읽을 수 있어야 하며, 메뉴나 로딩 화면이 아니어야 합니다.
- Short는 이 프레임으로 시작합니다. 트레일러나 스토리는 인트로나 콜드 오프닝 직후에 도달합니다.
- 최고의 순간을 촬영하세요. 레벨의 시작이 아닙니다.
- 게임플레이의 처음 2초 내 텍스트: 최대 4개의 큰 단어.
- 푸티지는 기계에 남아 있습니다. HyperFrames의
snapshot은 Gemini 또는 Google 키가 설정되어 있을 때 프레임을 Gemini로 보내 설명을 생성하며, 비디오 폴더의.env파일을 읽습니다. 모든snapshot에--describe false를 전달하고,voice.mjs의 공유 키 파일에 음성 키를 보관하고 비디오 폴더에는 두지 마세요.
완료되었을 때
개발자는 다음을 받습니다:
- 마스터 MP4와, 크기가 큰 경우 작은 미리보기;
- 썸네일;
- 제목, 설명(게임 링크, 긴 비디오의 챕터, #playgama) 및 고정 댓글 내용이 포함된 텍스트 파일.
각 파일의 위치와 개발자가 결정해야 할 사항(게시 시간, 듣지 못한 음성 테이크, 확인하지 못한 모든 것)을 알려주세요.