기술 자료

Unity 엔진

Unity 엔진

Video Player 컴포넌트 레퍼런스

Video Player 컴포넌트의 설정에 대해 자세히 알아보십시오.
읽는 시간 5분최근 업데이트: 9일 전

Video Player 컴포넌트의 설정을 통해 재생할 비디오 파일을 지정하고 씬 내에서 재생 동작을 커스터마이즈합니다.
Video Player 컴포넌트와 컴포넌트를 생성하는 방법에 대한 자세한 내용은 Video Player 컴포넌트 타겟과 Video Player 컴포넌트 생성을 참조하십시오.

프로퍼티

설명

Source동영상 콘텐츠를 가져올 소스 유형을 선택합니다. 소스는 프로젝트에 저장되거나 특정 URL에서 외부에 호스팅되거나
StreamingAssets
폴더에 저장되는 비디오 파일일 수 있습니다.
비디오 클립Video Player 컴포넌트에 할당할 비디오 클립을 선택합니다. 웹 플랫폼에서는 지원되지 않습니다.
URL비디오 플레이어에 할당하려는 비디오의 URL(예: http:// 또는 file://))을 입력합니다.
업데이트 모드Video Player 컴포넌트가 타이밍을 업데이트하는 데 사용하는 시계 소스를 설정합니다. 자세한 내용은 업데이트 모드 드롭다운을 참조하십시오.
깨어있을 때 재생하기씬이 실행될 때 동영상을 재생합니다. 런타임 중 다른 지점에서 비디오 재생을 트리거하려면 이 항목을 선택 해제합니다.
Play()
명령을 사용하여 스크립팅을 통해 트리거합니다.
첫 번째 프레임 대기재생이 시작되기 전에 소스 비디오의 첫 번째 프레임이 표시될 때까지 기다립니다. 비디오 시간을 게임의 나머지 부분과 동기화하도록 지우면 처음 몇 프레임이 폐기될 수 있습니다.
루프소스 비디오가 끝에 도달하면 반복합니다. 동영상이 끝날 때 동영상을 재생을 중지하려면 삭제합니다.
건너뛰기이 옵션을 활성화하면 Video Player 컴포넌트가 재생 포지션과 게임 클럭 사이의 드리프트를 감지하면 Video Player가 앞으로 건너뛰게 됩니다. 이 옵션을 비활성화하면 비디오 플레이어가 드리프트를 보정하지 않고 모든 프레임을 체계적으로 재생합니다.
재생 속도재생 속도에 대한 멀티플라이어를 0과 10 사이의 값으로 설정합니다. 기본적으로 이 값은 노멀 속도인 1로 설정됩니다. 필드를 2로 설정하면 동영상이 일반 속도의 두 배로 재생됩니다.
렌더 모드동영상을 렌더링할 방법을 선택합니다. 자세한 내용은 렌더 모드 드롭다운을 참조하십시오.
Camera비디오를 수신하는 카메라를 정의합니다. 이 프로퍼티는 렌더 모드가 카메라 원거리 평면 또는 카메라 근거리 평면인 경우에만 사용할 수 있습니다.
Alpha소스 비디오에 추가할 전역 투명성 레벨을 설정합니다. 이 프로퍼티를 사용하면 평면 뒤의 요소가 평면을 통해 보입니다. 알파 채널에 대한 자세한 내용은 비디오 투명성 지원을 참고하십시오. 이 프로퍼티는 렌더 모드가 카메라 원거리 평면 또는 카메라 근거리 평면인 경우에만 사용할 수 있습니다.
3D 레이아웃소스 비디오에서 3D 콘텐츠의 레이아웃을 선택합니다. 자세한 내용은 3D 레이아웃 드롭다운을 참조하십시오.
타겟 텍스처Video Player 컴포넌트가 이미지를 렌더링하는 렌더 텍스처를 정의합니다. 렌더 텍스처에 대한 권장 설정은 비디오용 렌더 텍스처 준비를 참조하십시오.
종횡비해당 렌더 모드를 사용할 때 카메라 근평면, 카메라 원거리 평면 또는 렌더 텍스처를 채우는 이미지의 종횡비를 설정합니다. 자세한 내용은 Aspect Ratio 드롭다운을 참조하십시오.
렌더러Video Player 컴포넌트가 이미지를 렌더링하는 렌더러를 선택합니다. 없음으로 설정된 경우 Video Player 컴포넌트는 동일한 게임 오브젝트에서 렌더러를 사용합니다.
자동 선택 등록 정보이 옵션을 활성화하면 Video Player 컴포넌트가 렌더러의 메인 텍스처를 자동으로 선택합니다. 이 옵션을 비활성화하면 머티리얼 속성 옵션을 수동으로 설정할 수 있습니다.
오디오 출력 모드소스의 오디오 트랙을 출력하는 방식을 정의합니다. 자세한 내용은 오디오 출력 모드 드롭다운을 참조하십시오.
제어된 트랙동영상의 오디오 트랙 수입니다.

소스가 URL일 때만 표시됩니다. 소스가 비디오 클립인 경우, 동영상 파일을 검사하여 트랙 수를 결정합니다.
트랙 번호플레이에 사용할 연결된 오디오 트랙을 활성화합니다. 플레이하기 전에 이 프로퍼티를 설정해야 합니다.

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

소스가 URL 경우 이 정보는 재생 중에만 사용할 수 있습니다.

이 프로퍼티는 소스가 오디오 트랙(또는 트랙)이 있는 비디오 클립이거나 소스가 URL 경우에만 나타납니다(재생 중에 URL 예상할 트랙 수를 나타낼 수 있음).
오디오 소스오디오 트랙이 재생되는 오디오 소스입니다. 타겟 오디오 소스는 오디오 클립도 재생할 수 있습니다.

오디오 소스의 재생 제어(스크립팅 API의
Play On Awake
및
Play()
)는 비디오 소스의 오디오 트랙에 적용되지 않습니다.

이 프로퍼티는 오디오 출력 모드가 오디오 소스로 설정된 경우에만 표시됩니다.
mute연결된 오디오 트랙을 음소거합니다. 오디오 소스 모드에서는 오디오 소스의 컨트롤이 사용됩니다.

이 프로퍼티는 오디오 출력 모드가 직접인 경우에만 사용할 수 있습니다.
볼륨연결된 오디오 트랙의 볼륨입니다. 오디오 소스 모드에서는 오디오 소스의 음량이 사용됩니다.

이 프로퍼티는 오디오 출력 모드가 직접인 경우에만 사용할 수 있습니다.

업데이트 모드(Update Mode) 드롭다운

업데이트 모드 드롭다운에서 다음 옵션을 사용할 수 있습니다.

값

설명

DSP Time오디오를 처리하는 동일한 클럭 소스를 사용합니다.
Game Time게임 클럭과 동일한 클럭 소스를 사용합니다. 이 클럭 소스는 시간 스케일링 및 캡처 프레임 속도 설정의 영향을 받습니다.
축소되지 않은 게임 시간게임 클럭과 동일한 클럭 소스를 사용하지만 이 클럭 소스는 시간 스케일링 또는 캡처 프레임 속도에 영향을 받지 않습니다.

렌더 모드(Render Mode) 드롭다운

다음 옵션은 렌더 모드(Render Mode) 드롭다운에서 사용할 수 있습니다. 이러한 타겟에 대한 자세한 내용은 Video Player 컴포넌트 타겟을 참조하십시오.

값

설명

카메라 원거리 평면카메라의 원거리 평면에서 비디오를 렌더링합니다. 이 옵션을 선택하면 동영상이 씬의 배경에서 재생됩니다.
Camera Near Plane카메라의 근접 평면에서 비디오를 렌더링합니다. 이 옵션을 선택하면 동영상이 씬의 오브젝트 앞에 재생됩니다.
렌더 텍스처비디오를 렌더 텍스처로 렌더링합니다. 지침과 권장 설정은 비디오를 표시할 렌더 텍스처 설정을 참조하십시오.
머티리얼 오버라이드렌더러의 머티리얼을 통해 게임 오브젝트의 선택된 텍스처 프로퍼티에 비디오를 렌더링합니다.
API 전용비디오를 VideoPlayer.texture 스크립팅 API 프로퍼티로 렌더링합니다.

3D 레이아웃 드롭다운

3D 레이아웃 드롭다운에서 다음 옵션을 사용할 수 있습니다.

값

설명

없음비디오에는 3D 콘텐츠가 없습니다.
옆으로비디오에는 왼쪽 눈이 왼쪽 반을 차지하고 오른쪽 눈이 비디오 프레임의 오른쪽 반을 차지하는 3D 콘텐츠가 있습니다.
아래로비디오에는 왼쪽 눈이 위쪽 반을 차지하고 오른쪽 눈이 아래쪽 반을 차지하는 3D 콘텐츠가 있습니다.

종횡비 드롭다운

다음 설정은
Aspect Ratio

?

드롭다운에서 사용할 수 있는 옵션입니다.

값

설명

확장 없음스케일링을 사용하지 않습니다. 동영상은 대상 사각형 중앙에 있습니다.
수직 맞춤소스를 스케일하여 대상 사각형에 세로로 맞춥니다. 이 옵션은 왼쪽과 오른쪽을 자르거나 필요한 경우 양쪽에 검은색 영역을 남깁니다. 소스 종횡비가 유지됩니다.
수평 맞춤소스를 확대/축소하여 대상 사각형에 수평으로 맞춥니다. 이 옵션은 상단 및 하단 영역을 자르거나 필요한 경우 위쪽과 아래쪽 영역을 검은색으로 둡니다. 소스 종횡비가 유지됩니다.
내부 맞춤자르지 않고 목적 사각형에 맞게 소스를 스케일합니다. 필요에 따라 왼쪽과 오른쪽 또는 위쪽과 아래쪽에 검은색 영역을 둡니다. 소스 종횡비가 유지됩니다.
외부 맞춤왼쪽과 오른쪽에 검은색 영역을 남기지 않고 목적지 사각형에 맞게 소스를 확대/축소하고 필요에 따라 잘라냅니다. 소스 종횡비가 유지됩니다.
스트레치대상 사각형에 맞게 수평 또는 수직으로 스케일합니다. 소스 종횡비가 보존되지 않습니다.

오디오 출력 모드(Audio Output Mode) 드롭다운

오디오 출력 모드 드롭다운에서 다음 옵션을 사용할 수 있습니다.

값

설명

없음오디오가 재생되지 않습니다.
오디오 소스오디오 샘플은 선택한 오디오 소스로 전송되므로 Unity의 오디오 프로세싱을 적용할 수 있습니다.
Direct오디오 샘플은 Unity 오디오 프로세싱을 우회하여 오디오 출력 하드웨어로 직접 전송됩니다.
API 전용(실험 단계)오디오 샘플은 연결된 AudioSampleProvider로 전송됩니다.

추가 리소스