ViewTalk방 만들기

VIEWTALK / 사용 가이드

ViewTalk 사용 가이드

현재 구현된 기능으로 방을 만들고 참여하는 방법과, 재생이 안 될 때 확인할 사항을 안내합니다.

수정일 · angelcrown

방 만들기

  1. 홈의 ‘방 설정’을 열면 비밀번호, 참여자의 영상 추가, 다음 영상 넘기기 권한을 설정할 수 있습니다. 비밀번호는 4자 이상입니다.
  2. ‘방 만들기’를 누르고 닉네임과 아바타 색상을 정한 뒤 입장하세요. 새 방에는 이전 방의 닉네임이 자동 적용되지 않습니다.
  3. 플레이어 위에 개별 YouTube 링크를 붙여넣고 ‘영상 추가’를 누릅니다. 첫 영상부터 대기열이 시작됩니다. ‘방 링크 복사’는 현재 URL만 복사합니다. 비밀번호를 설정했다면 친구에게 따로 전달하세요.

초대받은 방에 참여하기

초대 링크를 열고 프로필을 정한 뒤, 요청되면 비밀번호를 입력합니다. ViewTalk 자체는 Google 또는 ViewTalk 계정을 요구하지 않습니다. 다만 제한된 영상은 임베드에서 재생되지 않을 수 있습니다.

브라우저가 허용하면 입장 후 자동 재생됩니다. 소리 있는 자동 재생이 차단되면 음소거로 재시도하므로 YouTube 볼륨 버튼으로 소리를 켜세요. 재생도 막혔다면 플레이어의 재생 버튼을 누르세요.

‘대화’와 ‘플레이리스트’ 탭으로 옆 패널을 전환합니다. 인원 옆 화살표는 시청자 목록, 프로필 버튼은 닉네임·색상 변경입니다. ‘크게 보기’는 바깥 여백을 줄이고 넓은 화면에서는 옆 패널을 유지합니다. 휴대폰에서는 패널이 영상 아래에 있습니다.

자동재생은 활성 탭에서 플레이어의 절반 넘는 영역이 보일 때 시작합니다. 화면 밖으로 스크롤하거나 다른 탭으로 이동하면 내 브라우저의 재생만 멈춥니다. 프로필·방 설정창을 열면 내 플레이어를 잠시 제거하고, 닫아 다시 보이면 방의 재생 시점에 맞춥니다. 방장이 이 동작을 해도 다른 참여자의 재생은 멈추지 않습니다. 다음 영상 자동재생은 방장의 화면에 보이는 플레이어가 영상 끝에 도달해야 진행됩니다.

방장과 플레이리스트

방장의 재생·정지·시간 이동이 공유됩니다. 참여자의 로컬 플레이어 조작은 방 전체 명령이 아니며 이후 방장 위치로 보정됩니다. 방장은 대기열 항목을 선택·삭제하고 설정에서 참여자 권한을 바꿀 수 있습니다.

방장 플레이어의 영상이 끝나면 다음 대기 영상으로 넘어갑니다. 방장 연결이 끊기면 입장 순서상 다음 접속자에게 방장 권한이 넘어갑니다. 현재 방당 최대 50명, 대기열 최대 50개입니다.

왕복 통신 시간을 이용해 서버 시각을 추정하고 약 1.8초보다 큰 오차를 보정합니다. 광고·버퍼링·네트워크 차이 때문에 프레임 단위 동기화는 보장하지 않습니다.

지원 콘텐츠와 브라우저

YouTube watch, youtu.be, Shorts, live, embed 형식의 개별 영상 링크를 받습니다. 영상 ID가 포함된 YouTube 플레이리스트 주소도 해당 영상 하나만 추가하며 목록 전체를 가져오지 않습니다. Spotify·Netflix·로컬 파일·별도 오디오 스트림은 지원하지 않습니다.

JavaScript·WebSocket·YouTube 임베드가 허용된 최신 Chrome·Edge·Firefox·Safari를 사용하세요. 이는 대상 브라우저이며 모든 버전이나 앱 내 웹뷰의 동작을 보장하는 의미는 아닙니다. 데스크톱·모바일 Chromium 화면을 확인하며 Safari·Firefox는 기기별 추가 검증이 필요합니다.

비공개·삭제·지역 제한·연령 제한·외부 재생 금지 영상은 실패할 수 있습니다. 실시간 영상은 불러올 수 있지만 탐색 범위와 동기화는 방송 상태에 따라 달라집니다. 서버는 영상 ID로 YouTube Data API v3에 제목·외부 재생 허용 여부·아동용 상태를 조회합니다. 외부 재생이 허용되고 아동용이 아님(madeForKids: false)이 명시된 영상만 검증을 통과합니다. 아동용 영상, 상태 누락·불명확, 조회 불가 영상, API 조회 오류는 거절합니다.

새 영상 불러오기·추가와 대기열 선택·다음 영상 이동에 이 검증을 적용합니다. 성공한 검증은 방의 캐시에서 최대 24시간 재사용하므로 상태를 계속 감시하는 것은 아닙니다. 서버 검증을 켜기 전부터 기존 방에서 재생 중이던 영상은 강제로 종료하지 않습니다. 과거 대기열 항목은 다음 선택·이동 때 확인하며, 검증에 실패해도 이전 영상과 대기열 항목은 그대로 둡니다.

실제 사용 예시

스터디: 방장이 공개 강의 두 개를 넣고 참여자의 넘기기 권한은 꺼 둡니다. 예제 풀이에서 잠시 멈춘 뒤 채팅으로 해석을 나누고 다시 재생하세요. 채팅은 휘발성이므로 공부한 내용은 따로 메모해야 합니다.

뮤직비디오 모임: 참여자의 영상 추가를 켜서 공식 아티스트 영상을 차례로 넣습니다. 다음 영상 넘기기는 모두 합의한 경우에 허용하세요. 각자 화면의 YouTube 플레이어로 시청하며 오디오 추출이나 오프라인 감상 기능은 없습니다.

오류 해결과 제한사항

링크가 거절되면 YouTube 원본에서 영상과 주소를 확인하세요. 외부 재생 금지 또는 접근 제한이라면 허용된 다른 영상을 선택해야 합니다. ViewTalk에서 제한을 해제할 수는 없습니다.

플레이어가 비거나 오류 153이 나오면 앱 안의 웹뷰 대신 일반 브라우저와 정상 사이트 주소로 접속하세요. 확장 프로그램이나 개인정보 설정이 YouTube의 출처 확인을 막을 수 있습니다. 필수 보안 보호를 해제하지는 마세요.

타이밍이 어긋나면 방 탭을 화면에 두고 연결 상태를 확인하세요. 연결 복구는 자동입니다. 모두 나간 뒤 종료된 방은 새로 만들어야 하며 채팅과 대기열을 복원할 수 없습니다. 방 생성이나 메시지 전송이 너무 잦으면 요청 제한이 적용되므로 잠시 기다리세요.

메시지 보관함·내보내기·공개 피드·참여자 강퇴·차단·방 안의 신고 접수함은 없습니다. 원치 않는 대화에서는 퇴장하고 문의 페이지로 문제를 알려주세요. 비밀번호를 걸어도 참여자가 대화를 복사하거나 초대를 전달하는 것은 막지 못합니다.