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

# 直播

使用视频屏幕和管理工具将实时视频流传入你的场景。

使用 **视频屏幕** 智能物品以及 **管理工具** 用于将直播视频传输到你的场景中的智能物品。

Decentraland 提供多种将直播视频传输到你的场景中的方式：

* **DCL Cast** *（简单模式）*：使用 Decentraland 的免费直播网页应用，可轻松与场景中的其他玩家共享你的摄像头或屏幕，无需设置直播软件。此模式延迟最低，也最容易设置。
* **直播** *（高级模式）*：使用类似于 [OBS](https://obsproject.com/) 的直播软件，通过 Decentraland 的直播基础设施进行直播。此模式让你对直播有更多控制，例如屏幕布局和音频源。
* **视频 URL** *（高级模式）*：通过将 URL 粘贴到 **视频 URL** 字段中。

<img src="https://2460066822-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">

直播可在 Worlds 和 Genesis City 中使用，场景端没有观众人数限制。

## 配置场景

以下步骤适用于 DCL Cast 和 Stream 两种方式：

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)
2. 添加一个 **管理工具** 智能物品并启用该 **视频屏幕** 部分。从下拉菜单中选择每个屏幕，并为管理界面指定一个友好的名称。

   ![](https://2460066822-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 或 Genesis City），并以具有管理员权限的用户身份进入。

   ![](https://2460066822-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-zh/chang-jing-bian-ji-qi/jiao-hu-xing/video-screen.md#multiple-video-screens) 了解更多详情。
{% endhint %}

## DCL Cast（简单）

### 共享应用访问权限

以管理员用户身份进入你已发布的场景，并打开管理面板。选择 **视频** 选项卡，然后选择 **DCL Cast** 功能。

<img src="https://2460066822-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">

你会看到两个链接，可以复制并与他人分享。

* **演讲者**：此链接供演讲者将他们的视频投送到场景中使用。

  <div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>❗警告</strong>：将直播链接视为机密，只与信任的人分享。如有需要，在不同演讲者之间重置该链接。</p><p>直播结束后，关闭 DCL Cast 浏览器标签页以释放频道。</p></div>
* **观众**：此链接供观众通过浏览器或移动设备观看视频使用。这对当前不在 Decentraland 内的玩家很有用。

点击 **复制链接** 按钮将链接复制到剪贴板。

准备好直播时，点击 **激活** 按钮即可让场景中的观众看到直播。

<img src="https://2460066822-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://2460066822-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://2460066822-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 或基于 Chrome 引擎的浏览器。这些浏览器支持直接从浏览器标签页轻松共享视频和音频。
{% endhint %}

用户可以输入一个名称（不必与他们的 Decentraland 用户名一致），然后点击 **立即加入** 按钮开始直播。

开始直播后，该应用类似于各种熟悉的视频会议应用，提供静音/取消静音、共享摄像头和屏幕以及聊天界面的按钮。

聊天是只读的，可接收 Decentraland 场景内玩家发送的所有消息。即使你从不同设备直播，这也非常适合与观众保持联系。

<img src="https://2460066822-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://2460066822-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://2460066822-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://2460066822-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 应用和 Decentraland 场景中重复播放的音频回声很突兀。你可以通过切换屏幕左下角的扬声器图标，轻松将 DCL Cast 应用中的所有音频静音

<img src="https://2460066822-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">

否则你可以在 Decentraland 设置中将音频静音。
{% endhint %}

### 分享演示文稿

你也可以分享幻灯片演示文稿的内容，作为另一种图像来源。

* 在场景内，点击 **分享演示文稿** 按钮。在场景内的 DCL Cast 选项卡中。从 DCL Cast 应用中，点击旁边的下拉菜单 **共享屏幕** 按钮并选择 **分享演示文稿**.

<img src="https://2460066822-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 Slides 链接、Drive 上托管的 .pdf 链接或类似来源，或者上传 .pdf 文件。

现在该演示文稿将成为可选择显示在屏幕上的一个来源，同时仍能听到所有演讲者的声音。

{% hint style="warning" %}
**📔 注意**：演示文件必须小于 100 MB。Google Slides 演示文稿必须设置为 *公开*.

在 DCL Cast 会话中，同一时间只能有一个活动演示文稿。
{% endhint %}

然后你可以切换幻灯片，甚至通过按下 DCL Cast 应用和场景内 Admin Tools 界面中都存在的按钮来播放或暂停这些幻灯片中嵌入的任何视频。

## 直播（高级）

要在你的场景中使用直播功能，你需要安装一个可输出到 RTMP 端点的流媒体软件（例如 [OBS](https://obsproject.com/), [XSplit](https://www.xsplit.com/), [StreamYard](https://streamyard.com/)).

{% hint style="warning" %}
**警告**：单人模式世界不支持直播。如果你的世界已启用 **单人模式** 在世界设置中启用（或 `fixedAdapter` 设置为 `"offline:offline"` 在 `scene.json`）中，请在设置直播前将其禁用。直播功能依赖于通信层，而单人模式会禁用该通信层。
{% endhint %}

### 获取直播凭据

1. 打开场景中的管理界面（右上角图标）。

   ![](https://2460066822-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://2460066822-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://2460066822-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. 在管理界面中，点击 **激活** 以在场景中显示直播。

   <img src="https://2460066822-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://2460066822-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 直播（高级）

你也可以通过将 Video Screen 配置为使用该选项来直播 **视频 URL** 并粘贴直播 URL。

你应该能够粘贴指向大多数流行视频流媒体网站视频的 URL。请注意这些平台的服务条款。

若要从本地设备上的视频文件进行直播，最简单的方法是将该视频上传到公开的 Google Drive，然后粘贴链接。

* URL 必须是 `https`。见 [关于外部直播](/creator/content-creator-zh/chang-jing-sdk7/mei-ti/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-zh/chang-jing-sdk7/mei-ti/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-zh/chang-jing-bian-ji-qi/shi-shi-yun-wei/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.
