> 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-zh/chang-jing-bian-ji-qi/shi-shi-yun-wei/scene-admin.md). # 场景管理员 场景管理员对场景中实时发生的事件拥有特殊控制权。 授予某些玩家特殊角色 **管理员** 在你的场景中。 在直播活动期间，管理员可以在无需预先安排操作或依赖第三方服务的情况下，从 Decentraland 内部即时控制场景中发生的事情。等人群聚集到足够多时开始播放音乐，在合适的时机撒下彩屑，或者让宇宙飞船出现。 {% embed url="" %} 当场景管理员访问你的场景时，他们会在右上角看到一个只有他们自己能看到的特殊管理员面板。该面板在顶部使用图标标签在各个部分之间切换（视频、公告、智能物品、权限）。通过这个界面，他们可以播放视频或直播、发送公告、封禁玩家，或激活任何已配置为可通过这种方式激活的智能物品。这些操作会被场景中所有与管理员处于同一通信岛的其他玩家看到。 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ef6ca7ed3804223612f16fa60d45dd2fe09a72df%2Fadmin-console.png?alt=media) ## 设置管理员 要分配管理员，你需要添加 **管理工具** 将智能物品添加到你的场景。 ![](https://2460066822-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://2460066822-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://2460066822-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" %} **📔 注意**：只能从通过 **权限与审核** 标签手动添加到列表中的玩家身上移除管理员角色。作为场景所有者、操作员或租户的玩家会显示在此列表中，但无法通过此界面移除其管理员角色。要移除某个操作员的管理员角色，你必须先移除其操作员角色。 {% endhint %} 每当场景中有管理员玩家时，他们都会在右上角看到一个特殊界面。非管理员玩家看不到这个界面。 ![](https://2460066822-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) { // 显示仅管理员可见的界面、传送到舞台、显示实体等。 } } ``` {% hint style="info" %} **💡 提示**：有关异步函数的更多信息，请参见 [异步函数](/creator/content-creator-zh/chang-jing-sdk7/bian-cheng-mo-shi/async-functions.md). {% endhint %} ## 视频播放 管理员最常做的操作之一就是播放视频。管理员面板包含一个视频播放器部分，他们可以在这里控制与视频相关的任何内容。 要启用此功能，你需要向场景中添加一个 **视频播放器** 智能物品，并将其链接到 Admin Tools 智能物品。 1. 添加一个 **视频播放器** 智能物品到你的场景中 ![](https://2460066822-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-zh/chang-jing-bian-ji-qi/jiao-hu-xing/video-screen.md) ，以了解如何配置视频播放器智能物品的默认媒体源和其他设置。场景运行后，其中大多数配置都可以由管理员覆盖。

📔 注意：管理员只能管理在 Video Screen 智能物品上播放的视频，不能管理通过 SDK 代码添加的屏幕。

你可以包含任意多个视频屏幕。通常来说，避免同时播放多个不同视频，因为这会严重影响性能。

2. 打开 Admin Tools 智能物品，确保 **视频屏幕** 复选框已启用，以显示该部分。然后从下拉列表中选择屏幕，并为其指定一个友好名称，以便在管理员界面中显示。你可以添加任意多个视频屏幕，每个屏幕都独立控制。 场景名称 完成以上配置后，你场景中的管理员用户可以打开管理员面板并选择视频标签（通过顶部的图标标签）来控制这些视频屏幕。 场景名称 如果你的场景有多个彼此独立的视频屏幕， **屏幕** 下拉菜单可让你选择要控制哪个视频屏幕。列表会显示你在 Admin Tools 智能物品配置中为每个视频屏幕指定的名称。 {% hint style="info" %} **💡 提示**：要在多个屏幕上显示同一视频并将其作为一个整体控制，请参见 [多个视频屏幕](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/video-screen.md#multiple-video-screens). {% endhint %} ## 媒体源 视频部分顶部的分段控件可让你在三种媒体源之间切换。当前激活的源会通过胶囊标签显示。切换标签只会显示该源的设置，在你点击之前不会中断当前正在播放的内容 **激活**. * **视频 URL**：通过 URL 播放视频。将视频 URL 粘贴到字段中并点击 **激活**。视频将开始在所选屏幕上为所有玩家播放。你也可以停止、暂停、重新开始并调整音量。 场景名称

📔 注意：并不是任何视频 URL 都能正常工作。某些网站的视频对其内容有严格政策，会阻止 Decentraland 访问它们。参见 来自其他来源的流媒体 ，以了解在 Decentraland 中可以播放和不能播放的内容。

* **DCL Cast**：使用 Decentraland 的免费视频直播网页应用，可以轻松与场景中的其他玩家共享你的摄像头或屏幕，无需设置直播软件。演示控制（上一页、下一页、播放视频、停止）会在演示激活时以内联方式显示。 DCL Cast * **直播**：使用 Decentraland 的免费视频直播基础设施以及 OBS 或 StreamYard 等直播软件来播放直播流。 场景名称 参见 [直播](/creator/content-creator-zh/chang-jing-bian-ji-qi/shi-shi-yun-wei/live-streaming.md) ，以了解如何设置直播流。 每个媒体源部分都包含一个 **音量滑块** ，可让你将音量设置为 0%（静音）到 100%。 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d02037369d613aa59b3870b5cbad2a5914434f2a%2Factivate.png?alt=media) ## 公告 在 **公告** 标签中，管理员可以编写会被场景中所有玩家看到的消息。这样的消息只能由管理员发送，因此其他玩家会将其视为比某个自称是管理员的人在聊天中发送的消息更可信。 选择管理员面板中的公告标签。写一条消息并点击 **分享**。消息最长可达 90 个字符。发送后输入框会自动清空，因此你可以立即输入新消息。 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-495d94fd0f6bc44e948b8ff744687d7850de5fc3%2Fannouncement.png?alt=media) ## 封禁玩家 你可以通过选择管理员面板中的 **权限** 标签，输入你要封禁的玩家名称或钱包地址，然后点击 **封禁** 按钮。 ![](https://2460066822-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" %} **📔 注意**：你的封禁效果是立即且永久的。一旦玩家被封禁，他们会一直处于封禁状态，直到解封为止。在被封禁期间，玩家无法看到你的场景或与之交互，无法在场景中的附近频道聊天，场景中的其他玩家也看不到他们。 如果玩家走出你的场景边界，他们将不再受你的场景封禁规则影响，并且会再次看到被封禁的玩家。 {% 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-zh/chang-jing-bian-ji-qi/shi-shi-yun-wei/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.