플레이어, 워터마크, 인트로 및 미리보기
동영상 플레이어, 워터마크, 프리롤 인트로, 마우스오버/스크럽 미리보기 썸네일을 다룹니다.
TubePress는 업로드된 영상과 URL 기반 영상을 FluidPlayer로 재생합니다. FluidPlayer는 vendor/fluidplayer에 번들로 포함된 자체 호스팅 HTML5 플레이어입니다. 그 주변에는 트랜스코딩 중에 생성되는 여러 기능들이 있습니다 — 워터마크, 인트로 및 아웃트로 클립, 스크럽 미리보기 썸네일 — 그리고 목록 카드에 표시되는 호버 미리보기도 포함됩니다.
플레이어 동작은 외관 → 시청에서 설정합니다. 워터마크, 인트로, 타임라인 기능은 재생 시 전환되는 것이 아니라 영상에 인코딩되므로 각각의 /admin/settings?tab=transcode 하위 탭에 있습니다.
비디오 플레이어
업로드된 영상이나 URL 기반 영상의 경우, TubePress는 각 렌디션마다 하나의 <source>가 있는 <video> 요소를 렌더링하고 FluidPlayer를 초기화합니다. 각 렌디션은 화질 레이블이 붙은 별도 소스로 나열되며(720p 이상은 HD로 표시), 플레이어는 내장 화질 메뉴를 노출합니다. 강조 색상은 테마의 기본 색상을 따르며, 재생 중 컨트롤은 자동으로 숨겨집니다.
번들에는 적응형 스트리밍(HLS 및 MPEG-DASH), WebVTT, 360°/VR 재생 모듈이 포함되어 있어 필요 시 일반 MP4 이상을 처리할 수 있습니다. 임베드 코드가 있는 영상은 FluidPlayer를 완전히 우회하고 소스 iframe을 대신 렌더링합니다.
워터마크
워터마크는 영상 위에 오버레이된 로고입니다. TubePress에서는 플레이어가 그리는 것이 아니라 트랜스코딩 중 FFmpeg에 의해 모든 렌디션에 인코딩됩니다 — 따라서 클라이언트 측에서 제거할 수 없지만, 트랜스코딩이 필요하며 활성화 후 처리된 영상에만 나타납니다. 워터마크 하위 탭에서 설정하세요:
편집기의 실시간 미리보기는 오버레이의 대략적인 위치를 보여주지만, 최종 마크는 다음 인코딩 시 FFmpeg가 적용합니다.
프리롤 인트로
모든 영상에 짧은 클립을 앞에 추가할 수 있습니다 — 프리롤 인트로 — 그리고 포스트롤 아웃트로를 뒤에 추가할 수 있으며, 둘 다 인트로 하위 탭에서 설정합니다. 각각은 uploads/intros/에 저장되는 MP4 업로드입니다. 워터마크처럼 인코딩의 일부입니다. 트랜스코딩 중 각 클립은 모든 출력 형식의 정확한 해상도, 코덱, 비트레이트에 맞게 재인코딩된 다음 매끄럽게 연결되므로 중간에 화질 변화가 없습니다.
파일에 인코딩되는 것이 아니라 플레이어 내부에서 재생되는 광고 클립의 경우, 대신 광고 시스템의 VAST 프리/미드/포스트롤을 사용하세요.
타임라인 미리보기
타임라인 미리보기는 진행 막대를 스크럽할 때 나타나는 작은 썸네일입니다. 타임라인 하위 탭에서 타임라인 스크린샷 생성을 활성화하면 트랜스코더가 프레임 스프라이트와 timeline.vtt 맵을 생성하며, 준비되면 FluidPlayer가 탐색 막대에 자동으로 연결합니다.
스프라이트는 별도의 대기열 작업으로 생성되므로 영상 자체가 게시된 직후에 미리보기가 나타날 수 있습니다.
호버 미리보기
플레이어와 별도로, 목록 카드는 방문자가 호버할 때 짧은 미리보기 클립을 재생합니다 — 타임라인 스프라이트가 아닌 영상별 실제 preview.mp4입니다. 이는 테마의 외관 옵션에서 카드 호버 설정으로 제어하며, 시청 페이지를 열지 않고도 각 영상을 빠르게 맛볼 수 있게 합니다.
preview.mp4)과 시청 페이지 플레이어의 스크럽 썸네일(타임라인 스프라이트)은 별도로 생성됩니다 — 영상에 둘 중 하나만 있을 수 있습니다.플레이어 설정
외관 → 시청을 열어 플레이어를 제어하세요. 이 옵션들은 업로드된 영상과 URL 기반 영상에만 적용되며, 임베드에는 적용되지 않습니다.
같은 화면에서 플레이어 주변에 표시할 메타데이터 — 조회수, 재생 시간, 게시 날짜, 좋아요/싫어요 및 즐겨찾기 버튼, 포르노스타, 채널, 카테고리 및 태그 섹션 — 를 전환하고, 사이드바에 표시할 관련 영상 수(2–20)를 설정합니다.