> 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/operate-live/live-streaming.md).

# 라이브 스트리밍

Video Screen과 Admin Tools를 사용해 씬으로 라이브 비디오를 스트리밍하세요.

사용하세요 **비디오 화면** 스마트 아이템과 함께 **관리자 도구** 스마트 아이템을 사용하여 씬에 라이브 비디오를 스트리밍합니다.

디센트럴랜드에서는 씬에 라이브 비디오를 스트리밍하는 여러 방법을 제공합니다:

* **DCL Cast** *(쉬운 모드)*: 디센트럴랜드의 무료 스트리밍 웹 앱을 사용해 별도의 스트리밍 소프트웨어 설정 없이 씬의 다른 플레이어들과 카메라나 화면을 쉽게 공유할 수 있습니다. 이 모드는 지연 시간이 가장 짧고 설정도 가장 쉽습니다.
* **스트림** *(고급 모드)*: 다음과 같은 스트리밍 소프트웨어를 사용하세요 [OBS](https://obsproject.com/) 디센트럴랜드의 스트리밍 인프라를 통해 스트리밍합니다. 이 모드는 화면 레이아웃과 오디오 소스처럼 스트림을 더 세밀하게 제어할 수 있습니다.
* **비디오 URL** *(고급 모드)*: URL을 **비디오 URL** 필드에 붙여 넣어 자체 스트리밍 인프라를 지정하세요.

<img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-4a5f55b4e645c0ffe6aefffd3f03c2dba5998e02%2Fstreaming-modes.png?alt=media" alt="스트림 방식" width="400">

스트리밍은 월드와 제네시스 시티에서 동작하며, 씬 측의 시청자 수에는 제한이 없습니다.

## 씬 구성하기

다음 단계는 DCL Cast와 Stream 방식 모두에 공통입니다:

1. 다음을 추가하세요 **비디오 화면** 스마트 아이템을 씬에 추가합니다.

   ![](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)
2. 스마트 아이템을 추가하고 **관리자 도구** 비디오 화면 **섹션을 활성화합니다. 드롭다운에서 각 화면을 선택하고 관리자 UI용으로 알아보기 쉬운 이름을 지정하세요.** 섹션을 활성화합니다. 드롭다운에서 각 화면을 선택하고 관리자 UI용으로 알아보기 쉬운 이름을 지정하세요.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-7c055a56398873268285f83c53eade303d1024cc%2Fmulti-video-setup.png?alt=media)
3. 씬(World 또는 제네시스 시티)을 게시하고 관리자 권한이 있는 사용자로 입장합니다.

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

씬이 게시되면 관리자 권한이 있는 사용자로 입장해 스트리밍 설정을 구성할 수 있습니다.

{% hint style="info" %}
**💡 팁**: 같은 비디오를 보여주기 위해 여러 비디오 화면을 추가하는 경우, 하나를 제외한 모든 화면의 소스를 같은 비디오 플레이어를 가리키도록 구성하세요. 자세한 내용은 [여러 비디오 화면](/creator/content-creator-ko/scene-editor/interactivity/video-screen.md#multiple-video-screens) 자세한 내용은 다음을 참조하세요.
{% endhint %}

## DCL Cast(쉬움)

### 앱 접근 권한 공유

게시된 씬에 관리자 사용자로 입장한 뒤 관리자 패널을 엽니다. 다음을 선택하세요 **비디오** 탭을 선택한 다음 **DCL Cast** 기능을 선택합니다.

<img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-30fd22f76c104ca0826210e291ba377e9bb11d51%2Fdcl-cast.png?alt=media" alt="DCL Cast" width="400">

다른 사람들과 복사해 공유할 수 있는 두 개의 링크가 표시됩니다.

* **Cast Speakers**: 이 링크는 발표자가 자신의 비디오를 씬에 송출할 때 사용합니다.

  <div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>❗경고</strong>: 스트리밍 링크는 비밀로 취급하고, 신뢰하는 사람에게만 공유하세요. 필요하면 발표자 사이에 링크를 재설정하세요.</p><p>스트리밍을 마치면 DCL Cast 브라우저 탭을 닫아 채널을 해제하세요.</p></div>
* **시청자**: 이 링크는 관객이 브라우저나 모바일에서 비디오를 시청할 때 사용합니다. 현재 디센트럴랜드 안에 있지 않은 플레이어에게 유용합니다.

다음의 **링크 복사** 버튼을 눌러 링크를 클립보드에 복사합니다.

스트리밍할 준비가 되면 **활성화** 버튼을 클릭해 씬의 관객에게 스트림이 보이도록 합니다.

<img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d02037369d613aa59b3870b5cbad2a5914434f2a%2Factivate.png?alt=media" alt="스트림 활성화" width="150">

어떤 이유로든 방을 재설정해야 한다면 **방 재설정** 버튼을 클릭해 새 방을 생성하세요. 현재 스트리밍 중인 사람은 모두 연결이 끊깁니다.

<img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-22a6f37702b2d6db0aa395f73f820825ef02642d%2Freset-room.png?alt=media" alt="방 재설정" width="150">

### DCL Cast 앱 사용하기

누군가 발표자 링크를 브라우저에 붙여 넣으면 다음과 같은 화면이 표시됩니다:

<img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-827cf2d40b68a2da0e0a104f3fc78621ffb13bbe%2Fdcl-cast-landing.png?alt=media" alt="DCL Cast 앱" width="400">

브라우저에서 카메라와 마이크 공유 권한을 요청합니다. 스트림에 사용할 여러 입력 장치도 구성할 수 있습니다.

{% hint style="info" %}
**📔 팁**: Google Chrome 또는 Chromium 엔진 기반 브라우저를 사용하세요. 이러한 브라우저는 브라우저 탭에서 비디오와 오디오를 직접 쉽게 공유할 수 있는 기능을 제공합니다.
{% endhint %}

사용자는 이름을 입력하고(디센트럴랜드 사용자 이름과 일치할 필요는 없음) **지금 참여** 버튼을 클릭해 스트리밍을 시작할 수 있습니다.

스트리밍이 시작되면 이 앱은 익숙한 여러 화상 회의 앱과 비슷해지며, 음소거/음소거 해제, 카메라 및 화면 공유 버튼, 채팅 인터페이스가 제공됩니다.

채팅은 읽기 전용이며, 디센트럴랜드 씬 안의 플레이어들이 보낸 모든 메시지를 수신합니다. 다른 기기에서 스트리밍 중이더라도 관객과 계속 소통할 수 있어 매우 유용합니다.

<img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-18632ba0a6e0d2970bad889f0aeeabce9ffc522d%2Fdcl-cast-app.png?alt=media" alt="DCL Cast 앱" width="700">

의 **참가자** 탭에서 세 개의 목록을 볼 수 있습니다:

* **발표자**: 현재 씬으로 스트리밍 중인 사람들입니다.
* **시청자**: 현재 브라우저에서 스트림을 시청 중인 사람들입니다.
* **인월드 참가자**: 현재 씬 안에서 스트림을 시청 중인 플레이어들입니다.

<img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f76c901dcdc1524efac9385c3a02431c9e23a051%2Fparticipants.png?alt=media" alt="참가자 탭" width="200">

DCL Cast 세션에 발표자가 여러 명 있으면 인월드 플레이어는 모든 발표자의 목소리를 듣게 되며, 영상은 현재 소리를 내고 있는 사람을 자동으로 표시하도록 전환되어 항상 누가 말하는지 보이게 됩니다.

이 기본 동작을 바꾸려면:

* 다음의 **발표자** 씬 관리자 패널의 버튼

<img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-416d79974ea970a31400dcce47d57051e416958c%2Fspeakers-button.png?alt=media" alt="참가자 탭" width="200">

* 발표자 중 한 명을 선택하고 보여줄 소스(그 발표자의 카메라 또는 화면)를 선택하세요

<img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-b88f3d636df869ed094c6cc505de6dde5bc41f62%2Fselect-speaker-source.png?alt=media" alt="참가자 탭" width="200">

이렇게 하면 다른 발표자가 말하고 있더라도 이 소스가 항상 화면에 표시됩니다.

{% hint style="info" %}
**📔 팁**: 인월드에서도 스트림을 시청 중이라면, DCL Cast 앱과 디센트럴랜드 씬 양쪽에서 같은 오디오가 반복되어 메아리처럼 들리는 것이 거슬릴 수 있습니다. 화면 왼쪽 아래의 스피커 아이콘을 전환하면 DCL Cast 앱의 모든 오디오를 쉽게 음소거할 수 있습니다

<img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-390f3bf8635a5966799928c4c633b8026b81d3d7%2Fmute-dcl-cast.png?alt=media" alt="Participants tab" data-size="original">

그렇지 않으면 디센트럴랜드 설정에서 오디오를 음소거할 수 있습니다.
{% endhint %}

### 프레젠테이션 공유

슬라이드 프레젠테이션의 내용을 이미지 소스로 대체해 공유할 수도 있습니다.

* 인월드에서 **프레젠테이션 공유** 버튼을 DCL Cast 탭에서 씬 내에서 클릭하세요. DCL Cast 앱에서는 **화면 공유** 버튼 옆의 드롭다운을 클릭하고 **프레젠테이션 공유**.

<img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-895fc29eb9263fdc6d225451e5e92f558dea1f84%2Fshare-presentation-dcl-cast.png?alt=media" alt="참가자 탭" width="200">

* Google 슬라이드 링크, Drive에 호스팅된 .pdf 링크 또는 이와 유사한 소스를 붙여 넣거나 .pdf 파일을 업로드하세요.

이제 프레젠테이션이 화면에 표시할 수 있는 소스가 되며, 모든 발표자의 목소리는 계속 들립니다.

{% hint style="warning" %}
**📔 참고**: 프레젠테이션 파일은 100MB 이하여야 합니다. Google 슬라이드 프레젠테이션은 *공개*.

DCL Cast 세션에서는 한 번에 하나의 활성 프레젠테이션만 존재할 수 있습니다.
{% endhint %}

그 후 DCL Cast 앱과 관리자 도구 UI의 인월드에서 모두 제공되는 버튼을 눌러 슬라이드를 전환하거나, 슬라이드에 포함된 비디오를 재생/일시정지할 수 있습니다.

## 스트림(고급)

씬에서 라이브 스트리밍 기능을 사용하려면 RTMP 엔드포인트로 출력할 수 있는 스트리밍 소프트웨어를 설치해야 합니다(예: [OBS](https://obsproject.com/), [XSplit](https://www.xsplit.com/), [StreamYard](https://streamyard.com/)).

{% hint style="warning" %}
**경고**: 라이브 스트리밍은 싱글 플레이어 월드에서는 지원되지 않습니다. 월드 설정에서 월드에 **싱글 플레이어** 가 활성화되어 있거나( `fixedAdapter` 가 `"offline:offline"` 로 `scene.json`설정되어 있다면 스트리밍을 설정하기 전에 비활성화하세요. 스트리밍 기능은 통신 계층에 의존하며, 이는 싱글 플레이어 모드에서는 비활성화됩니다.
{% endhint %}

### 스트림 자격 증명 받기

1. 씬의 관리자 UI를 엽니다(오른쪽 상단 아이콘).

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6cae96494f3809c3b4e4da9a55b1fa9c46922c48%2Fadmin-icon.png?alt=media)
2. 다음에서 **비디오** 탭에서 **스트림** 로 전환한 다음 **스트림 키 받기**.

   ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-14884b1619291b1390e768ab51817c57bf5e7eb6%2Fget-key.png?alt=media)
3. 다음을 복사하여 **RTMP 서버** 및 **스트림 키** 를 스트리밍 소프트웨어에 입력하세요.

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

{% hint style="danger" %}
**❗경고**: 한 번에 하나의 사람만 씬으로 스트리밍할 수 있습니다. 스트리밍을 마치면 **스트리밍 중지** 를 소프트웨어에서 클릭해 채널을 해제하세요.
{% endhint %}

### 스트림 시작 및 제어

1. 소프트웨어에서 스트리밍을 시작합니다.
2. 관리자 UI에서 **활성화** 를 클릭해 씬에 스트림을 표시합니다.

   <img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d02037369d613aa59b3870b5cbad2a5914434f2a%2Factivate.png?alt=media" alt="스트림 활성화" width="100">

### 스트림 키

스트림 키는 씬별로 생성되며 4일(96시간) 동안 유효합니다. 단일 라이브 세션은 최대 4시간 연속으로 실행할 수 있습니다.

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

* 클릭 **스트림 키 재설정** 를 눌러 현재 키를 폐기하고 새 키를 발급하세요. 진행 중인 스트림은 중단됩니다.
* 각 씬에는 고유한 스트리밍 주소와 키가 있습니다. 관리자는 외부 스트리머에게 키를 공유할 수 있습니다.
* 씬당 한 번에 하나의 스트림만 활성화할 수 있으며, 새 스트림을 시작하면 현재 스트림이 덮어써집니다.

{% hint style="danger" %}
**❗경고**: 스트림 키는 비밀로 취급하세요. 필요하면 발표자 사이에 키를 재설정하세요.
{% endhint %}

## URL에서 스트리밍(고급)

또한 비디오 화면을 다음 옵션을 사용하도록 설정하여 스트리밍할 수 있습니다 **비디오 URL** 그리고 스트림 URL을 붙여 넣습니다.

가장 인기 있는 비디오 스트리밍 사이트의 비디오를 가리키는 URL을 붙여 넣을 수 있어야 합니다. 해당 플랫폼의 서비스 약관에 유의하세요.

로컬 컴퓨터에 있는 비디오 파일에서 스트리밍하려면, 이 비디오를 공개 Google Drive에 업로드하고 링크를 붙여 넣는 것이 가장 쉽습니다.

* URL은 반드시 `https`. 자세한 내용은 [외부 스트리밍 정보](/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).


---

# 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/operate-live/live-streaming.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.
