> 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-sdk7/tiao-shi/debug-in-preview.md).

# 在预览中调试

如何在本地预览运行时调试你的场景

运行预览可提供一些有用的调试信息和工具，帮助你了解场景的渲染方式。

如果场景无法编译，你将只能看到空旷的地面，上面没有渲染任何内容。如果出现这种情况，可以在以下几个位置查找错误消息，帮助你了解问题所在：

1. 检查代码编辑器，确认它没有标记任何语法或逻辑错误。
2. 检查预览窗口中的控制台，查看是否有错误消息。点击右上角的 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a673f6b987216e9e471fdac882879c44fcf94652%2Fconsole-icon.png?alt=media\&token=1965a51b-d4b0-4caa-b9d5-d24d738c1fb8) 图标即可打开控制台。
3. 如果你通过 Creator Hub 运行场景，请查看显示场景控制台输出的窗口。如果你通过 CLI 运行场景，请查看运行 `npm run start`

{% hint style="info" %}
**💡 提示**：在将场景发布到生产环境之前，你可以先将它发布到 [Decentraland World](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/fa-bu/publishing-options.md#decentraland-worlds) ，在更接近生产环境的情境中进行测试。
{% endhint %}

## 使用控制台

点击右上角的 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a673f6b987216e9e471fdac882879c44fcf94652%2Fconsole-icon.png?alt=media\&token=1965a51b-d4b0-4caa-b9d5-d24d738c1fb8) 图标即可打开控制台。

你也可以按键盘上的反引号键来切换控制台的显示状态： **`**。在大多数英文键盘上，此键位于 1 键左侧。也可以按 Shift + **\,`** 以打开更宽的控制台视图，便于查看更多文本。

向控制台输出消息（使用 `console.log()`）。然后，打开场景控制台即可查看这些消息的实时输出。

控制台还会显示错误消息，并以红色标出。

## 调试面板

点击右上角的 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-9af92d7a9edeb4111484adc136865c46bf27e9e1%2Fdebug-icon.webp?alt=media) 图标即可打开调试控制台。

这会在右下角打开一个面板，显示渲染引擎的相关信息，并会随情况变化实时更新。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a66a852a3c9f55e2dd178b31e52601c8d79746d8%2Fdebug-panel.webp?alt=media)

### 当前场景

“ **当前场景** ”选项卡包含你当前所在场景的信息，包括：

* 场景中的地块数量
* 允许建造的最高高度（每个场景均为 330 米）

你还可以勾选 **显示场景边界** 选项，以显示场景周围的红色墙体，这些墙体标示了场景的边界。

### 内存

“ **内存** ”部分会显示 Decentraland 使用的内存。请尽量将该值保持在 **内存预算阈值**以下。如果该值过高，可能会导致访问你场景的玩家应用崩溃。请注意，在生产环境中，场景可能会与周围的其他场景和玩家一同加载，这些因素都会增加内存占用，使其高于你在预览中看到的数值。

### 性能

“ **性能** ”选项卡包含多个与 *FPS* （每秒帧数）相关的字段。场景越复杂，该数值通常越低。请确保始终将其保持在 25 FPS 以上，以确保玩家获得良好的体验。FPS 会因运行场景的设备而异。

这里最重要的数值是 **平均 FPS**，它是根据最近 1000 帧的 FPS 计算得出的平均值。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-27c0293cff82265d4eb7d6b6506e23e210d2b016%2Ffps-debug-panel.webp?alt=media)

{% hint style="warning" %}
**📔 注意**：场景的游戏循环与渲染器以相同的频率运行。系统每渲染一帧就运行一次，因此此处显示的 FPS 也代表场景逻辑每秒更新的次数。
{% endhint %}

卡顿指帧率短暂暂停。它们对整体 FPS 数值的影响可能不大，但玩家通常会明显察觉。加载大型资源或类似操作时，通常可能会出现这类情况。

### Web 请求

“ **WEB REQUESTS** ”部分可让你打开 Chrome DevTools 的 Network（网络）标签页，查看场景发出的 Web 请求数量及其内容。通过它可以了解场景是否向服务器发送了过多请求，因为这可能影响场景性能。

如果场景会与第三方服务器交互，查看传入和传出的数据通常很有帮助。点击 **打开 Chrome DevTools** 即可打开一个新的 Chrome 窗口，并显示 Network（网络）标签页。

{% hint style="warning" %}
**📔 注意**：要使用此功能，必须先安装 [Creator Hub](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-bian-ji-qi/ru-men/editor-installation.md)，因为所需的依赖项已随该安装包一同提供。

使用此功能时，无需打开 Creator Hub，也无需通过 Creator Hub 运行场景预览；使用 CLI 运行场景预览时同样可以使用此功能。
{% endhint %}

或者，你也可以在电脑上运行一些免费的工具，查看 Decentraland 应用中所有传入和传出的数据。例如： [Charles](https://www.charlesproxy.com/) 或 [Wireshark](https://www.wireshark.org/).

## 快速重新加载

每当你更改场景时，预览都会自动重新加载并更新，因此无需关闭再重新打开预览窗口。

如果需要重新加载你当前所在的场景，请点击预览窗口左上角的 **重新加载场景** 按钮。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-1ff6d67c0b7a28f78caa13019a9ccabeb3afe662%2Freload-button.webp?alt=media)

你也可以在聊天中输入以下内容并按 Enter 键来重新加载场景：

`/reload`

## 报告错误

如果遇到的问题并非出在你的场景上，而是与 Decentraland SDK 整体有关，请参阅 [报告错误](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/tiao-shi/report-bug.md).

## 依赖项版本

确保场景中的所有依赖项始终使用最新版本，因为你遇到的问题可能已在较新版本中修复。Creator Hub 会在有更新可安装到 Decentraland 场景时通知你。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0ba6896aebac94a5ec9cc2365864a36e0e11e7dc%2Fnew-dependencies.webp?alt=media)

你也可以通过命令行手动更新依赖项。在本地运行 Decentraland 场景主要依赖两个库： `@dcl/sdk` 和 `@dcl/js-runtime`，它们会安装在每个项目文件夹中。请确保两者都已更新至最新版本。你可以运行以下命令，将这两个库手动更新到最新稳定版：

```
npm i @dcl/js-runtime@latest
npm i @dcl/sdk@latest
```

如果场景使用智能物品，也可能会用到 `@dcl/asset-packs` 库，可通过以下命令更新：

```
npm i @dcl/asset-packs@latest
```

如果你使用了任何 [utils 库](https://studios.decentraland.org/resources?sdk_version=SDK7\&resource_type=Library) ，也请确保它们已更新至最新版本，因为这些库的旧版本可能与较新版本的 `@dcl/sdk`.

## 光照条件

游戏世界中的一天中不同时间会显著影响 3D 模型的外观。光源颜色会微妙变化：夜间偏蓝，日出和日落时偏红。光线方向也会随着太阳在天空中的移动而变化，从而使阴影投向不同方向。

通过将游戏时钟切换到不同时间，检查场景在一天中的各个时段是否都呈现良好效果。点击 **天空盒时间** 屏幕左侧面板上的图标，以设置你喜欢的任意时间。如果此滑块显示为灰色，请确保 **自动** 选项已关闭。

<figure><img src="https://github.com/decentraland/docs/blob/main/creator/images/daylight-settings.webp" alt="Dynamic skybox" width="300"><figcaption><p>游戏内说明</p></figcaption></figure>

你的 3D 模型的材质看起来可能与在创建它的建模工具中不一样。这是正常现象，因为不同的 3D 渲染引擎在处理光照和材质时都会存在细微差异。

你也可以设置场景，使一天中的时间固定，光照不会变化。详见 [天空盒控制](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/jiao-hu-xing/skybox-control.md) 。

## 多人游戏测试

启动场景预览，并在两个（或更多）不同的浏览器窗口中打开后，每个已打开的窗口都会被视为一个独立玩家，模拟通信服务器会让这些玩家保持同步。

在一个窗口中与场景互动，然后切换到另一个窗口，查看互动效果是否也显示在那里。

在 Creator Hub 中，开启 **多实例预览** （位于 **桌面客户端** 的 **播放选项**子菜单中），然后再次点击 **播放** 按钮以打开第二个 Decentraland 浏览器窗口。你必须在两个窗口中使用不同地址连接。重新加载场景时，两个会话都会保持打开状态。你可能需要在第二个窗口中退出并重新登录，才能选择其他账户。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-10d53f215e20e8cf603bbf578d0b33df738d058f%2Fpreview-button.webp?alt=media)

两位玩家可以看到彼此，也可以互相互动。如果场景包含多人游戏逻辑，这些逻辑将按预期运行，并在两位玩家之间同步。

或者，你也可以在浏览器地址栏中输入以下内容，以打开第二个 Decentraland 浏览器窗口：

> `decentraland://realm=http://127.0.0.1:8000&local-scene=true&debug=true&multi-instance=true`

## 使用以太坊测试网络

测试场景时，为避免转移真实的 MANA 或其他货币，你可以使用以太坊 Sepolia 测试网络，转移虚拟的测试网 MANA。

要使用测试网络，你必须将 Metamask Chrome 扩展程序设置为使用 *Sepolia 测试网络* 而不是 *主网络*。你还必须在 Sepolia 区块链上持有 MANA，可以从 Decentraland 免费获取。

{% hint style="info" %}
**💡 提示**：要执行将 Sepolia MANA 转入钱包的交易，你需要支付以 Sepolia Ether 计价的 Gas 费。
{% endhint %}

在此模式下查看场景时，你确认的任何交易都只会在测试网络上发生，不会影响真实钱包中的 MANA 余额。

要使用测试网络预览场景，请将以下 URL 粘贴到浏览器标签页中。这会在 Decentraland 桌面客户端中打开场景：

> decentraland://realm=<http://127.0.0.1:8000\\&local-scene=true\\&debug=true\\&dclenv=zone\\&position=0,0>

{% hint style="info" %}
**💡 提示**：将 position 参数更改为场景的坐标，即可直接加载到场景中。你在此模式下查看场景时确认的任何交易都只会在测试网络上发生，不会影响真实钱包中的 MANA 余额。
{% endhint %}

如果你需要在 Polygon 测试网上测试交易并需要在该测试网上持有 MANA，则需要先在 Sepolia 获取 MANA，然后将其兑换到该网络。要将 Sepolia MANA 跨链桥接到 Polygon 测试网，请访问你在 Sepolia 上的 Decentraland 账户页面，并点击 Ethereum MANA 一侧的“兑换”。


---

# 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-sdk7/tiao-shi/debug-in-preview.md?ask=<question>&goal=<user_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.
