> 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).

# 비디오 화면

씬에서 비디오 재생하기

미리 녹화했거나 스트리밍 중인 동영상을 씬의 화면에서 재생하려면 Video Player를 사용하세요. [스마트 아이템](https://docs.decentraland.org/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-4ffd58cadcc524a13cd567ca4d5ccdc70fc994f2%2Fvideo-player-item.webp?alt=media)

## 일반 설정

이 설정은 동영상 재생과 스트리밍 모두에 적용됩니다.

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

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

The **기본 미디어 소스** 드롭다운에서 다음 두 가지 소스 유형 중 하나를 선택할 수 있습니다:

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

## 동영상 재생

다음 위치에서 미리 녹화된 동영상을 재생할 수 있습니다.

* **로컬 파일**: 장면에 동영상 파일을 업로드한 다음, *URL* 필드에 해당 파일의 경로를 지정합니다.
* **URL에서 스트리밍**: Bunny와 같은 제공업체의 웹에 있는 라이브 스트림이나 사전 녹화된 스트림을 지정합니다. 자세한 내용은 [스트리밍 동영상](#streaming-from-other-sources)

Video Player 스마트 항목의 동영상 재생 시점은 여러 요인에 따라 달라질 수 있습니다.

* **자동**: 장면이 로드되는 즉시 동영상 재생이 시작됩니다. 이렇게 하려면 기본 미디어 소스 드롭다운에서 **동영상 URL** 을 선택하고 URL을 **동영상 경로 또는 .m3u8 URL** 필드에 직접 붙여넣습니다.

  ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e541aa1b70f1acbe5fa979cb3159a5997996d783%2Fvideo-automatic.webp?alt=media)
* **관리자가 트리거한 경우**: 다음과 같은 [씬 관리자](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/operate-live/scene-admin.md) 현재 씬에 있는 사용자는 관리자 UI에 동영상 URL을 붙여 넣어 현재 씬에 있는 모든 플레이어에게 재생할 수 있습니다.
* **플레이어의 동작을 기반으로**: 유형이 다음과 같은 액션을 정의합니다. **동영상 재생**. 이를 통해 방에 들어가거나 버튼을 누르는 등 다른 스마트 아이템과 상호작용한 결과로 동영상 재생을 트리거할 수 있습니다. 자세한 내용은 [스마트 아이템 - 고급](https://docs.decentraland.org/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-7cc86ee3e3592207911f08a950a62534af287e21%2Fvideo-from-action.webp?alt=media)

모든 경우에 동영상을 반복 재생하거나 한 번만 재생하도록 설정할 수 있습니다.

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

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

또한 플레이어가 가까이 다가오거나 동영상 재생을 시작하는 동작을 할 때 동영상이 재생되도록 하는 것이 좋습니다. 장면이 로드되자마자 저 멀리 있는 동영상의 재생을 시작하면 플레이어가 주변 장면을 방문하는 동안 성능에 불필요한 영향을 줍니다.
{% endhint %}

## 여러 비디오 화면

같은 동영상을 여러 화면에서 동시에 재생할 수 있습니다. 이렇게 하려면 Video Player 스마트 항목의 고급 속성을 수정해야 합니다.

{% hint style="warning" %}
**📔 참고**: 성능이 크게 저하되므로 서로 다른 동영상이 둘 이상 동시에 재생되지 않도록 하세요.

두 비디오 플레이어에 같은 URL을 붙여넣기만 하면 엔진은 두 플레이어가 같은 비디오를 재생한다는 사실을 알지 못해 각각 별도로 재생합니다. 아래 단계에 따라 두 번째 비디오 플레이어가 첫 번째 플레이어와 같은 비디오를 재생하도록 설정하세요.
{% endhint %}

1. 장면에 Video Player 스마트 아이템을 두 개 추가합니다. 각 화면에 하나씩 추가하세요.
2. 첫 번째 플레이어는 다음의 설명에 따라 일반적인 방법으로 설정합니다. [비디오 재생](#play-videos) 섹션을 참조하세요.
3. 두 번째 비디오 플레이어에서는 **Video Player** 컴포넌트를 제거합니다.

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

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

4. 두 번째 비디오 플레이어에서 계속해서 **Material** 컴포넌트를 열고 **Texture** 섹션을 펼친 다음 **Video Source Entity** 드롭다운에서 첫 번째 비디오 플레이어를 선택합니다.

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

각 플레이어가 같은 비디오 플레이어를 가리키도록 설정하면 원하는 수만큼 비디오 플레이어에 같은 방법을 적용할 수 있습니다.

다음과 같이 [라이브 스트리밍](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/operate-live/live-streaming.md)을 진행하면 두 화면에 같은 스트림이 표시됩니다.

{% hint style="info" %}
**💡 팁**: 위 단계를 **Swap Material** 컴포넌트가 있는 아이템에도 적용하여 모든 3D 모델을 비디오 화면으로 만들 수 있습니다. **Texture** 섹션에서 **Swap Material** 컴포넌트를 설정해 비디오 플레이어 엔티티를 가리키도록 하세요.
{% endhint %}

## 비디오 파일 정보

다음 파일 형식을 지원합니다:

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

비디오 파일은 장면의 전체 용량에 포함되므로 장면에 들어오는 플레이어가 장면을 다운로드하는 데 시간이 더 오래 걸립니다. 또한 비디오 용량 때문에 [장면 제한](https://docs.decentraland.org/creator/content-creator-ko/sdk7/optimizing/scene-limitations.md)을 초과할 수도 있습니다. 각 구획에 사용할 수 있는 용량은 최대 15MB입니다. 문제가 생기지 않도록 비디오를 최대한 압축하는 것을 권장합니다.

## 라이브 스트리밍

엔드투엔드 라이브 스트리밍에 관한 내용은 다음을 참조하세요. [라이브 스트리밍](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/operate-live/live-streaming.md).

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

다른 스트리밍 인프라를 사용해 비디오를 스트리밍할 수도 있습니다. 이렇게 하려면 Video Player 스마트 아이템이 **Video URL** 미디어 소스를 사용하도록 설정한 다음 스트림 URL을 **Video Path or .m3u8 URL** 필드에 붙여넣습니다.

스트리밍 소스는 *https* URL이어야 합니다(*http* URL은 지원되지 않음). 또한 소스에는 외부에서 접근할 수 있도록 허용하는 [CORS 정책(Cross Origin Resource Sharing)](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) 이 설정되어 있어야 합니다. 즉, YouTube 등의 사이트에서는 비디오를 스트리밍할 수 없습니다. 이런 사이트는 브랜드 HTML 위젯에서만 콘텐츠를 표시하도록 허용하기 때문입니다. 자세한 내용은 다음을 참조하세요. [외부 스트리밍 정보](https://docs.decentraland.org/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 설정](https://docs.decentraland.org/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
