시작하기

설치

리스팅에서 Udonite Video를 추가합니다. Udonite와 네트워크도 함께 들어옵니다. TextMeshPro를 쓰는데, VRChat 월드 프로젝트에는 원래 들어 있습니다.

씬에 플레이어 놓기

Udonite > Video > Create Video Player를 실행하면 씬 뷰 카메라 앞에 한 세트가 만들어집니다.

• AVPro 플레이어. YouTube, Twitch, Vimeo, 라이브 방송, 동영상 파일 직접 링크를 재생합니다
• 16:9 스크린. 불러오는 중, 오류, "Nothing playing"을 보여주는 상태 표시 포함
• 스피커
• 스크린 아래의 조작 패널과 대기열
• 채우기만 하면 되는 빈 재생목록
• 씬에 있고 아직 아무것에도 연결되지 않은 AudioLink와의 연결

모두 평범한 GameObject입니다. 패널은 사람들이 서는 곳으로 옮기고, 스크린은 벽에 맞게 키우고, 필요 없는 것은 지우세요. 프로젝트에 TextMeshPro 필수 리소스가 아직 없으면 첫 플레이어를 만들 때 가져옵니다.

메뉴 항목은 이것 하나뿐입니다. 나머지는 모두 플레이어 인스펙터의 Add to it에 있습니다.

해 보기

VRChat SDK 패널에서 Build & Test를 누릅니다. 패널의 입력란에 링크를 붙여 넣고 Enter를 누르세요.

https://www.youtube.com/watch?v=aqz-KE-bpKQ

Enter는 링크를 대기열에 넣고, 아무것도 재생 중이 아니면 바로 재생합니다. 시작 시간을 지정한 링크는 모두가 그 위치에서 시작합니다. YouTube 공유 버튼이 붙이는 ?t=90, &t=1m30s, ?start=90 모두 됩니다.

Build & Test에서 클라이언트를 두 개 띄우면 함께 움직이는 것을 볼 수 있습니다. 한쪽에서 일시정지하면 다른 쪽도 같은 프레임에서 멈춥니다.

VRChat이 신뢰하지 않는 링크는 각 플레이어가 설정에서 Allow Untrusted URLs를 켜야 하고, 그것 때문에 실패하면 패널이 그렇게 알려줍니다. 업로드된 월드에서 YouTube, Twitch, Vimeo는 신뢰됩니다. 로컬 테스트 빌드는 YouTube를 포함한 모든 도메인을 신뢰하지 않는다고 로그에 남기지만, 그 경고만으로 재생이 멈추지는 않습니다.

재생목록 더하기

대기열이 바닥나면 플레이어는 재생목록을 재생합니다. 플레이어를 선택해 VideoPlaylist 컴포넌트의 urls를 채우고, YouTube 링크라면 titles는 비워 두세요. 재생목록의 Fetch YouTube titles 버튼이 하나씩 찾아 채워 줍니다.

VideoPlayer의 autoplay를 켜면 인스턴스가 열릴 때 재생목록이 시작되고, 재생목록의 shuffle을 켜면 무작위 순서로 재생합니다.

에디터 스크립트에서도 똑같습니다.

VideoPlaylist playlist = VideoSetup.AddPlaylist(player, autoplay: true);
VideoSetup.AddToPlaylist(playlist, "https://www.youtube.com/watch?v=aqz-KE-bpKQ");
VideoSetup.AddToPlaylist(playlist, "https://example.com/intro.mp4", "Welcome");
VideoSetup.FetchTitles(playlist);

스태프만 쓰도록 잠그기

패널의 잠금 버튼이나 플레이어의 startLocked를 쓰면, 조작은 인스턴스 오너, 마스터, moderators에 적은 표시 이름의 사람에게만 남습니다. 다른 사람도 자기 볼륨을 바꾸고 자기 화면을 다시 불러올 수는 있습니다.

잠긴 플레이어는 다른 사람에게 소유권을 넘기는 것도 거부하므로, 개조된 클라이언트로도 빼앗을 수 없습니다.

스크린 늘리기와 AudioLink

플레이어 인스펙터의 Another screen에 아무 렌더러나 끌어다 놓으면, 같은 영상이 각자의 레터박스로 나옵니다. TV 메시, 프로젝터 벽, 플레이어가 손에 든 휴대폰이 모두 플레이어 하나를 비출 수 있습니다.

플레이어보다 나중에 AudioLink를 넣었다면, 플레이어 인스펙터에 나타나는 Connect AudioLink to this player가 그것을 플레이어의 스피커에 연결합니다.