Version: 2023.1
언어: 한국어
동영상 개요
MovieTexture에서 VideoPlayer로 마이그레이션

Video Player 컴포넌트

비디오 플레이어 컴포넌트를 사용하여 비디오 파일게임 오브젝트에 연결하고 런타임 시점에 게임 오브젝트의 텍스처에서 재생할 수 있습니다.

아래 스크린샷에서 구형 게임 오브젝트에 연결된 Video Player 컴포넌트를 확인할 수 있습니다.

Video Player 컴포넌트의 Material Property 는 기본적으로 게임 오브젝트의 메인 텍스처로 설정되어 있습니다. 이 설정에서는 렌더러가 있는 게임 오브젝트에 Video Player 컴포넌트가 연결되면, 렌더러의 텍스처가 게임 오브젝트의 메인 텍스처이기 때문에 자동으로 해당 렌더러의 텍스처에 자신(비디오 플레이어)을 할당합니다. 여기에서는 게임 오브젝트에 Mesh Renderer 컴포넌트가 있으므로, 자동으로 비디오 플레이어가 Renderer 필드에 할당됩니다. 따라서 메시 렌더러의 텍스처에서 비디오 클립이 재생됩니다.

구형 게임 오브젝트에 연결되어 게임 오브젝트의 메인 텍스처(메시 렌더러의 텍스처)에서 비디오 클립을 재생하는 Video Player 컴포넌트
구형 게임 오브젝트에 연결되어 게임 오브젝트의 메인 텍스처(메시 렌더러의 텍스처)에서 비디오 클립을 재생하는 Video Player 컴포넌트

다음의 예와 같이 비디오를 재생할 대상을 직접 선택할 수도 있습니다.

Video Player 컴포넌트 레퍼런스

Video Player 컴포넌트
Video Player 컴포넌트
프로퍼티 기능
Source 비디오 소스 타입을 선택합니다.
Video Clip 비디오 클립을 비디오 플레이어에 할당합니다.
Video Clip 이 필드를 사용하여 Video Player 컴포넌트에 할당된 비디오 클립을 정의할 수 있습니다.비디오 파일을 이 필드로 드래그 앤 드롭하거나, 비디오 파일이 프로젝트 폴더에 있는 경우 필드 오른쪽에 있는 원 아이콘을 클릭한 후 에셋 목록에 있는 파일을 선택합니다.이 기능은 WebGL에서 지원되지 않습니다.
URL URL(예: http:// 또는 file://)에 있는 비디오를 할당합니다. Unity 에디터는 런타임 시점에 이 URL에서 비디오를 읽어옵니다.
URL Video Player 컴포넌트에 할당할 비디오의 URL을 입력합니다.
Browse… Navigate your local file system and open URLs that begin with file://.
Update Mode Set the clock source that the Video Player component uses to update its timing.
DSP Time Select to use the same clock source that processes audio.
Game Time Select to use the same clock source as the game clock. This clock source is affected by the time scaling and capture frame rate settings.
Unscaled Game Time Select to use the same clock source as the game clock but without being affected by time scaling or capture frame rate.
Play On Awake Select to play the video when the Scene launches. Clear it if you want to trigger the video playback at another point during run time. Trigger it via scripting with the Play() command.
Wait For First Frame Select to wait for the first frame of the source video to be ready for display before the game starts. Clear it to keep the video time in sync with the rest of the game, which might cause the first few frames to be discarded.
Loop Select to make the Video Player component loop the source video when it reaches its end. Clear it to stop playing the video when it reaches the end.
Skip On Drop 이 옵션을 활성화하고 Video Player 컴포넌트가 재생 위치와 게임 시계 사이의 드리프트를 감지하면 Video Player는 앞으로 건너뜁니다. 이 옵션을 비활성화하면 VideoPlayer는 드리프트 보정을 시도하지 않고 체계적으로 모든 프레임을 재생합니다.
Playback Speed 슬라이더를 조절하거나 숫자를 입력하여 0과 10 사이의 값으로 재생 속도를 설정합니다. 기본값은 1(보통 속도)입니다. 값을 2로 설정하면 비디오가 보통 속도의 2배로 재생됩니다.
Render Mode 드롭다운을 사용하여 비디오 렌더링 방법을 정의합니다.
Camera Far Plane 카메라의 후방 절단면에 비디오를 렌더링합니다.
Camera Near Plane 카메라의 전방 절단면에 비디오를 렌더링합니다.
Camera 비디오를 수신하는 카메라를 정의합니다.
Alpha 소스 비디오에 추가되는 전역 투명도 수준입니다. 절단면 뒤에 있는 요소가 절단면을 통해 보이도록 설정할 수 있습니다. 알파 채널에 대한 자세한 내용은 비디오 투명도 지원 문서를 참조하십시오.
Render Texture 렌더 텍스처에 비디오를 렌더링합니다.
Target Texture 비디오 플레이어의 이미지가 렌더링되는 렌더 텍스처를 정의합니다.
Material Override 렌더러의 머티리얼을 통해 게임 오브젝트의 선택된 프로퍼티에 비디오를 렌더링합니다.
Renderer Video Player 컴포넌트가 이미지를 렌더링하는 렌더러입니다. None 으로 설정하면 Video Player 컴포넌트가 소속된 게임 오브젝트의 Renderer 가 사용됩니다.
Auto-Select Property 이 옵션을 활성화하면 Video Player 컴포넌트는 렌더러의 메인 텍스처를 자동으로 선택합니다. 이 옵션을 비활성화하면 Material Property 옵션을 수동으로 설정할 수 있습니다.
Material Property Video Player 컴포넌트 이미지를 수신하는 머티리얼 텍스처 프로퍼티의 이름입니다.
API Only 비디오를 VideoPlayer.texture 스크립팅 API 프로퍼티에 렌더링합니다. 스크립트를 사용하여 텍스처를 원하는 대상에 할당해야 합니다.
Aspect Ratio Render Mode 사용할 때 Camera Near Plane, Camera Far Plane, Render Texture 를 채우는 이미지의 종횡비입니다.
No Scaling 스케일을 사용하지 않습니다. 비디오가 대상 사각형의 중앙에 표시됩니다.
Fit Vertically 대상 사각형의 세로 길이에 맞추어 소스를 스케일하고 필요에 따라 왼쪽과 오른쪽을 일부 자르거나 좌우에 검정색 영역을 남깁니다. 소스 종횡비가 유지됩니다.
Fit Horizontally 대상 사각형의 가로 길이에 맞추어 소스를 스케일하고 필요에 따라 위쪽과 아래쪽을 일부 자르거나 위아래에 검정색 영역을 남깁니다. 소스 종횡비가 유지됩니다.
Fit Inside 소스를 자를 필요가 없도록 대상 사각형에 맞추어 스케일합니다. 필요에 따라 좌우 또는 아래위에 검정색 영역을 남깁니다. 소스 종횡비가 유지됩니다.
Fit Outside 좌우 또는 위아래에 검정색 영역을 생기지 않도록 필요에 따라 잘라서 좌우 또는 위아래를 일부 잘라서 대상 사각형에 맞게 소스를 스케일합니다. 소스 종횡비가 유지됩니다.
Stretch 대상 사각형에 맞게 가로 또는 세로로 스케일합니다. 소스 종횡비가 유지되지 않습니다.
Audio Output Mode 소스의 오디오 트랙을 출력하는 방법을 정의합니다.
None 오디오를 재생하지 않습니다.
Audio Source Unity의 오디오 프로세싱을 적용할 수 있도록 오디오 샘플을 선택된 오디오 소스에 전송합니다.
직접 기여(Direct) Unity 오디오 프로세싱을 건너뛰고 오디오 샘플을 오디오 출력 하드웨어로 직접 전송합니다.
API Only (Experimental) 오디오 샘플은 연결된 AudioSampleProvider에 전달됩니다.
Controlled Tracks 비디오의 오디오 트랙 수입니다.

SourceURL 로 설정되어 있을 때에만 표시됩니다. SourceVideo Clip 으로 설정되어 있을 때에는 비디오 파일을 조사하여 트랙 수를 확인합니다.
Track Enabled 관련 체크박스를 선택하여 활성화하면 연결된 오디오 트랙이 재생에 사용됩니다. 재생 전에 설정해야 합니다.

체크박스 왼쪽에 있는 텍스트는 트랙 번호, 언어, 채널 수 등 오디오 트랙에 대한 정보를 제공합니다.

예를 들어 위 스크린샷에서 이 텍스트는 Track 0 [und. 1 ch]로 나타나는데, 첫 번째 트랙(Track 0)이고 언어가 정의되지 않았고(und.) 트랙에 채널이 하나(1 ch) 있는 모노 트랙임을 의미합니다.

소스가 URL이면 이 정보는 재생 중에만 제공됩니다.

이 프로퍼티는 소스가 오디오 트랙(하나 이상)을 포함하는 비디오 클립이거나 소스가 URL(재생 중에 URL에서 제공될 것으로 예상되는 트랙 수를 표시할 수 있음)로 설정되어 있을 때에만 표시됩니다.
Audio Source 오디오 트랙을 어느 오디오 소스를 통해 재생할 것인지 설정합니다. 타겟 오디오 소스도 오디오 클립을 재생할 수 있습니다.

오디오 소스의 재생 컨트롤(스크립팅 API의 Play()Play On Awake)은 오디오 소스의 오디오 트랙에 적용되지 않습니다.

이 프로퍼티는 Audio Output ModeAudio Source 로 설정되어 있을 때에만 표시됩니다.
Mute 연결된 오디오 트랙의 소리를 끕니다. Audio Source 모드에서는 오디오 소스의 컨트롤이 사용됩니다.

이 프로퍼티는 Audio Output ModeDirect 로 설정되어 있을 때에만 표시됩니다.
Volume 연결된 오디오 트랙의 볼륨입니다. Audio Source 모드에서는 오디오 소스의 볼륨이 사용됩니다.

이 프로퍼티는 Audio Output ModeDirect 로 설정되어 있을 때에만 표시됩니다.

비디오 플레이어 스크립팅 예시

다음 스크립트는 VideoPlayer 컴포넌트의 몇 가지 기능을 보여줍니다.

// Examples of VideoPlayer function

using UnityEngine;

public class Example : MonoBehaviour
{
    void Start()
    {
        // Will attach a VideoPlayer to the main camera.
        GameObject camera = GameObject.Find("Main Camera");

        // VideoPlayer automatically targets the camera backplane when it is added
        // to a camera object, no need to change videoPlayer.targetCamera.
        var videoPlayer = camera.AddComponent<UnityEngine.Video.VideoPlayer>();

        // Play on awake defaults to true. Set it to false to avoid the url set
        // below to auto-start playback since we're in Start().
        videoPlayer.playOnAwake = false;

        // By default, VideoPlayers added to a camera will use the far plane.
        // Let's target the near plane instead.
        videoPlayer.renderMode = UnityEngine.Video.VideoRenderMode.CameraNearPlane;

        // This will cause our Scene to be visible through the video being played.
        videoPlayer.targetCameraAlpha = 0.5F;

        // Set the video to play. URL supports local absolute or relative paths.
        // Here, using absolute.
        videoPlayer.url = "/Users/graham/movie.mov";

        // Skip the first 100 frames.
        videoPlayer.frame = 100;

        // Restart from beginning when done.
        videoPlayer.isLooping = true;

        // Each time we reach the end, we slow down the playback by a factor of 10.
        videoPlayer.loopPointReached += EndReached;

        // Start playback. This means the VideoPlayer may have to prepare (reserve
        // resources, pre-load a few frames, etc.). To better control the delays
        // associated with this preparation one can use videoPlayer.Prepare() along with
        // its prepareCompleted event.
        videoPlayer.Play();
    }

    void EndReached(UnityEngine.Video.VideoPlayer vp)
    {
        vp.playbackSpeed = vp.playbackSpeed / 10.0F;
    }
}

  • 2017–05–07 페이지 수정됨

  • Unity 5.6의 새로운 기능

VideoPlayer

동영상 개요
MovieTexture에서 VideoPlayer로 마이그레이션