> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/video-screen.md).

# 비디오 화면

씬에서 비디오 재생

씬의 화면에서 사전 녹화된 동영상이나 스트리밍 동영상을 재생하려면 비디오 플레이어를 사용하세요 [스마트 아이템](/creator/content-creator-ko/scene-editor/interactivity/smart-items.md).

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-01d7193f1148aa3fc6d53232dfb403cc815b6bce%2Fvideo-player-item.png?alt=media)

## 일반 설정

이 설정은 동영상을 재생하거나 스트리밍하는 경우 등 모든 시나리오에 적용됩니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d050af90f1b3bbb51c17f70ccdfd6ab0056b4057%2Fvideo-automatic.png?alt=media)

동영상 오디오의 볼륨을 구성할 수 있습니다. 스트림의 오디오는 위치 기반이 아니므로 씬 전체에서 동일한 볼륨으로 들립니다.

그 **기본 미디어 소스** 드롭다운에서 서로 다른 두 가지 소스 유형 중 선택할 수 있습니다:

* **비디오 URL**: URL 또는 로컬 동영상 파일에서 동영상이나 스트림 가져오기
* **라이브 스트림**: Decentraland의 무료 스트리밍 인프라를 사용하여 스트림을 표시합니다. 이를 사용하려면 다음도 포함해야 합니다. [관리 도구](/creator/content-creator-ko/scene-editor/operate-live/scene-admin.md) 스마트 아이템을 씬에 추가하세요.

## 비디오 재생

사전 녹화된 동영상은 다음 중 하나에서 재생할 수 있습니다:

* **로컬 파일**: 씬의 일부로 동영상 파일을 업로드한 다음 *URL* 필드를 해당 파일의 경로로 지정합니다.
* **URL에서 스트리밍**: Bunny와 같은 제공업체의 웹상 라이브 또는 사전 녹화 스트림을 지정합니다. 다음을 참조하세요 [동영상 스트리밍](#streaming-videos)

비디오 플레이어 스마트 아이템이 동영상을 재생하는 시점은 여러 요소에 따라 달라질 수 있습니다:

* **자동**: 씬이 로드되는 즉시 동영상 재생이 시작됩니다. 이를 위해 기본 미디어 소스 드롭다운을 다음으로 설정하세요 **비디오 URL** 그리고 URL을 다음에 직접 붙여넣으세요 **비디오 경로 또는 .m3u8 URL** 필드에 붙여 넣어 자체 스트리밍 인프라를 지정하세요.

  ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d050af90f1b3bbb51c17f70ccdfd6ab0056b4057%2Fvideo-automatic.png?alt=media)
* **관리자가 트리거**: [씬 관리자](/creator/content-creator-ko/scene-editor/operate-live/scene-admin.md) 현재 씬에 있는 사용자는 관리 UI를 사용하여 동영상 URL을 붙여넣고 현재 씬에 있는 모든 플레이어에게 재생할 수 있습니다.
* **플레이어 동작 기반**: 다음 유형의 액션을 정의하세요 **비디오 재생**. 이를 통해 방에 들어가거나 버튼을 누르는 것처럼 다른 스마트 아이템과 상호작용한 결과로 동영상 재생을 트리거할 수 있습니다. 다음을 참조하세요 [Smart Items - 고급](/creator/content-creator-ko/scene-editor/interactivity/smart-items-advanced.md).

  ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-4d3db4d32f746dc116b09884db7c74ba53dbef7a%2Fvideo-from-action.png?alt=media)

모든 경우에서 동영상을 반복 재생할지 한 번만 재생할지 구성합니다.

{% hint style="warning" %}
**📔 참고**: 씬에서 동시에 너무 많은 동영상이 재생되면 일부는 엔진에 의해 일시 정지됩니다. 우선순위는 플레이어와의 거리, 카메라 방향 및 화면 크기를 기준으로 결정됩니다. 동시에 재생할 수 있는 최대 동영상 수는 플레이어의 품질 설정에 따라 달라집니다.

* 낮음: 1
* 중간: 5
* 높음: 10

또한 플레이어가 가까이 있거나 이를 위해 동작을 수행할 때 동영상 재생을 시작하는 것이 좋습니다. 씬이 먼 지평선에 로드될 때 동영상 재생을 시작하면 플레이어가 인접한 씬을 방문하는 동안 불필요하게 성능에 영향을 줍니다.
{% endhint %}

## 여러 비디오 화면

동일한 동영상을 여러 화면에서 동시에 재생할 수 있습니다. 이를 위해 비디오 플레이어 스마트 아이템의 고급 속성을 편집해야 합니다.

{% hint style="warning" %}
**📔 참고**: 서로 다른 동영상을 동시에 두 개 이상 재생하지 마세요. 성능에 큰 영향을 줍니다.

두 비디오 플레이어에 동일한 URL을 단순히 붙여넣으면 엔진은 이들이 동일한 동영상임을 알지 못하고 둘 다 별도로 재생합니다. 아래 단계를 따라 두 번째 비디오 플레이어가 첫 번째 비디오 플레이어와 동일한 동영상을 재생하도록 구성하세요.
{% endhint %}

1. 각 화면마다 하나씩, 씬에 비디오 플레이어 스마트 아이템 두 개를 추가하세요.
2. 첫 번째는 다음에 설명된 대로 일반적으로 구성하세요 [비디오 재생](#play-videos) 섹션.
3. 두 번째 비디오 플레이어에서 다음을 제거하세요 **비디오 플레이어** 컴포넌트를 부여해야 합니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-514512790126de29e5922a34a7bf9be49ffe4441%2Fdelete-video-player.png?alt=media)

{% hint style="warning" %}
**📔 참고**: 이 단계는 중요합니다. 그렇지 않으면 두 번째 비디오 플레이어가 보이지 않더라도 엔진에서 처리됩니다.
{% endhint %}

4. 두 번째 비디오 플레이어에서 계속해서 다음을 여세요 **재질** 컴포넌트에서 다음을 확장하세요 **텍스처** 섹션에서 다음을 선택하세요 **비디오 소스 엔터티** 드롭다운을 첫 번째 비디오 플레이어로 지정하세요.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5bf384e5fd6759644c26475e929af0696d3795b8%2Fpoint-to-video.png?alt=media)

각 비디오 플레이어가 동일한 비디오 플레이어를 가리키도록 구성하는 한, 원하는 수의 비디오 플레이어에 대해 같은 작업을 수행할 수 있습니다.

다음을 수행할 때 [라이브 스트리밍](/creator/content-creator-ko/scene-editor/operate-live/live-streaming.md), 두 화면에도 동일한 스트림이 표시됩니다.

{% hint style="info" %}
**💡 팁**: 위 단계는 다음이 있는 아이템에도 반복할 수 있습니다 **재질 바꾸기** 컴포넌트를 사용하여 모든 3D 모델을 동영상 화면으로 전환할 수 있습니다. 다음을 구성하세요 **텍스처** 섹션 내부의 **재질 바꾸기** 컴포넌트를 비디오 플레이어 엔터티로 지정하세요.
{% endhint %}

## 동영상 파일 정보

다음 파일 형식이 지원됩니다:

* *.mp4*
* *.ogg*
* *.webm*

동영상 파일은 씬의 전체 크기에 추가되므로 플레이어가 씬에 들어올 때 씬 다운로드 시간이 더 길어진다는 점을 유의하세요. 동영상 크기로 인해 다음을 초과할 수도 있습니다 [씬 제한 사항](/creator/content-creator-ko/sdk7/optimizing/scene-limitations.md), 구획당 사용할 수 있는 최대 용량이 15MB이기 때문입니다. 문제가 줄어들도록 동영상을 가능한 한 많이 압축하는 것을 권장합니다.

## 라이브 스트리밍

엔드투엔드 라이브 스트리밍은 다음을 참조하세요 [라이브 스트리밍](/creator/content-creator-ko/scene-editor/operate-live/live-streaming.md).

### 다른 소스에서 스트리밍

다른 스트리밍 인프라를 사용하여 동영상을 스트리밍할 수도 있습니다. 이렇게 하려면 비디오 플레이어 스마트 아이템을 다음을 사용하도록 구성하기만 하면 됩니다 **비디오 URL** 미디어 소스로 설정하고 스트림 URL을 다음에 붙여넣으세요 **비디오 경로 또는 .m3u8 URL** 필드에 붙여 넣어 자체 스트리밍 인프라를 지정하세요.

스트리밍 소스는 다음이어야 합니다 *https* URL (*http* URL은 지원되지 않음)이어야 하며, 소스에는 다음이 있어야 합니다 [CORS 정책(교차 출처 리소스 공유)](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) 외부 액세스를 허용하는 정책이 필요합니다. 즉, YouTube 또는 유사한 사이트에서는 동영상을 스트리밍할 수 없습니다. 이러한 사이트는 브랜드 HTML 위젯에서만 콘텐츠 표시를 허용하기 때문입니다. 다음을 참조하세요 [외부 스트리밍 정보](/creator/content-creator-ko/sdk7/media/video-playing.md#about-external-streaming) 옵션과 팁을 확인하세요.

동영상 스트리밍에는 여러 옵션이 있습니다. 가장 간단한 옵션은 다음과 같은 관리형 호스팅 제공업체를 사용하는 것입니다 [Vimeo](https://vimeo.com/), [Bunny](https://bunny.net), [Livepeer Studio](https://livepeer.studio/) 또는 [Serraform](https://serraform.gitbook.io/streaming-docs/guides/decentraland-playback) 여기서는 모든 스트리밍 인프라 관리를 위해 제공업체에 비용을 지불합니다.

읽기 [성공적인 스트리밍을 위한 OBS 설정](/creator/content-creator-ko/sdk7/media/video-playing.md#setting-up-obs-for-successful-streaming) Decentraland로 콘텐츠를 가장 효율적으로 스트리밍하는 방법에 대한 팁을 확인하세요.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/video-screen.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.