본문으로 건너뛰기

매장 5개를 하나의 타임라인으로 맞추는 StoreSync 실험

장일소

2026.10.14

매장 5개를 하나의 타임라인으로 맞추는 StoreSync 실험


처음 목표는 단순했다.

“매장 5개에서 각각의 블루투스 스피커를 연결해서 같은 음악이 동시에 나오게 할 수 있을까?”


처음에는 유튜브 링크 기반 MVP로 시작했다.
관리자가 YouTube 링크를 등록하고, 각 매장 PC에서는 /embed/STORE1, /embed/STORE2 같은 전용 플레이어 URL을 열어두면 중앙에서 재생 명령을 받는 구조였다.

하지만 실제 테스트를 하면서 알게 된 건 명확했다.

유튜브 iframe 방식은 빠르게 MVP를 만들기에는 좋지만, 정밀한 싱크를 맞추기에는 한계가 있다.
광고, 버퍼링, iframe 제어 제한, 브라우저 상태, 네트워크 차이 때문에 매장 간 박자를 맞추기는 어렵다.

그래서 방향을 바꿨다.

YouTube에서 직접 음원 방식으로 전환

이후에는 직접 업로드한 음원을 Web Audio API로 재생하는 방식으로 바꿨다.

현재 구조는 이렇다.

관리자 페이지
→ 재생할 플레이리스트 선택
→ 대상 매장 선택
→ 서버 기준 startAt 생성
→ 각 매장 플레이어가 같은 시각에 같은 음원 위치를 재생



각 매장은 별도 로그인 없이 URL 자체로 구분한다.

/embed/STORE1
/embed/STORE2
/embed/STORE3
/embed/STORE4
/embed/STORE5



이 구조 덕분에 매장 PC에서는 단순히 자기 매장 URL만 열어두면 된다.

플레이리스트 반복과 다음 곡 자동 진행

초기에는 한 곡이 끝나면 다음 곡으로 넘어가지 않는 문제가 있었다.
그래서 플레이리스트 엔진을 추가했다.

지원하는 모드는 다음과 같다.

순차 1회
전체 반복
1곡 반복
랜덤



곡이 끝나면 /api/advance-session이 다음 곡을 계산하고, 모든 매장이 같은 새 세션을 받아서 다음 곡으로 이동한다.

중요한 점은 모든 매장이 각자 다음 곡으로 넘어가면 안 된다는 것이다.
그래서 현재는 대상 매장 중 첫 번째 매장만 다음 곡 진행 요청을 할 수 있게 했다.

STORE1 + STORE2 대상이면
STORE1만 다음 곡 advance 가능
STORE2는 요청해도 거절



이렇게 하지 않으면 매장별로 미세하게 다른 타이밍에 ended가 발생하면서 서로 다른 곡으로 넘어가는 문제가 생긴다.

블루투스 스피커 변수

처음에는 싱크가 꽤 잘 맞았다.
하지만 블루투스 스피커를 연결하자 문제가 생겼다.

블루투스는 실제 소리가 나오기까지 지연이 있다.

PC 재생
→ 블루투스 인코딩
→ 무선 전송
→ 스피커 버퍼링
→ 실제 출력



이 지연은 스피커마다 다르고, 재연결 후에도 달라질 수 있다.

그래서 매장별 보정값인 outputDelayMs를 도입했다.

STORE1: 0ms
STORE2: +500ms
STORE3: +1200ms
...



각 매장 embed 화면에는 수동 보정 버튼을 붙였다.

-100ms
+100ms
0ms 리셋
-500ms
+500ms
-1000ms
+1000ms



이제 테스트 중에 매장 화면에서 바로 보정할 수 있다.

수동 보정 페이지와 비프음 테스트

관리자에는 별도 싱크 보정 페이지도 만들었다.

/admin/calibration



여기서는 매장별 outputDelayMs를 직접 조정하고, 선택한 매장에 비프음 테스트 세션을 보낼 수 있다.

비프음은 일반 음악보다 싱크 차이를 판단하기 쉽다.

삐!
삐!
삐!



이 소리를 기준으로 어느 매장이 늦게 들리는지 확인하고, 해당 매장의 보정값을 올리거나 내린다.

유튜브 라이브처럼 하나의 타임라인을 따라가게 하기

가장 큰 업데이트는 “절대 타임라인” 방식이다.

처음 구조는 각 매장이 특정 곡을 특정 시각에 재생하는 방식이었다.
하지만 더 안정적인 구조는 유튜브 실시간 방송처럼 모두가 하나의 타임라인을 따라가는 것이다.

예를 들어 플레이리스트가 이렇게 구성되어 있다.

1. LOVE ATTACK
2. BTS - Dynamite
3. SEVENTEEN - 울고 싶지 않아



각 곡의 길이를 알고 있으면 전체 플레이리스트 타임라인을 만들 수 있다.

LOVE ATTACK
00:00:00.000 ~ 00:03:01.566

BTS - Dynamite
00:03:01.566 ~ 00:06:44.989

SEVENTEEN - 울고 싶지 않아
00:06:44.989 ~ 00:10:11.159



이제 매장 플레이어는 단순히 “현재 세션의 첫 곡”을 재생하는 게 아니라, 서버 시각 기준으로 지금 전체 타임라인의 어느 지점인지 계산한다.

예를 들면:

전체 타임라인: 00:15:42.578
현재 곡: BTS - Dynamite
곡 위치: 00:02:29.852



즉 매장마다 잠깐 늦게 들어와도, 현재 타임라인을 보고 같은 곡의 같은 위치로 따라갈 수 있다.

관리자 대시보드 개선

관리자 대시보드도 더 직관적으로 바꿨다.

현재는 다음 정보를 볼 수 있다.

현재 재생 음원
현재 곡 위치
전체 타임라인
현재 곡 번호
다음 플레이리스트
매장별 heartbeat
매장별 drift
매장별 outputDelayMs



매장 상태도 이렇게 확인할 수 있다.

STORE1
state: playing
drift: -4ms
pos: 00:02:28.727
outputDelay: 0ms



이제 단순히 “재생 중”인지가 아니라, 각 매장이 현재 몇 초 지점을 재생하고 있는지 확인할 수 있다.

현재까지 구현된 핵심 기능

이번 업데이트로 StoreSync는 단순 MVP에서 꽤 실험 가능한 수준까지 올라왔다.

현재 구현된 기능은 다음과 같다.

1. 매장별 embed URL
2. 관리자 동시 재생
3. 직접 음원 Web Audio 재생
4. 플레이리스트 반복/1곡 반복/랜덤 모드
5. 다음 곡 자동 진행
6. 매장별 outputDelayMs 보정
7. embed 화면 수동 보정 버튼
8. 0ms 리셋 버튼
9. 수동 보정 페이지
10. 비프음 테스트 세션
11. 절대 타임라인 기반 재생
12. HH:MM:SS.mmm 단위 시간 표시
13. 관리자 대시보드 매장별 drift/pos 표시



앞으로의 방향

다음 단계는 자동 보정이다.

현재는 사람이 듣고 +100ms, -100ms를 누르면서 맞춘다.
하지만 앞으로는 매장 PC의 마이크로 비프음을 감지해서 자동으로 지연값을 계산할 수 있다.

구조는 이렇다.

1. 관리자에서 비프음 테스트 시작
2. 각 매장 PC가 마이크로 실제 출력 시점 감지
3. 서버가 매장별 지연값 계산
4. 추천 outputDelayMs 표시
5. 관리자가 적용

1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

댕댕이멍멍 프로필 이미지
댕댕이멍멍2026.10.14

여러 매장의 음악을 하나의 타임라인으로 맞춘다는 아이디어가 정말 흥미롭네요!
스터디 기간 중에 자동 보정까지 구현되는 모습도 볼 수 있으면 좋겠습니다.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기