Unity 웹에서는 VideoPlayer API를 사용하여 동영상 재생을 지원합니다. 이 페이지는 웹이 지원하는 동영상 재생 기능에 대한 정보만 제공합니다. Unity 애플리케이션에서 동영상을 사용하는 방법을 알아보려면 동영상 플레이어를 참조하십시오.
Video Player 컴포넌트를 사용하면 웹의 다른 인터랙티브 동작을 기준으로 동영상 재생 시점을 제어할 수 있습니다. 자세한 내용은 Video Player 컴포넌트로 시간 관리를 참조하십시오.
다음과 같은 예외가 있습니다.
VideoPlayer 컴포넌트는 captureFramerate와의 동기식 재생을 지원하지 않습니다. 기본적으로 Game Time 업데이트 모드에 설명된 일반 비동기식 재생을 사용합니다.VideoPlayer 컴포넌트는 재생 컨트롤을 일시적으로 위 또는 아래로 가속화하여 동영상 재생과 Unity 시간 간의 드리프트를 보정합니다. 하지만 Safari 브라우저의 동영상 지원에는 이 메커니즘이 정밀하게 작동하지 못하도록 하는 제한이 있기 때문에 드리프트 보정이 비활성화됩니다.Unity 웹은 다음 동영상 재생 오디오 출력 모드를 지원합니다.
| 클래스 | 용도 |
|---|---|
| VideoAudioOutputMode.None | 내장된 오디오를 비활성화합니다. |
| VideoAudioOutputMode.Direct | 플랫폼의 오디오 하드웨어로 내장된 오디오를 직접 전송합니다. |
| VideoAudioOutputMode.AudioSource | 내장된 오디오를 지정된 AudioSource로 전송합니다. 출력 모드를 VideoAudioOutputMode.AudioSource로 설정하면 Unity는 mute를 제외하고 모든 AudioSource 필드를 무시합니다. 이는 웹에서 동영상 재생의 3D 공간화를 사용할 수 없기 때문입니다. |
Unity에서는 다음과 같은 일반적인 동영상 파일 포맷을 지원합니다.
| 포맷 | 확장자 |
|---|---|
| MPEG–4 Part 14 | .mp4 |
| Apple iTunes 스토어에서 다운로드한 동영상에 사용되는 MPEG–4 파일 | .m4v |
| Apple의 QuickTime 동영상 포맷 | .mov |
| MPEG(Moving Picture Experts Group) | .mpg |
| MPEG 동영상 | .mpeg |
| WebM 동영상 | .webm |
| Ogg 동영상 파일 | .ogv |
이 제한 사항에 대한 유일한 예외는 동영상 URL에 파일 이름 확장자가 없는 경우 브라우저가 제한 없이 동영상을 재생하는 것입니다.
VideoClips는 웹에서 지원되지 않습니다. 일반적으로 씬을 만들 때 VideoClipImporter를 사용하여 Unity 프로젝트에 동영상 클립을 임포트하며, 이는 여러 플랫폼에서 동일한 VideoClip을 재사용하려는 경우 편리합니다. 그러나 연결된 VideoClip이 있는 웹 게임을 빌드할 때 Unity 콘솔은 게임에 있는 각 VideoClip에 대해 다음 경고를 기록합니다.
Embedded video clips are not supported by the Web player: %s. \nUse the Video Player component's URL option instead. 여기서 %s는 동영상 클립 이름으로 대체됩니다. 런타임 시 게임에 VideoClips가 할당된 경우 Unity는 웹 브라우저의 개발자 콘솔에 경고 메시지를 기록합니다.