Video Player 컴포넌트 레퍼런스
Video Player 컴포넌트의 설정에 대해 자세히 알아보십시오.
읽는 시간 5분최근 업데이트: 9일 전
Video Player 컴포넌트의 설정을 통해 재생할 비디오 파일을 지정하고 씬 내에서 재생 동작을 커스터마이즈합니다.
Video Player 컴포넌트와 컴포넌트를 생성하는 방법에 대한 자세한 내용은 Video Player 컴포넌트 타겟과 Video Player 컴포넌트 생성을 참조하십시오.
프로퍼티 | 설명 |
|---|---|
| Source | 동영상 콘텐츠를 가져올 소스 유형을 선택합니다. 소스는 프로젝트에 저장되거나 특정 URL에서 외부에 호스팅되거나 |
| 비디오 클립 | Video Player 컴포넌트에 할당할 비디오 클립을 선택합니다. 웹 플랫폼에서는 지원되지 않습니다. |
| URL | 비디오 플레이어에 할당하려는 비디오의 URL(예: http:// 또는 file://))을 입력합니다. |
| 업데이트 모드 | Video Player 컴포넌트가 타이밍을 업데이트하는 데 사용하는 시계 소스를 설정합니다. 자세한 내용은 업데이트 모드 드롭다운을 참조하십시오. |
| 깨어있을 때 재생하기 | 씬이 실행될 때 동영상을 재생합니다. 런타임 중 다른 지점에서 비디오 재생을 트리거하려면 이 항목을 선택 해제합니다. |
| 첫 번째 프레임 대기 | 재생이 시작되기 전에 소스 비디오의 첫 번째 프레임이 표시될 때까지 기다립니다. 비디오 시간을 게임의 나머지 부분과 동기화하도록 지우면 처음 몇 프레임이 폐기될 수 있습니다. |
| 루프 | 소스 비디오가 끝에 도달하면 반복합니다. 동영상이 끝날 때 동영상을 재생을 중지하려면 삭제합니다. |
| 건너뛰기 | 이 옵션을 활성화하면 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의 이 프로퍼티는 오디오 출력 모드가 오디오 소스로 설정된 경우에만 표시됩니다. |
| 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로 전송됩니다. |