유튜브 구간 재생기 (IFrame API, 구간 저장, 자동재생)
아이폰 사진첩이 꽉 찬다는 게 이렇게 스트레스일 줄 몰랐습니다. 좋아하는 예능에서 기억해두고 싶은 장면이 나올 때마다 화면 녹화를 해뒀는데, 어느 순간 저장 공간의 절반 이상이 유튜브 클립으로 채워져 있더라고요. 결국 직접 유튜브 구간 재생기를 만들었고, 그 과정에서 YouTube IFrame Player API라는 꽤 쓸만한 도구를 제대로 파게 됐습니다.
화면 녹화 대신 구간을 저장하다
처음에는 단순했습니다. 마음에 드는 장면이 나오면 녹화 버튼을 눌렀고, 나중에 다시 찾아보려면 사진첩을 뒤적였습니다. 그런데 클립 하나가 평균 30초에서 1분 사이니까 쌓이고 쌓이면 GB 단위로 사라지는 용량이 정말 아깝더라고요. 그때 떠올린 게 “굳이 영상 파일을 저장할 필요가 없겠다”였습니다. 어차피 유튜브에 원본이 있으니, 내가 원하는 구간의 시작 시간과 끝 시간만 기록해두면 되는 거 아닌가 싶었습니다.
구조는 이렇습니다. 유튜브를 보다가 캡쳐해두고 싶은 장면의 시작 지점에서 버튼을 누르면 현재 재생 시간과 동영상 ID가 데이터베이스에 기록됩니다. 끝나는 지점에서 다시 버튼을 누르면 종료 시간이 추가됩니다. 이렇게 저장된 레코드들이 나만의 “구간 재생 목록”이 되는 것입니다. 저장 공간은 텍스트 몇 줄이 전부니까 사실상 제로에 가깝습니다.
이 방식을 실제로 구현할 때 핵심이 바로 YouTube IFrame Player API입니다. IFrame Player API란 유튜브가 공식으로 제공하는 자바스크립트 인터페이스로, 웹페이지 안에 유튜브 플레이어를 삽입하고 재생·정지·탐색 같은 동작을 코드로 제어할 수 있게 해주는 도구입니다. 쉽게 말해 유튜브 플레이어의 리모컨을 내 웹사이트 안에서 쥘 수 있게 해주는 것입니다. 공식 문서는 Google Developers 공식 페이지에서 확인할 수 있습니다.
IFrame API로 구간 재생을 구현하는 방법
제가 직접 써봤는데, 생각보다 진입 장벽이 낮았습니다. 핵심은 세 가지 함수입니다. 먼저 onYouTubeIframeAPIReady라는 콜백 함수(Callback Function)가 있습니다. 콜백 함수란 특정 조건이 충족됐을 때 자동으로 호출되는 함수를 뜻하는데, 여기서는 유튜브 API 스크립트 로딩이 끝나는 순간 자동으로 실행됩니다. 이 안에서 YT.Player 객체를 생성하면 플레이어가 페이지에 삽입됩니다.
구간 재생에서 실제로 가장 중요한 함수는 seekTo()입니다. seekTo()란 동영상의 특정 시간대로 바로 이동시켜주는 메서드로, 저장해둔 시작 시간을 인수로 넘기면 그 지점부터 재생이 시작됩니다. 그리고 끝 시간은 onPlayerStateChange 이벤트 리스너와 setTimeout() 조합으로 처리합니다. 플레이어 상태가 “재생 중(1)”으로 바뀌는 순간, 끝 시간에서 시작 시간을 뺀 밀리초만큼 타이머를 걸고 stopVideo()를 호출하는 방식입니다.
구현 순서를 정리하면 이렇습니다.
- 페이지 로드 시 유튜브 IFrame API 스크립트를 비동기로 삽입한다.
- onYouTubeIframeAPIReady 함수 안에서 YT.Player 객체를 생성하고 videoId와 이벤트 리스너를 등록한다.
- onReady 이벤트가 발생하면 seekTo()로 저장된 시작 시간으로 이동 후 playVideo()를 호출한다.
- onStateChange 이벤트에서 상태값이 1(재생 중)로 바뀌면 (끝 시간 – 시작 시간) 밀리초 후 stopVideo()가 실행되도록 setTimeout()을 건다.
- 다음 구간으로 넘어갈 때는 loadVideoById()로 새 videoId와 startSeconds를 넘기고 같은 과정을 반복한다.
loadVideoById()는 인수 문법과 객체 문법 두 가지를 지원하는데, 객체 문법을 쓰면 startSeconds와 endSeconds를 동시에 지정할 수 있습니다. 단, endSeconds는 seekTo()를 추가로 호출하면 무효화된다는 점을 주의해야 합니다. 저는 처음에 이걸 몰라서 끝 시간이 제멋대로 동작해서 한참 헤맸습니다. 결국 setTimeout + stopVideo() 조합이 더 안정적이라는 걸 직접 겪어보니 알게 됐습니다.
아이폰에서 막히는 자동 재생 문제
솔직히 이건 예상 밖이었습니다. PC 크롬에서는 완벽하게 동작하는데, 아이폰 사파리에서 열면 영상이 자동으로 시작되지 않거나 소리 없이 재생되는 현상이 반복됐습니다. 이게 바로 자동재생 정책(Autoplay Policy)의 문제입니다. 자동재생 정책이란 브라우저가 사용자의 명시적인 상호작용 없이 소리가 있는 미디어를 재생하는 것을 차단하는 규칙으로, 모바일 환경에서는 특히 엄격하게 적용됩니다. Mozilla 공식 자동재생 가이드에도 브라우저별로 이 정책이 상세히 설명돼 있습니다.
API 문서에도 onAutoplayBlocked라는 이벤트가 명시돼 있습니다. 이 이벤트는 autoplay 매개변수, loadVideoById(), playVideo() 등 스크립트로 시도된 재생이 브라우저에 의해 막혔을 때 발생합니다. 처음엔 왜 이 이벤트가 자꾸 뜨는지 몰랐는데, 알고 보니 아이폰 사파리가 음소거되지 않은 자동 재생을 철저히 차단하고 있었던 것입니다.
결국 제가 선택한 타협안은 이렇습니다. 플레이어가 로드되면 일단 mute() 상태로 자동 재생을 시작하고, 재생이 확인된 후에 unMute()를 호출하거나 사용자가 직접 음량을 높이도록 안내하는 것입니다. 하지만 실제로 사용해보면 구간이 바뀔 때마다 다시 음소거가 풀리지 않는 경우가 생겨서, 결국 매 구간 시작 시 음량 버튼을 한 번씩 눌러줘야 하는 불편함이 남아 있습니다. 기술적으로는 playsinline 매개변수를 1로 설정해 인라인 재생을 허용하는 것도 도움이 되지만, 소리 문제를 완전히 해결하진 못했습니다. 이 부분은 지금도 아쉬운 점으로 남아 있습니다.
자주 묻는 질문
Q. YouTube IFrame API를 사용하려면 별도 API 키가 필요한가요?
A. IFrame Player API 자체는 API 키 없이도 사용할 수 있습니다. 스크립트 태그로 https://www.youtube.com/iframe_api 를 불러오기만 하면 됩니다. 단, YouTube Data API를 통해 동영상 메타데이터나 재생목록 정보를 가져오려면 별도의 API 키가 필요합니다.
Q. 저장해둔 구간이 많으면 재생 중에 끊기지 않나요?
A. 구간과 구간 사이에 loadVideoById()로 새 동영상을 불러올 때 로딩 시간이 발생할 수 있습니다. 같은 동영상 안에서 seekTo()만 사용하는 경우는 비교적 빠르게 이동되지만, 동영상 자체가 바뀌는 경우에는 네트워크 상태에 따라 버퍼링이 생길 수 있습니다. 저도 이 부분은 완전히 해결하지 못했고, 아직 개선 중입니다.
Q. 아이폰에서 소리 있는 자동 재생이 아예 불가능한가요?
A. 사용자가 한 번이라도 화면을 탭하거나 버튼을 누른 이후에는 소리 있는 재생이 가능합니다. 문제는 구간이 자동으로 넘어갈 때 브라우저가 이를 “사용자 인터랙션 없는 자동재생”으로 판단해 다시 차단한다는 것입니다. 완전한 우회책은 현재로서는 없고, 음소거 상태로 시작하거나 사용자에게 버튼을 한 번 누르도록 유도하는 방식이 현실적인 대안입니다.
Q. 구간 정보를 저장하는 데이터베이스는 어떤 걸 쓰면 좋나요?
A. 저는 간단한 구조여서 SQLite 기반의 로컬 DB를 썼습니다. 저장해야 하는 정보가 videoId, startSeconds, endSeconds, 메모 정도이기 때문에 복잡한 DB는 필요 없습니다. 외부 서버 없이 개인 용도로 쓴다면 브라우저의 localStorage를 활용하는 것도 충분히 현실적인 선택입니다.
결국 이 작은 도구 하나로 사진첩 용량 걱정은 완전히 사라졌습니다. 배우고 싶은 대화 패턴이나 기억해두고 싶은 장면들을 메모와 함께 저장해두고 출퇴근길에 쭉 돌려보는 게 지금은 꽤 즐거운 루틴이 됐습니다. 아이폰 소리 문제가 아직 찜찜하긴 하지만, IFrame API를 직접 다뤄보고 싶다면 Google Developers 공식 문서부터 시작해보시길 권합니다. 생각보다 배우기 어렵지 않고, 활용 범위도 넓습니다.
—
참고: https://developers.google.com/youtube/iframe_api_reference?hl=ko