> 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를 사용하세요 [스마트 아이템](/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\&token=a7478d28-02c6-407d-a7c3-e63d964f062e)

## 일반 설정

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

![](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\&token=90dfae8f-8dff-4b02-9d29-e0542e02dbd5)

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

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

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

## 비디오 재생

미리 녹화된 영상을 다음 중 하나에서 재생할 수 있습니다:

* **로컬 파일**: 장면의 일부로 비디오 파일을 업로드한 다음, *URL* 필드에 해당 파일의 경로를 지정합니다.
* **URL에서 스트리밍**: 웹상의 라이브 또는 미리 녹화된 스트림을 가리키세요. 예를 들어 Bunny 같은 제공업체에서 가져올 수 있습니다. 참조하세요 [영상 스트리밍](#streaming-videos)

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-d050af90f1b3bbb51c17f70ccdfd6ab0056b4057%2Fvideo-automatic.png?alt=media\&token=90dfae8f-8dff-4b02-9d29-e0542e02dbd5)
* **관리자에 의해 트리거됨**: 하나의 [장면 관리자](/creator/content-creator-ko/scene-editor/operate-live/scene-admin.md) 현재 장면에 있는 사람이 Admin UI를 사용해 비디오 URL을 붙여넣고 현재 장면에 있는 모든 플레이어에게 재생할 수 있습니다.
* **플레이어 동작에 기반**: 다음 유형의 Action을 정의하세요 **비디오 재생**. 이를 통해 방에 들어가거나 버튼을 누르는 것과 같이 다른 스마트 아이템과 상호작용한 결과로 영상 재생을 트리거할 수 있습니다. 참조하세요 [스마트 아이템 - 고급](/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\&token=26b270ee-2c1a-4095-a9ac-01bf62c879e9)

모든 경우에 영상을 반복 재생하거나 한 번만 재생하도록 구성합니다.

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

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

또한 플레이어가 가까이 있거나 해당 동작을 수행할 때 영상을 재생하기 시작하는 것을 권장합니다. 장면이 지평선 저 멀리 로드될 때 영상을 재생하기 시작하면 플레이어가 인접한 장면을 방문하는 동안 성능에 불필요하게 영향을 줍니다.
{% endhint %}

## 여러 비디오 화면

같은 영상을 여러 화면에서 동시에 재생할 수 있습니다. 이를 위해 Video Player 스마트 아이템의 고급 속성을 편집해야 합니다.

{% hint style="warning" %}
**📔 참고**: 서로 다른 여러 영상을 동시에 재생하지 않도록 하세요. 성능에 큰 영향을 미칩니다.

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

1. 장면에 두 개의 Video Player 스마트 아이템을 추가하세요. 화면마다 하나씩입니다.
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\&token=290f2048-4437-4133-8da0-7fecc9302024)

{% 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\&token=732a10e7-da1e-4a2b-b038-0f438fd1fb8e)

각 비디오 플레이어를 모두 같은 비디오 플레이어를 가리키도록 구성하는 한, 얼마든지 같은 방식으로 할 수 있습니다.

수행할 때 [라이브 스트리밍](/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).

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

다른 스트리밍 인프라를 사용해 영상도 스트리밍할 수 있습니다. 이를 위해 Video Player 스마트 아이템이 다음을 사용하도록 간단히 구성하세요 **비디오 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 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.