개발 취재 노트
여러 폰에서 같은 영상 동시 재생, 영상 서버 없이 만들기 — WebSocket으로 재생 위치만 중계하고 파일은 부분 해시로 대조
영상은 각자 폰에 미리 저장하고, 서버는 WebSocket으로 리더의 재생·정지·재생 위치만 방 단위로 중계하면 된다. 여러 사람이 각자 폰으로 같은 안무 영상을 보며 대형·동선을 겹쳐 보는 연습용 웹앱(formation)을 이렇게 옮겼다. 서버는 Cloudflare Worker와 Durable Object로 두고 HTTPS 주소로 배포하면, 연습할 때마다 노트북 서버를 켜고 같은 와이파이에 연결한 뒤 바뀐 IP를 알려 주던 수고가 사라진다 .
결론
세 조각으로 나뉜다. 영상 바이트는 서버를 지나지 않는다. 서버는 Cloudflare Worker와 방별 Durable Object(DO)이고, 폰에서 파일 지문 계산에 crypto.subtle을 쓰므로 HTTPS로 배포해야 한다 .
- 재생: 리더(조작하는 사람)와 뷰어(따라 보는 사람) 모두 미리 받은 파일을
<input type=file>로 골라URL.createObjectURL(file)로 재생한다 . - 동기화: 리더가 재생 상태를 WebSocket 메시지로 보내면 서버(방 하나당 Durable Object 하나)가 같은 방의 뷰어들에게 뿌린다. 뷰어는 평소 1배속으로 그냥 흐르게 두고, 리더와 임계값 이상 벌어졌을 때만 seek한다. 임계값이
RESYNC_THRESHOLD(로컬판에서 마지막으로 확인된 값 0.30초)이고, seek이 끝나는 데 걸리는 시간만큼 앞질러 요청하는 보정값이seekComp(초기 0.45초, 착지 오차로 자동 학습)다 . - 같은 파일인지 확인: 앞·중간·끝 각 8MB만 읽는 부분 해시(지문)를 리더와 뷰어가 각자 계산해 비교한다 .
파일 사전 공유는 별도로 해야 한다. 아래는 이 세 조각을 순서대로 다룬다.
상황
이 웹앱에서 리더는 재생·정지·재생 위치를 조작하고, 뷰어들은 자기 폰의 영상을 그 상태에 맞춘다. 동선 파일(formation.json, 시간에 따른 대형 데이터)을 붙이면 영상 위에 대형을 그리고, 뷰어가 남기는 표시(마크)도 리더에게 전달된다. 기존에는 노트북 서버가 영상과 SSE 신호를 함께 제공했다. SSE는 서버가 브라우저에 이벤트를 계속 보내는 단방향 통신 방식이다 .
클라우드판 구조는 다음과 같다. DO(Durable Object)는 이 설계에서 방별 상태와 연결을 관리하는 단위다 .
[리더 / 뷰어 브라우저] ─ 영상은 각자 로컬 파일
│ WebSocket: 재생 상태·동선·마크
▼
[Cloudflare Worker] ─ 페이지 제공 + 방 개설·목록 API
├─ Lobby DO 하나 : 활성 방 목록
└─ 방별 Room DO : 방 상태 저장 + 연결된 참가자에게 전달
동선 파일은 선택 사항이다. 리더가 붙이면 Room DO가 저장했다가 뷰어에게 전달하므로, 뷰어는 따로 고르지 않는다 .
증상
문제는 반복되는 준비 작업이었다. 연습할 때마다 노트북 서버를 켜고, 모두 같은 와이파이에 접속하고, 서버 IP를 알려 줘야 했다 .
처음에는 클라우드 영상 전송 비용으로 논의가 흘렀다. 720p·2Mbps·194초 영상을 15명이 여러 차례 재생하면 월 100GB가 넘는 전송량이 나온다는 가정으로 저장소나 VM을 검토했다. 이는 세션 당시의 가정에 따른 계산이며 실측 사용량이나 청구액이 아니다 .
원인
불편의 원인은 영상 제공과 재생 신호 중계가 노트북 서버 한 곳에 묶여 있다는 점이었다. 전환점은 “영상을 스트리밍 하거나 다운로드하게 하진 않아도 돼”라는 요구 정리였다. 영상은 카톡 등으로 사전 공유하고, 고정 주소의 서버는 동기화만 담당하면 됐다 .
영상 전송을 빼면 중계할 데이터가 KB 단위 JSON 신호로 줄어든다 . 다만 이를 서버 전체 비용이 0이라는 보장으로 읽으면 안 된다. Durable Objects에는 요청·실행 시간·저장소 사용 등에 따른 과금 기준이 있고, 이 글에서 확인된 것은 영상 중계를 제거한 설계이지 장기 운영 비용 측정이 아니다. Cloudflare 요금 문서
대신 새 문제가 생긴다. 각자 다른 인코딩·길이·시작점의 영상을 준비하면 같은 재생 위치 신호를 받아도 다른 장면을 보게 된다 .
해결
1. 영상은 선택한 로컬 파일로 재생
<input type=file>로 고른 File을 URL.createObjectURL(file)로 <video>에 연결한다. 이 프로젝트는 예전에 서버에서 받은 영상을 통째로 Blob으로 메모리에 올렸다가 iOS 메모리 한도에 걸려 그 방식을 버린 적이 있다. 고른 File의 object URL은 디스크에서 필요한 구간만 읽는 방식이라 원리가 다르다고 봤지만, 서버 영상 폴백이 없는 설계라 실기기 검증 1순위로 뒀다 .
데스크톱 자동 검증에서는 재생 준비 상태 readyState=4를 확인했다. 이후 “아이폰도 되고.. 데스크탑도 되는데”라는 실제 사용 확인이 나왔다. 이 기록만으로 긴 영상의 메모리 사용량이나 모든 모바일 브라우저의 동작까지 검증됐다고 할 수는 없다 .
2. 재생 위치 동기화: 서버는 전달만, 판단은 뷰어가
서버 쪽. 리더의 조작 메시지를 받은 Room DO는 마지막 상태를 기억하고 리더를 제외한 나머지 소켓에 뿌린다. 새 뷰어가 붙으면 마지막 상태(스냅샷)를 먼저 보낸다. 세션에서는 스냅샷 전달, 리더 제외 브로드캐스트, 뷰어→리더 마크 전달, 인원수 증감, 리더 종료 시 방 삭제를 브라우저 WebSocket으로 확인했다 . 메시지 형식은 로컬판 SSE 때의 {type:'sync'|'formation'|'mark'|'reload'}를 그대로 유지해 클라이언트 변경을 전송 래퍼 교체 수준으로 줄였다 .
아래는 이 구조를 설명하기 위한 예시 코드다. 저장소 구현을 복사한 것이 아니며, 필드 이름과 코드 형태는 예시의 결정이다.
// Room DO 최소 골격 (WebSocket Hibernation API 사용 예시)
export class Room {
constructor(ctx) { this.ctx = ctx; }
async fetch(req) {
const pair = new WebSocketPair();
this.ctx.acceptWebSocket(pair[1]); // 유휴 시 DO가 잠들어도 연결 유지
const last = await this.ctx.storage.get('lastSync');
if (last) pair[1].send(last); // 새 참가자에게 마지막 상태 전달
return new Response(null, { status: 101, webSocket: pair[0] });
}
async webSocketMessage(ws, msg) {
const m = JSON.parse(msg);
if (m.type === 'sync') {
await this.ctx.storage.put('lastSync', msg);
await this.ctx.storage.setAlarm(Date.now() + 3600_000); // 1시간 무조작 시 alarm
}
for (const s of this.ctx.getWebSockets()) if (s !== ws) s.send(msg);
}
async alarm() { /* 소켓을 닫고 저장소를 비운 뒤 Lobby에 삭제 통지 */ }
}
// 리더가 보내는 sync 메시지 (예시)
// { type: 'sync', playing: true, time: 12.4, rate: 1, sentAt: 1735000000000 }
메시지에 재생 여부·재생 위치·배속·보낸 시각이 있으면 뷰어가 “지금 리더는 몇 초쯤인가”를 계산할 수 있다. 세션에서는 이 계산 결과를 expectedTime()(리더 추정 시각)이라 불렀다 .
두 가지는 세션에서 확인되지 않는다. 첫째, expectedTime()의 정확한 식과 리더·뷰어 기기 시계 차이를 보정하는 방법은 인용할 턴이 없다. 확인되는 것은 뷰어가 받은 표본으로 오프셋을 EMA(지수 이동 평균)로 평활한다는 언급 정도다 . 위 sentAt은 형식 예시일 뿐이고 시계 보정은 직접 설계해야 한다. 가장 단순한 형태는 expected = time + (playing ? (now - sentAt) / 1000 * rate : 0)이지만, 이는 두 기기 시계가 같다고 가정하는 이 글의 예시이며 세션에 나온 식이 아니다. 시계가 어긋난 폰에서는 이 값 자체가 틀리므로 받은 표본의 오프셋을 평활하는 식의 보정이 필요하다. 둘째, 전송 시점은 로컬판 기준으로만 확인된다. 리더가 200ms마다(초당 5회) 주기적으로 sync를 보냈고, 뷰어의 보정 판단은 별도 루프에서 돌았다 . 조작 때만 보내는 방식이 아니므로 드리프트는 이 주기 전송과 뷰어의 seek 임계값으로 잡는다. 클라우드판 WebSocket에서 이 주기와 RESYNC_THRESHOLD를 다시 잰 기록은 없다.
뷰어 쪽. 로컬판에서 몇 번 실패한 끝에 정착한 규칙이 클라우드판에 그대로 재사용됐다 .
- 재생 중에는
playbackRate를 건드리지 않고 항상 리더 배속(보통 1)으로 둔다. 배속을 조금씩 바꿔 따라잡는 방식은 iOS에서 오히려 끊김과 진동을 만들었다 . - 리더 추정 시각과의 차이가
RESYNC_THRESHOLD보다 클 때만 seek한다. 이 값은 0.75초에서 0.35초로 내려갔고, 아래 보정을 넣은 뒤 0.30초가 됐다 . - seek은 끝나는 데 약 0.5초가 걸려서 늘 그만큼 뒤에 착지했다. 그래서
exp + seekComp위치로 앞질러 요청하고, 착지한 뒤 남은 오차로seekComp를 다시 학습한다. 초기값 0.45초에서 시뮬레이션상 착지 오차가 0.5초에서 0.05초로 줄었다. 연속 seek을 막으려고 쿨다운 1초를 두고 착지 측정은 0.8초 뒤에 했다 .
// 뷰어 보정 흐름 (설명용 의사코드)
const exp = expectedTime(); // 리더 추정 시각
if (video.playbackRate !== leader.rate) video.playbackRate = leader.rate;
if (Math.abs(video.currentTime - exp) > RESYNC_THRESHOLD && cooldownOver()) {
video.currentTime = exp + seekComp; // seek 지연만큼 앞질러 요청
// 0.8초 뒤 (video.currentTime - expectedTime()) 잔차로 seekComp를 갱신
}
이 값들은 사용자의 아이폰(세션에서 12 Pro로 언급)에서의 측정에서 나왔고 , 기기마다 seek 지연이 다를 수 있어 seekComp를 자동 학습하게 했다. 실기기 확인은 “됐다!”까지였고 최종 오차 수치는 세션에 남아 있지 않다 .
테스트 함정. 브라우저 두 탭 자동 검증에서 뷰어가 0초에서 움직이지 않은 적이 있다. 서버는 sync를 정상 방송했고 뷰어를 새로 불러오자 리더를 따라갔다(0.40→0.82→1.23초). 검증용 클립이 1.39초짜리라 끝에서 멈추는 것도 실제 곡(3분 이상)과 무관한 아티팩트였다. 멈춤은 리더가 끝난 뒤 합류한 뒤늦은 상태와 검증 중 상태 조작이 겹친 탓으로 판단했다 . 짧은 클립으로는 동기화 품질을 잴 수 없으니 실제 길이의 영상으로 시험한다.
3. 파일 대조는 부분 해시로
세션에서 이 지문은 “iOS 메모리 회피형 부분 해시(앞·중간·끝 8MB)”로 구현됐다 . 이유를 풀어 쓰면 이렇다. crypto.subtle.digest는 입력을 스트리밍으로 받지 못하고 통째로 받으므로(MDN), 수백 MB 영상 전체를 해시하려면 파일 전체를 메모리에 올려야 하고 앞서 겪은 iOS 메모리 문제를 되풀이할 수 있다. 이 풀이는 세션 대화가 아니라 API 특성에 기댄 설명이다. 그래서 file.size와 file.slice()로 뗀 앞·중간·끝 조각만 해시한다.
흐름은 이렇다 .
- 리더가 파일을 고르면 지문을 계산한다.
- 방을 만들 때 지문을 이름·길이와 함께 Lobby에 등록한다.
- 뷰어가 방에 붙으면 스냅샷의 방 메타에서 지문을 받는다.
- 뷰어가 자기 파일을 고르면 같은 알고리즘으로 계산해 뷰어 브라우저에서 비교한다. 다르면 “리더와 다른 영상 파일이에요”라고 안내하고 참여를 막는다.
아래는 설계 설명용 예시다. 저장소 구현을 복사한 코드가 아니다. 앞·중간·끝 8MB를 읽는 방식만 세션에 있고 , 작은 파일 처리 기준·크기 직렬화·중간 오프셋·SHA-256 선택은 이 예시의 결정이다.
const CHUNK = 8 * 1024 * 1024; // 예시에선 8 MiB로 잡음
async function partialFingerprint(file) {
const size = file.size;
const offsets = size <= CHUNK * 3
? [0]
: [0, Math.floor(size / 2 - CHUNK / 2), size - CHUNK];
const parts = [new TextEncoder().encode(String(size))];
for (const off of offsets) {
const end = size <= CHUNK * 3 ? size : off + CHUNK;
parts.push(new Uint8Array(await file.slice(off, end).arrayBuffer()));
}
const joined = new Blob(parts);
const digest = await crypto.subtle.digest('SHA-256', await joined.arrayBuffer());
return [...new Uint8Array(digest)]
.map(b => b.toString(16).padStart(2, '0')).join('');
}
이 예시는 영상 바이트를 최대 24MiB 읽는다(세션의 “8MB”를 MiB로 옮긴 것은 예시의 선택). 조각과 합친 버퍼가 함께 존재할 수 있으므로 최대 메모리 사용량이 24MiB라는 뜻은 아니다. 리더와 뷰어의 알고리즘이 한 글자라도 다르면 항상 불일치가 나므로 양쪽에 같은 코드를 써야 한다.
한계도 있다. 읽지 않은 구간에서만 다른 두 파일은 구별할 수 없다. 카톡 등으로 같은 파일을 나눠 갖는 전제라면 실용적인 검사라는 것이 이 글의 판단이다(세션에서 이 한계를 따로 논의한 기록은 없다). 이 API는 보안 컨텍스트에서만 쓸 수 있다. 폰 테스트는 HTTPS에서 해야 한다. 일반 HTTP의 PC IP로 접속하면 crypto.subtle을 쓸 수 없다는 제약을 세션에서도 확인했다 .
자동 검증에서는 두 탭에 동일한 영상 바이트를 전달해 지문 일치와 참여를 확인했다. 다른 파일의 참여 차단은 수동 테스트 항목으로 남았고, 이 세션에는 그 결과가 명시돼 있지 않다 .
4. 별도 DB 대신 DO 내장 저장소
“외부 DB가 필요 없다”와 “저장할 상태가 없다”는 다르다. Lobby DO가 방 목록을, Room DO가 방 메타데이터·동선·마크·마지막 sync를 자기 내장 저장소에 둔다. 방은 1시간 조작이 없으면 사라지므로 방보다 오래 살아야 할 데이터가 없어서 별도 DB 서비스를 두지 않았다 .
방 정리는 alarm으로 했다. 리더가 조작할 때마다 setAlarm(now + 1시간)으로 다시 맞추고, 발화하면 Room DO가 소켓을 닫고 저장소를 비운 뒤 Lobby에 삭제를 알린다. 통지 없이 죽은 방은 Lobby가 목록 조회 때 늦게 정리한다 . 당시 구현 보고는 실제 1시간 경과 후 alarm 발화를 배포 뒤 확인할 항목으로 남겼다. 이 세션만으로 만료 동작의 실측이 끝났다고 쓰지는 않는다 .
덤 — 파일 선택 실패처럼 보였던 스크립트 초기화 오류
안드로이드의 웨일 브라우저에서는 파일을 골라도 버튼이 켜지지 않았고, HTTPS 배포 뒤에도 남았다. 화면 디버그 로그에는 crypto.subtle: true인데도 window.FormationFingerprint가 undefined라는 예외가 찍혀 있었다. 페이지 스크립트가 첫 줄에서 죽으면 파일 핸들러도 WebSocket 연결도 버튼 활성화도 함께 멈춘다 .
fingerprint.js가 로드되지 않은 것이므로, 웨일의 추적 방지가 이 이름을 브라우저 지문 추적 스크립트로 오인해 막았다고 판단했다. 파일명을 mediacheck.js로 바꾸자 “된다!! 됐어!”라는 확인이 나왔다. 데스크톱에서는 같은 조건에서 정상이었다는 대조는 있으나 차단 규칙 자체를 확인한 기록은 없으므로, 모든 브라우저에서 특정 파일명을 금지해야 한다는 규칙으로 일반화하지는 않는다 .
취재 후기 — 영상을 어디로 보낼지가 아니라, 보내야 하는지부터
리더와 뷰어를 브라우저 두 탭으로 시험했다.
crypto.subtle: true야. 그런데 window.FormationFingerprint가 없다는 오류가 맨 위에서 나와 .fingerprint.js가 안 올라온 거네. 데스크톱은 같은 주소에서 정상이니 웨일만의 문제야 .mediacheck.js로 바꿨더니 “된다!! 됐어!” 하고 웨일에서도 버튼이 켜졌어 .