Interactive FMV Short Drama
세로 영상 클립으로 만든 분기형 숏드라마 웹 게임과, 작가가 코드 없이 이야기를 짜는 노드 캔버스 에디터입니다.
내가 한 일
- 작가가 씬과 선택지를 잇고, 클립을 올리고, 버전을 배포하는 노드 캔버스 에디터를 만들었습니다.
- 분기 그래프를 검증하고 엔딩을 판정하는 공용 스키마를 만들었습니다.
- 클립 미리 받기, 페이드 전환, 세이브, QTE 장면, 한국어·영어·일본어 자막을 갖춘 브라우저 플레이어를 만들었습니다.
- 로그인, 세이브 동기화, 이벤트 수집, 리포트 대시보드를 맡는 API 워커를 만들었습니다.
무엇인가
짧은 세로 영상 클립(1080×1920, 클립당 10~15초)으로 만든 브라우저 게임입니다. 시청자가 클립을 보고 선택지를 누르면, 페이드 전환 뒤에 다음 클립이 재생됩니다. 이야기는 여러 화에 걸쳐 갈라집니다. 화마다 배드 엔딩이 있고, 여러 캐릭터의 호감도 시스템이 있으며, 최종 엔딩은 호감도가 가장 높은 캐릭터와 모은 조건의 수로 정해집니다.
하나의 npm workspaces 모노레포 안에 세 부분이 있습니다.
- 에디터: React Flow로 만든 Next.js 노드 캔버스입니다. 노드는 씬이고, 엣지는 선택지입니다.
- 플레이어: 배포된 스냅샷만 읽는 Vite 웹앱입니다. 에디터나 데이터베이스에 의존하지 않습니다.
- 공용 스키마: 분기 그래프, 검증, 엔딩 규칙에 대해 양쪽이 함께 쓰는 계약입니다.
로그인, 세이브 동기화, 분석은 D1을 쓰는 Cloudflare Worker가 맡습니다.
만든 이유
필요한 것이 두 가지였습니다. 첫째, 코드를 모르는 작가와 기획자가 분기형 이야기를 직접 만들고 고칠 수 있어야 했습니다. 둘째, 휴대폰에서 기다림 없이 이어지는 느낌을 줘야 했습니다. 클립이 끊김 없이 이어질 필요는 없었기 때문에, 성능 목표는 시청자가 누르기 전에 다음 클립을 미리 받아 두는 것 하나였습니다. 모든 기술 결정은 이 목표를 기준으로 내렸습니다.
동작 방식
- 재생: Progressive MP4 클립, 하나의
<video>요소, CSS 페이드로 재생합니다. MSE와 HLS는 검토했지만 쓰지 않기로 했습니다. - 미리 받기: 클립이 재생되는 동안 다음에 나올 수 있는 클립을 모두 Blob URL로 받아 두고, 지나간 클립은 해제합니다. 클립은 Cache Storage를 거치며, 홈 화면이 뜬 뒤에는 도달할 수 있는 클립을 백그라운드에서 받습니다.
- 송출: 클립은 내용 해시로 이름 붙인 파일로 Cloudflare R2에 두고 변경 불가 캐시를 적용합니다. 그래서 영상 트래픽이 웹앱 호스트를 거치지 않습니다. 웹앱은 Cloudflare Pages에서 돌아갑니다.
- 저작: 에디터는 업로드한 영상을 FFmpeg로 720p로 변환하고, 저장할 때 그래프를 검증합니다. 엔딩 문구가 없거나 선택지 문구가 다섯 글자를 넘는 경우처럼 문제가 있으면 경고합니다.
- 배포: 에디터가 버전이 붙은 스냅샷을 만들어 먼저 QA로 보내고, 확인을 마친 버전을 LIVE로 올립니다. 배포되는 스냅샷에서는 노드 좌표를 지웁니다.
- 세이브와 로그인: 시청자는 게스트로 플레이하거나, X 또는 Google로 로그인해 세이브를 동기화할 수 있습니다.
- 분석: 플레이어는 시청, 선택, QTE 결과, 엔딩 같은 이벤트를 모아서 Worker로 보냅니다. Worker는 이벤트를 검증하고 중복 없이 D1에 저장합니다. 대시보드에서는 시청자가 몇 화까지 봤는지 확인하고, GA4 수치와 비교하고, CSV로 내려받을 수 있습니다.