> 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/scene-admin.md). # 씬 관리자 씬 관리자는 씬에서 일어나는 일을 실시간으로 특별하게 제어할 수 있습니다. 일부 플레이어에게 다음의 특별 역할을 부여하세요 **관리자** 당신의 씬에서. 라이브 이벤트 중에는 관리자가 Decentraland 안에서 씬에서 벌어지는 일을 즉석에서 제어할 수 있으며, 동작을 미리 예약하거나 제3자 서비스에 의존할 필요가 없습니다. 군중이 충분히 모이면 음악을 재생하고, 분위기가 무르익으면 색종이를 뿌리거나 우주선이 나타나게 할 수 있습니다. {% embed url="" %} 씬 관리자가 당신의 씬을 방문하면, 오른쪽 상단에 관리자만 볼 수 있는 특별한 관리자 패널이 표시됩니다. 이 패널은 상단의 아이콘 탭을 사용해 섹션(비디오, 공지사항, 스마트 아이템, 권한) 간에 전환합니다. 이 UI를 통해 비디오나 라이브 스트림을 재생하고, 공지를 보내고, 플레이어를 차단하거나, 이렇게 활성화되도록 설정된 스마트 아이템을 활성화할 수 있습니다. 이러한 동작은 관리자와 동일한 커뮤니케이션 아일랜드에 연결된 씬의 다른 모든 플레이어에게 보입니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ef6ca7ed3804223612f16fa60d45dd2fe09a72df%2Fadmin-console.png?alt=media\&token=463da754-9254-4ec1-8e89-5000dc130b8e) ## 관리자 설정하기 관리자를 지정하려면 다음을 추가해야 합니다 **관리자 도구** 장면에 스마트 아이템을 추가하세요. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-15c658c9f27e5caf06e949d5d20f3ccc698ddd83%2Fadmin-smart-item.png?alt=media\&token=3ca8eae9-b2a9-4eec-a143-071588d47b4e) {% hint style="warning" %} **📔 참고**: 씬을 최신 의존성으로 업데이트하세요. {% endhint %} 씬을 개발하고 로컬에서 테스트하는 동안에는 항상 관리자입니다. 씬이 게시되면, 씬에 대한 게시 권한이 있는 사람은 누구나 자동으로 관리자이기도 합니다. 여기에는 다음이 포함됩니다: * 씬이 게시된 LAND 구획 또는 월드 이름의 소유자 * 다음을 부여받은 사람은 누구나 **운영자 권한** 이 구획 또는 이름에서. 다음을 참조하세요 [권한 부여](https://docs.decentraland.org/player/marketplace/land-manager/#give-permissions). * 해당 LAND를 임대 중인 모든 사용자. 다음을 참조하세요 [임대](https://docs.decentraland.org/player/marketplace/rentals/). 게시 권한은 없지만 씬에서 라이브 운영을 할 수 있는 추가 관리자를 지정하려면: 1. 씬을 게시하고 관리자로서 라이브 버전을 방문하세요 2. 다음을 열고 **권한** 탭(관리자 패널 상단의 아이콘 탭을 통해). ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-661a1eede71f488537e08ab65b71bb999f9a6a0e%2Fmoderation-tools.png?alt=media\&token=410f0301-681e-4110-9c79-71ed16ef806c) 3. 추가하려는 사람의 지갑 주소를 다음 옆에 입력하세요 **관리자 추가** 그리고 다음을 클릭하세요 **추가**. 다음을 클릭하면 씬에서 누가 관리자인지 확인할 수 있습니다 **관리자 목록 보기** 버튼. 이 화면에서 다음도 할 수 있습니다 **제거** 관리자 목록에서 사람을 제거할 수 있습니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-04856bc10ed6ef6e5463a1d178f184618cca36f8%2Fadmin-list.png?alt=media\&token=22fdb5d7-b513-450a-81e1-9b77035d99ec) {% hint style="warning" %} **📔 참고**: 관리 역할은 다음을 통해 목록에 수동으로 추가된 플레이어에게서만 제거할 수 있습니다 **권한 및 중재** 탭. 씬의 소유자, 운영자 또는 임차인은 이 목록에 표시되지만 이 UI에서는 관리자 역할을 제거할 수 없습니다. 운영자의 관리자 역할을 제거하려면 먼저 운영자 역할을 제거해야 합니다. {% endhint %} 관리자 플레이어가 씬에 있으면 오른쪽 상단에 특별한 UI가 표시됩니다. 비관리자 플레이어에게는 이 UI가 표시되지 않습니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ef6ca7ed3804223612f16fa60d45dd2fe09a72df%2Fadmin-console.png?alt=media\&token=463da754-9254-4ec1-8e89-5000dc130b8e) ### 코드로 관리자 상태 확인 코드를 사용해 플레이어가 씬의 관리자인지 알아낼 수도 있습니다. 이를 통해 플레이어에게 다른 동작을 사용할 수 있게 하거나(또는 사용할 수 없게) 할 수 있습니다. 예를 들어 씬의 특정 엔터티와의 상호작용을 허용할 수 있습니다. ```ts import { isAdmin } from "@dcl/asset-packs/dist/admin"; async function onPlayerSpawn() { const isAdminUser = await isAdmin(); if (isAdminUser) { // 관리자 전용 UI 표시, 무대로 이동, 엔터티 표시 등 } } ``` {% hint style="info" %} **💡 팁**: 비동기 함수에 대한 자세한 내용은 다음을 참조하세요 [비동기 함수](/creator/content-creator-ko/sdk7/programming-patterns/async-functions.md). {% endhint %} ## 비디오 재생 관리자가 수행하는 가장 일반적인 작업 중 하나는 비디오를 재생하는 것입니다. 관리자 패널에는 비디오 관련 모든 것을 제어할 수 있는 비디오 플레이어 섹션이 포함되어 있습니다. 이를 활성화하려면 다음을 추가해야 합니다 **비디오 플레이어** 스마트 아이템을 씬에 추가하고 이를 Admin Tools 스마트 아이템에 연결해야 합니다. 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\&token=a7478d28-02c6-407d-a7c3-e63d964f062e) 다음 [비디오 화면](/creator/content-creator-ko/scene-editor/interactivity/video-screen.md) Video Player 스마트 아이템의 기본 미디어 소스와 기타 설정을 구성하는 방법에 대한 자세한 내용은 다음을 참조하세요. 이러한 설정 대부분은 씬이 실행된 후 관리자가 재정의할 수 있습니다.

📔 참고: 관리자는 Video Screen 스마트 아이템에서 재생되는 비디오만 관리할 수 있으며, SDK 코드로 추가한 화면은 관리할 수 없습니다.

원하는 만큼 비디오 화면을 포함할 수 있습니다. 일반적으로 동시에 서로 다른 비디오를 두 개 이상 재생하지 마세요. 성능에 큰 영향을 줍니다.

2. Admin Tools Smart Item을 열고 다음이 **비디오 화면** 이 섹션을 표시하려면 체크박스가 활성화되어 있는지 확인하세요. 그런 다음 드롭다운 목록에서 화면을 선택하고 관리자 UI에 표시할 친숙한 이름을 지정하세요. 원하는 만큼 Video Screens를 추가할 수 있으며, 각 화면은 독립적으로 제어됩니다. 씬 이름 위 설정이 완료되면, 씬의 관리자 사용자는 관리자 패널을 열고 상단의 아이콘 탭을 통해 비디오 탭을 선택해 이러한 비디오 화면을 제어할 수 있습니다. 씬 이름 씬에 서로 독립적인 비디오 화면이 여러 개 있다면, **화면** 드롭다운에서 제어할 비디오 화면을 선택할 수 있습니다. 목록에는 Admin Tools 스마트 아이템 구성에서 각 비디오 화면에 지정한 이름이 표시됩니다. {% hint style="info" %} **💡 팁**: 여러 화면에 동일한 비디오를 표시하고 하나로 제어하려면 다음을 참조하세요 [여러 비디오 화면](/creator/content-creator-ko/scene-editor/interactivity/video-screen.md#multiple-video-screens). {% endhint %} ## 미디어 소스 비디오 섹션 상단의 분할형 컨트롤을 사용하면 세 가지 미디어 소스 간에 전환할 수 있습니다. 현재 활성 소스는 필 모양의 레이블로 표시됩니다. 탭을 전환하면 해당 소스의 설정만 표시되며, 다음을 클릭할 때까지 현재 재생 중인 내용은 중단되지 않습니다 **활성화**. * **비디오 URL**: URL에서 비디오를 재생합니다. 비디오 URL을 필드에 붙여넣고 다음을 클릭하세요 **활성화**. 비디오는 선택한 화면에서 모든 플레이어에게 재생되기 시작합니다. 중지, 일시정지, 다시 시작, 볼륨 조절도 할 수 있습니다. 씬 이름

📔 참고: 어떤 비디오 URL이든 작동하는 것은 아닙니다. 일부 사이트의 비디오는 콘텐츠에 대해 엄격한 정책을 가지고 있어 Decentraland에서의 접근을 차단합니다. 다음을 참조하세요 다른 소스에서 스트리밍하기 Decentraland에서 재생할 수 있는 것과 없는 것에 대한 자세한 내용은 다음을 참조하세요.

* **DCL Cast**: Decentraland의 무료 스트리밍 웹 앱을 사용하면 스트리밍 소프트웨어를 따로 설정할 필요 없이 씬의 다른 플레이어와 카메라나 화면을 쉽게 공유할 수 있습니다. 프레젠테이션이 활성화되면 프레젠테이션 컨트롤(이전, 다음, 비디오 재생, 중지)이 인라인으로 표시됩니다. DCL Cast * **스트림**: Decentraland의 무료 스트리밍 인프라와 OBS 또는 StreamYard 같은 스트리밍 소프트웨어를 사용해 라이브 스트림을 재생합니다. 씬 이름 다음 [라이브 스트리밍](/creator/content-creator-ko/scene-editor/operate-live/live-streaming.md) 라이브 스트림 설정 방법에 대한 자세한 내용은 다음을 참조하세요. 각 미디어 소스 섹션에는 다음이 포함됩니다 **볼륨 슬라이더** 0%(음소거)에서 100%까지 볼륨을 설정할 수 있습니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d02037369d613aa59b3870b5cbad2a5914434f2a%2Factivate.png?alt=media\&token=3e11fe70-05b3-4970-9bd2-f0b20c08fd41) ## 공지사항 의 **공지사항** 관리자 패널의 탭에서 관리자는 씬의 모든 플레이어가 볼 수 있는 메시지를 작성할 수 있습니다. 이러한 메시지는 관리자만 보낼 수 있으므로, 다른 플레이어들은 자신이 관리자라고 주장하는 사람이 채팅에 올린 메시지보다 더 신뢰할 수 있는 것으로 인식합니다. 관리자 패널의 공지사항 탭을 선택하세요. 메시지를 작성하고 다음을 클릭하세요 **공유**. 메시지는 최대 90자까지 작성할 수 있습니다. 전송 후 입력 필드는 자동으로 지워지므로 바로 새 메시지를 입력할 수 있습니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-495d94fd0f6bc44e948b8ff744687d7850de5fc3%2Fannouncement.png?alt=media\&token=dc514238-c132-4fdf-9410-4021e06b9e88) ## 플레이어 차단하기 관리자 패널의 다음을 선택하여 씬에서 플레이어를 차단할 수 있습니다 **권한** 탭에서 차단하려는 플레이어의 이름 또는 지갑 주소를 입력한 다음 다음을 클릭하세요 **차단** 버튼. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-661a1eede71f488537e08ab65b71bb999f9a6a0e%2Fmoderation-tools.png?alt=media\&token=410f0301-681e-4110-9c79-71ed16ef806c) {% hint style="info" %} **💡 팁**: 플레이어의 지갑 주소를 얻으려면 아바타를 클릭해 프로필을 연 다음 다음을 클릭하세요 **클립보드에 복사** 지갑 주소 옆의 버튼을 {% endhint %} 차단된 플레이어는 당신의 씬을 불러오거나 그 안의 어떤 콘텐츠와도 상호작용할 수 없습니다. 다른 플레이어는 씬에서 그들을 볼 수 없으며, 그들의 채팅 메시지도 읽을 수 없습니다. {% hint style="warning" %} **📔 참고**: 차단 효과는 즉시 적용되며 영구적입니다. 한 번 차단된 플레이어는 차단이 해제될 때까지 계속 차단된 상태로 남습니다. 차단된 동안에는 플레이어가 당신의 씬을 보거나 상호작용할 수 없고, 그 안에 있는 동안 Nearby 채널에서 채팅할 수도 없으며, 씬의 다른 플레이어도 그들을 볼 수 없습니다. 플레이어가 당신의 씬 경계를 벗어나면 더 이상 씬의 차단 규칙의 영향을 받지 않으며, 차단된 플레이어를 다시 볼 수 있게 됩니다. {% endhint %} 클릭 **차단 목록 보기** 현재 차단된 플레이어 목록을 보려면 다음을 클릭하세요. 이 목록에서 다음도 할 수 있습니다 **차단 해제** 플레이어. ## 스마트 아이템 트리거하기 씬의 어떤 스마트 아이템에서든 액션을 트리거하려면: * 스마트 아이템을 씬에 추가하세요 * 다음의 설정을 여세요 **관리자 도구** Creator Hub의 Smart Item * 의 **스마트 아이템 액션** 섹션에서 드롭다운에서 스마트 아이템을 추가하고, 사용자 지정 이름을 지정한 다음 기본 액션을 선택하세요 위 설정이 완료되면 관리자는 다음을 열어 액션을 트리거할 수 있습니다 **스마트 아이템** 관리자 패널의 탭에서 드롭다운 목록에서 항목을 선택하세요. 그런 다음 다음에서 해당 항목의 액션 중 하나를 고를 수 있습니다 **동작** 드롭다운에서 다음을 클릭하세요 **액션 재생** 를 트리거합니다. 또한 다음을 위한 버튼도 있습니다 **숨기기/표시** 선택한 항목을. 씬 이름 이 목록의 어떤 스마트 아이템이든, 그렇게 하는 액션이 포함되어 있지 않더라도 표시하거나 숨길 수 있습니다. --- # 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/operate-live/scene-admin.md?ask=&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.