> 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-ying/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\&token=463da754-9254-4ec1-8e89-5000dc130b8e) ## 设置管理员 要分配管理员，你需要添加 **管理工具** 将智能物品添加到你的场景中。 ![](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\&token=3ca8eae9-b2a9-4eec-a143-071588d47b4e) {% hint style="warning" %} **📔 注意**：更新你的场景以使用最新依赖项。 {% endhint %} 在你开发场景并在本地试运行时，你始终是管理员。场景发布后，任何拥有该场景发布权限的人也会自动成为管理员。这包括： * 场景发布所在的 LAND 地块或 World 名称的所有者 * 任何被授予 **操作员权限** 在这些地块或名称上的权限。参见 [授予权限](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\&token=410f0301-681e-4110-9c79-71ed16ef806c) 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\&token=22fdb5d7-b513-450a-81e1-9b77035d99ec) {% 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\&token=463da754-9254-4ec1-8e89-5000dc130b8e) ### 通过代码检查管理员状态 也可以使用代码判断某个玩家是否是场景管理员。这可以让某些行为对玩家可用（或不可用），例如允许与场景中的特定实体交互。 ```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\&token=a7478d28-02c6-407d-a7c3-e63d964f062e) 参见 [视频屏幕](/creator/content-creator-zh/chang-jing-bian-ji-qi/jiao-hu-xing/video-screen.md) 有关如何配置 Video Player 智能物件的默认媒体源和其他设置的更多详细信息。场景运行后，管理员可以覆盖其中大多数配置。

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

你可以包含任意多个视频屏幕。一般来说，尽量不要同时播放多个不同的视频，因为这会严重影响性能。

2. 打开 Admin Tools Smart Item，确保 **视频屏幕** 已启用该部分的复选框，以显示此部分。然后从下拉列表中选择屏幕，并为其指定一个友好名称，以便在管理员界面中显示。你可以添加任意多个 Video Screens，每个屏幕都可独立控制。 场景名称 完成上述配置后，你场景中的管理员用户可以打开管理员面板，并选择视频选项卡（通过顶部的图标标签）来控制这些视频屏幕。 场景名称 如果你的场景有多个独立的视频屏幕， **屏幕** 下拉菜单可让你选择要控制哪个视频屏幕。列表会显示你在 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 都能正常工作。某些网站的视频对其内容有严格政策，会阻止 Decentraland 访问。请参见 来自其他来源的流媒体 了解在 Decentraland 中可以和不可以播放的内容。

* **DCL Cast**：使用 Decentraland 的免费视频流 Web 应用，轻松与场景中的其他玩家共享你的摄像头或屏幕，无需设置流媒体软件。当演示处于活动状态时，演示控制（上一页、下一页、播放视频、停止）会以内联方式显示。 DCL Cast * **流媒体**：使用 Decentraland 的免费视频流基础设施以及 OBS 或 StreamYard 等流媒体软件播放直播。 场景名称 参见 [直播流](/creator/content-creator-zh/chang-jing-bian-ji-qi/shi-shi-yun-ying/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\&token=3e11fe70-05b3-4970-9bd2-f0b20c08fd41) ## 公告 在 **公告** 在管理员面板的选项卡中，管理员可以编写所有场景玩家都能看到的消息。此类消息只能由管理员发送，因此其他玩家会认为它们比聊天中某个自称管理员的人发的消息更可信。 选择管理员面板的公告选项卡。写一条消息并点击 **分享**。消息最长可达 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\&token=dc514238-c132-4fdf-9410-4021e06b9e88) ## 封禁玩家 你可以通过选择管理员面板的 **权限** 选项卡，输入你要封禁的玩家姓名或钱包地址，然后点击 **封禁** 按钮。 ![](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\&token=410f0301-681e-4110-9c79-71ed16ef806c) {% 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 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-zh/chang-jing-bian-ji-qi/shi-shi-yun-ying/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.