> 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를 통해 비디오나 라이브 스트림을 재생하거나, 공지를 보내거나, 플레이어를 차단하거나, 이렇게 활성화하도록 설정된 모든 스마트 아이템을 활성화할 수 있습니다. 이러한 작업은 관리자가 있는 동일한 comms island에 연결된 씬의 다른 모든 플레이어에게도 보입니다. ![](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) ## 관리자 설정 관리자를 지정하려면 다음을 추가해야 합니다 **관리자 도구** 스마트 아이템을 씬에 추가합니다. ![](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) {% hint style="warning" %} **📔 참고**: 씬을 최신 종속성으로 업데이트하세요. {% endhint %} 씬을 개발하고 로컬에서 테스트하는 동안에는 항상 관리자입니다. 씬이 게시되면 씬에 대한 게시 권한이 있는 사람은 누구나 자동으로 관리자도 됩니다. 여기에는 다음이 포함됩니다: * 씬이 게시된 LAND 필지 또는 월드 이름의 소유자 * 다음 권한이 부여된 모든 사용자 **운영자 권한** 이러한 필지 또는 이름에서. 자세한 내용은 다음을 참조하세요. [권한 부여](https://docs.decentraland.org/player/marketplace/land-manager/#give-permissions). * 해당 토지를 임대 중인 모든 사용자. 자세한 내용은 다음을 참조하세요. [임대](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) 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) {% 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) ### 코드로 관리자 상태 확인 코드를 사용하여 플레이어가 씬의 관리자인지 알아내는 것도 가능합니다. 이를 통해 플레이어에게 다른 동작을 사용할 수 있게 하거나 사용할 수 없게 할 수 있습니다. 예를 들어 씬의 특정 엔티티와의 상호작용을 허용할 수 있습니다. ```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) 참고 [비디오 화면](/creator/content-creator-ko/scene-editor/interactivity/video-screen.md) Video Player 스마트 아이템의 기본 미디어 소스 및 기타 설정을 구성하는 방법에 대한 자세한 내용은 다음을 참조하세요. 이러한 구성 대부분은 씬이 실행된 후 관리자가 재정의할 수 있습니다.

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

원하는 만큼 비디오 화면을 추가할 수 있습니다. 일반적으로 동시에 서로 다른 비디오가 둘 이상 재생되지 않도록 하세요. 성능에 큰 영향을 줍니다.

2. Admin Tools 스마트 아이템을 열고 다음이 **섹션을 활성화합니다. 드롭다운에서 각 화면을 선택하고 관리자 UI용으로 알아보기 쉬운 이름을 지정하세요.** 이 섹션이 표시되도록 체크박스가 활성화되어 있는지 확인하세요. 그런 다음 드롭다운 목록에서 화면을 선택하고 Admin UI에 표시할 친숙한 이름을 지정하세요. 원하는 만큼 Video Screens를 추가할 수 있으며, 각 화면은 개별적으로 제어됩니다. 씬 이름 위 설정이 완료되면, 씬의 관리자 사용자는 관리자 패널을 열고 비디오 탭(상단의 아이콘 탭을 통해)을 선택해 이러한 비디오 화면을 제어할 수 있습니다. 씬 이름 씬에 서로 독립적인 비디오 화면이 여러 개 있다면, **화면** 드롭다운에서 제어할 비디오 화면을 선택할 수 있습니다. 목록에는 Admin Tools 스마트 아이템 구성에서 각 비디오 화면에 지정한 이름이 표시됩니다. {% hint style="info" %} **💡 팁**: 하나로 제어할 수 있는 여러 화면에 같은 비디오를 표시하려면 다음을 참조하세요 [여러 비디오 화면](/creator/content-creator-ko/scene-editor/interactivity/video-screen.md#multiple-video-screens). {% endhint %} ## 미디어 소스 비디오 섹션 상단의 세그먼트 컨트롤로 세 가지 미디어 소스 간에 전환할 수 있습니다. 현재 활성 소스는 pill 레이블로 표시됩니다. 탭을 전환해도 해당 소스의 설정만 표시될 뿐, 다음을 클릭할 때까지 현재 재생 중인 내용은 중단되지 않습니다 **활성화**. * **비디오 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) ## 공지 다음에서 **공지** 관리자 패널의 탭에서 관리자는 씬의 모든 플레이어가 볼 수 있는 메시지를 작성할 수 있습니다. 이런 메시지는 관리자만 보낼 수 있으므로, 다른 플레이어들은 자신이 관리자라고 주장하는 사람이 채팅에 올린 메시지보다 더 신뢰할 수 있는 것으로 인식할 것입니다. 관리자 패널의 공지 탭을 선택하세요. 메시지를 작성하고 다음을 클릭하세요 **공유**. 메시지는 최대 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) ## 플레이어 차단 씬에서 플레이어를 차단하려면 다음을 선택하세요 **권한** 관리자 패널의 탭에서, 차단하려는 플레이어의 이름이나 지갑 주소를 입력하고 다음을 클릭하세요 **차단** 버튼. ![](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) {% hint style="info" %} **💡 팁**: 플레이어의 지갑 주소를 확인하려면, 해당 아바타를 클릭해 프로필을 연 다음 다음 옆의 **클립보드에 복사** 버튼을 클릭하세요. {% endhint %} 차단된 플레이어는 씬을 로드하거나 콘텐츠와 상호작용할 수 없습니다. 다른 플레이어는 씬에서 그들을 볼 수 없고, 그들의 채팅 메시지도 읽을 수 없습니다. {% hint style="warning" %} **📔 참고**: 차단의 효과는 즉시 적용되며 영구적입니다. 플레이어가 차단되면 차단이 해제될 때까지 계속 차단된 상태로 남습니다. 차단된 동안에는 씬을 보거나 상호작용할 수 없고, 그 안에 있는 동안 Nearby 채널에서 채팅할 수 없으며, 씬의 다른 플레이어도 그들을 볼 수 없습니다. 플레이어가 씬의 경계를 벗어나면 더 이상 씬의 차단 규칙의 영향을 받지 않으며, 차단된 플레이어가 다시 보이게 됩니다. {% endhint %} 클릭 **차단 목록 보기** 현재 차단된 플레이어 목록을 보려면 다음을 참조하세요. 이 목록에서 다음도 **차단 해제** 플레이어 ## 스마트 아이템 트리거 씬의 어떤 스마트 아이템에서든 동작을 트리거하려면: * 스마트 아이템을 씬에 추가 * 다음의 설정을 여세요 **관리자 도구** Creator Hub의 스마트 아이템 * 다음에서 **스마트 아이템 액션** 섹션에서, 드롭다운에서 스마트 아이템을 추가하고, 사용자 지정 이름을 지정한 다음 기본 동작을 선택하세요 위 설정이 완료되면, 관리자는 다음을 열어 동작을 트리거할 수 있습니다 **스마트 아이템** 관리자 패널의 탭에서 드롭다운 목록의 항목을 선택합니다. 그런 다음 해당 항목의 동작 중 하나를 다음에서 선택할 수 있습니다 **동작** 드롭다운에서 선택하고 **동작 실행** 를 눌러 트리거합니다. 또한 다음 버튼도 있습니다 **숨기기/표시** 선택한 항목을. 씬 이름 이 목록의 어떤 스마트 아이템이든, 해당 작업을 위한 동작이 포함되어 있지 않더라도 표시하거나 숨길 수 있습니다. --- # 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/scene-admin.md?ask=&goal= ``` `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.