> 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/xiang-mu-lei-xing/scene-metadata.md).

# 场景元数据

了解如何设置场景并配置其元数据。

场景是一个具有空间边界的 Decentraland 项目，并映射到一个或多个地块。如果场景部署到 Decentraland 创世城地图，玩家可以前往场景坐标来体验它。如果场景部署到 [世界](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/fa-bu/publishing-options.md#decentraland-worlds)，玩家可以通过 URL 访问它。

请参阅 [场景中的文件](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/xiang-mu-lei-xing/scene-files.md) ，了解场景项目中使用的文件列表。

## 元数据

要在 [Creator Hub 中的场景编辑器](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-bian-ji-qi/ru-men/about-editor.md)编辑场景元数据，请打开场景并点击 **铅笔图标**.

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

这会打开场景菜单，你可以在其中配置多项属性。

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

或者，你也可以直接编辑 `scene.json` 文件，其中存储了所有这些值。

{% hint style="warning" %}
**📔 注意**：请勿在 `scene.json` 文件中添加本页未提及的自定义字段，否则可能导致场景加载出现问题。
{% endhint %}

## 场景标题、描述和图片

为场景设置标题、描述和缩略图非常重要，这有助于吸引玩家，并让他们了解场景的内容。

玩家在地图上选择场景地块时，会在弹出窗口中看到这些信息。当玩家被其他场景 [传送](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/jiao-hu-xing/external-links.md) 到此处时，也会在确认界面中看到这些信息。在此处设置引人注目的内容，可以显著提升场景的访问量。

玩家在世界中移动并进入你的场景时，可以在小地图下方看到场景标题。

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

通过场景编辑器中的场景菜单添加这些信息。

如果你希望其他开发者能够联系你，也可以为场景添加联系信息。

{% hint style="info" %}
**📔 注意**：世界有自己的名称、描述和缩略图，与场景元数据分开。如果世界只包含一个场景，每次发布时，世界元数据都会根据场景元数据更新。如果世界包含多个场景，则其元数据独立于场景元数据，只能在 Creator Hub 的 **管理** 标签页中编辑。请参阅 [世界元数据与场景元数据](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-bian-ji-qi/fa-bu/publish-scene.md#world-metadata-vs-scene-metadata).
{% endhint %}

### 场景缩略图

缩略图由 `navmapThumbnail` 字段设置。它必须是 *.png* 或 *.jpg* 格式的图片，且 **16:9** 宽高比为 *1920x1080* 像素是建议尺寸。只要保持相同的 16:9 比例，其他尺寸也可以使用。

平台的某些部分会显示缩小后的正方形缩略图，并裁剪至中央的 *1080x1080* 像素区域。请将文本或徽标等重要内容放在这个安全区域内，以免被裁切。

{% hint style="warning" %}
**📔 注意**：Creator Hub 会拒绝非 16:9 的图片。如果你手动将 `navmapThumbnail` 设置为其他比例的图片，显示该图片的客户端可能会以不可预测的方式拉伸或裁剪它。请参阅 [场景缩略图](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-bian-ji-qi/pei-zhi/scene-settings.md#scene-thumbnail).
{% endhint %}

![场景缩略图安全区域：完整的 1920x1080 图像，其中间的 1080x1080 正方形标记为安全区域，左右两侧标记为裁剪区域](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-16b056fbe6b140419900fa4e47cdb080320ca8b1%2Fscene-thumbnail-safe-area.webp?alt=media)

navmapThumbnail 中的图像 `navmapThumbnail` 应为项目文件夹中的图像文件路径，也可以是托管在其他位置的图像 URL 链接。

{% hint style="warning" %}
**📔 注意**：如果将图像托管在其他位置，请确保该网站的 CORS 策略允许其他网站显示其内容。
{% endhint %}

{% hint style="warning" %}
**📔 注意**：不要将此字段指向 `assets/Images/autogenerated-thumbnail.png` （或 `assets/images/autogenerated-thumbnail.png` ，适用于较旧的项目）。Creator Hub 每次为你截取缩略图时，都会覆盖这个特定文件。请参阅 [不要将文件命名为 autogenerated-thumbnail.png](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-bian-ji-qi/pei-zhi/scene-settings.md#dont-name-your-file-autogenerated-thumbnailpng).
{% endhint %}

## 类别

你可以为场景添加类别，帮助玩家探索 Decentraland。这些类别用于 [Decentraland Places dApp](https://places.decentraland.org) 中，为每个地点分类，让玩家更容易找到感兴趣的内容。

**类别** 必须从预定义的选项列表中选择：

* 🎨 艺术
* 🕹️ 游戏
* 🃏 赌场
* 👥 社交
* 🎶 音乐
* 👠 时尚
* 🪙 加密货币
* 📚 教育
* 🛍️ 商店
* 🏢 商业
* 🏅 体育
* 🏃 跑酷

一个场景可以归属多个类别，最多可列出 3 个类别。

在 `scene.json` 中，类别列在 `tags` 数组中。

以下是预定义类别：

* `art`
* `game`
* `casino`
* `social`
* `music`
* `fashion`
* `crypto`
* `education`
* `shop`
* `business`
* `sports`
* `parkour`

例如，可以将场景标记为 `game` 和 `casino` ，只需将以下内容添加到 `scene.json`

```json
  "tags": [
    "game",
    "casino",
  ],
```

之后，该场景会在 Places dApp 的 `game` 和 `casino` 分类下列出。

## 年龄分级

“ **年龄分级** ”字段用于对场景内容进行分类。Decentraland 是一个面向 18 岁及以上用户的平台。可用的选项如下：

* **🟡 `A` 成人（18 岁及以上）**：这是 Decentraland [使用条款](https://decentraland.org/terms)规定的最低年龄要求。如果场景包含适合成人的内容，例如中度或强烈的粗俗语言、暴力、露骨内容、赌博，或酒精、烟草和毒品等物质，请选择此类别。

通过 `scene.json`编辑年龄分级时，分级使用 **单字母代码**，成人分级填写 **A** 。 `rating` 字段位于 JSON 树的根层级。

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

```json
 "rating": "A"
```

### 受限内容

场景还有第三个类别：🔴 `R` ，表示受限。内容审核员会手动将此分级应用于违反 Decentraland [内容政策](https://decentraland.org/content)的场景。违规内容可能包括但不限于：

* 可疑内容或垃圾信息
* 辱骂性或仇恨性内容
* 色情或侮辱性内容
* 虐待儿童
* 骚扰或欺凌
* 宣扬恐怖主义或暴力
* 侵犯知识产权或版权

获得此分级的场景将无法加载，任何人都无法与之互动。如果您的场景属于此类别，应检查并更新场景，使其符合 [内容政策](https://decentraland.org/content).

## 功能开关

某些功能可以在特定场景中禁用，以防玩家滥用。请在场景设置的 **设置** 选项卡中进行配置。

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

目前，只有以下功能可以通过这种方式管理：

* **语音聊天**：允许玩家使用麦克风与附近的其他玩家进行语音交流。
* **禁用便携式体验**：此设置决定玩家身处你的场景时，其便携式体验的行为。这不仅包括 [便携式体验](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/xiang-mu-lei-xing/portable-experiences.md) ，还包括 [智能穿戴设备](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/xiang-mu-lei-xing/smart-wearables.md)。通过此设置，你可以选择全部保持启用（默认）、全部禁用或隐藏其界面。这适用于便携式体验可能让某些玩家获得不公平优势的场景，例如在跑酷挑战中使用喷气背包。对于涉及区块链交易的场景，也建议禁用这些功能，因为恶意的便携式体验可能会冒充场景界面。

在 `scene.json` 文件中，这些开关在 `featureToggles`下管理。对应功能默认启用，除非在 *disabled* 状态被指定在 `scene.json` 文件中。

```json
"featureToggles": {
    "voiceChat": "disabled",
    "portableExperiences": "enabled" | "disabled" | "hideUi"
},
```

如果你的 `featureToggles` 属性不存在于 `scene.json` 文件中，请在 JSON 树的根层级创建该属性。

### 打赏

你可以接收访问你场景的玩家的打赏。要启用打赏，请前往场景设置的 **详情** 选项卡，在 **创作者钱包地址**.

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

下提供一个以太坊地址。你也可以在 `scene.json` 文件的 `creator` 字段中提供场景的打赏地址。

```json
  "creator": "0x1234567890123456789012345678901234567890"
```

玩家访问你的场景时，会在屏幕左上角看到一个存钱罐图标。点击该图标会打开一个弹窗，玩家可以在其中向你打赏。也可以在地图上打开场景信息，访问此菜单。

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

在打赏弹窗中，玩家可以选择要发送的 MANA 数量。玩家的钱包中必须持有 MANA 才能打赏。如果你提供的地址关联了 Decentraland NAME，弹窗中会在以太坊地址旁显示钱包所有者的名称。

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

每当玩家向你打赏时，你都会在 Decentraland 的通知选项卡中收到通知。

## 生成位置

位于 **生成设置** 的 **设置** 选项卡中，用于定义玩家通过在浏览器中直接输入坐标或传送的方式进入你的场景时的生成位置。

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

你的场景中可能有树木或楼梯等物体，如果玩家生成在这些物体上，可能会无法移动。场景中也可能有高低起伏的地形。为了防止玩家生成在无法移动的位置，你可以在特定地点设置多个生成位置。

位置由场景内的坐标组成。这些数字表示地块内的位置，类似于你在场景代码的 Transform 组件中用于 [定位实体的坐标](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/3d-nei-rong-ji-chu/entity-positioning.md).

{% hint style="warning" %}
**📔 注意**：所有出生点都必须位于构成场景的地块内。你不能在这些地块范围之外生成玩家。
{% endhint %}

勾选 **随机偏移** 复选框，可在出生点周围随机偏移玩家的生成位置。这样可以避免玩家生成时彼此重叠，在拥挤的场景中尤其显得杂乱。 **最大偏移** 值表示与原始出生点的最大距离，适用于 X 轴和 Z 轴。

设置 **摄像机目标** ，以控制玩家进入场景时面朝的方向。这样你可以更好地掌控玩家的第一印象，也可以引导他们朝特定方向前进。默认情况下，目标指向 `{x: 8, y:1, z:8}`；对于单地块场景，这是场景的中心；对于较大的场景，则是左下角地块的中心。

点击 **添加出生点** ，即可添加任意数量的出生点。玩家会随机出现在其中一个出生点。

### 在 JSON 中配置出生点

也可以通过 `scene.json` 文件中的 `spawnPoints` 字段配置出生点。

```json
  "spawnPoints": [
    {
      "name": "spawn1",
      "position": {
        "x": 5,
        "y": 1,
        "z": 4
      }
    }
  ],
```

一个场景可以有多个出生点，这在大型场景中特别有用。只需将多个出生点列为数组，即可添加多个出生点。

```json
  "spawnPoints": [
    {
      "name": "spawn1",
      "position": {
        "x": 5,
        "y": 1,
        "z": 4
      }
	},
	{
      "name": "spawn2",
      "position": {
        "x": 3,
        "y": 1,
        "z": 1
      }
    }
  ],
```

有多个出生点时，系统会选择最接近玩家所指定坐标的出生点。

如果某个出生点标记为 `default`，则无论它是否最近，都会始终使用该出生点。如果有多个出生点标记为 `default`，则会选择最近的一个。

```json
  "spawnPoints": [
    {
      "name": "spawn1",
      "default": true,
      "position": {
        "x": 5,
        "y": 1,
        "z": 4
      }
	},
	{
      "name": "not-used",
      "position": {
        "x": 3,
        "y": 1,
        "z": 1
      }
    }
  ],
```

**出生区域**

你可以将场景中的整个区域设为出生点。为位置的每个维度指定一个由两个数字组成的数组，玩家就会随机出现在该范围内。这有助于避免进入场景的玩家彼此重叠。请注意，三个维度必须使用相同格式：要么全部使用单个数字，要么全部使用由两个数字组成的数组。若要固定某个维度，请使用两个值相同的数组，例如 `"y": [1,1]`.

```json
  "spawnPoints": [
    {
      "name": "region",
      "position": {
        "x": [1,5],
        "y": [1,1],
        "z": [2,4]
      }
    }
  ],
```

在上面的示例中，玩家可能出现在一个正方形内的任意位置，该正方形的顶点位于 *1,1,2* 和 *5,1,4*.

场景也可以有多个出生区域，就像可以有多个出生点一样。

```json
  "spawnPoints": [
    {
      "name": "region1",
      "position": {
        "x": [1,5],
        "y": [1,1],
        "z": [2,4]
      }
    },
      {
      "name": "region2",
      "position": {
        "x": [1,5],
        "y": [1,1],
        "z": [6,8]
      }
    }
  ],
```

**旋转**

你还可以指定玩家生成时的朝向，让他们面向特定方向。

只需在生成点数据中添加 `cameraTarget` 字段。其值应 `cameraTarget` 引用空间中的一个位置，其中 *x*, *y* 和 *z* 坐标相对于场景，与 `position` 字段相同。

```json
  "spawnPoints": [
    {
      "name": "spawn1",
      "position": {
        "x": 5,
        "y": 1,
        "z": 4
      },
      "cameraTarget": {
        "x": 10,
        "y": 1,
        "z": 4
      }
    }
  ],
```

此示例会在 *5, 1, 4* 处生成玩家，使其朝东面向 *10, 1, 4*。如果生成位置是一个范围，玩家的朝向始终会与指定目标一致。如果有多个生成点，每个生成点都可以有各自独立的目标。

## 所需权限

requiredPermissions `requiredPermissions` 属性列出了 [智能可穿戴设备](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/xiang-mu-lei-xing/smart-wearables.md) 使用的受限功能。此属性仅适用于智能可穿戴设备。

{% hint style="warning" %}
**📔 注意**：普通场景（位于地块或 Worlds 中）和 [便携式体验](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/xiang-mu-lei-xing/portable-experiences.md) 运行时会获得所有权限。它们不需要此属性，添加该属性也不会产生任何效果。
{% endhint %}

智能可穿戴设备只有在 `scene.json`中声明了这些功能后才能使用它们。如果未声明相应权限，调用就会失败，Explorer 会记录 *权限被拒绝* 错误：

* `USE_FETCH`：使用 `fetch` 或 `signedFetch`
* `USE_WEBSOCKET`：与第三方服务器建立 WebSocket 连接
* `USE_WEB3_API`：与玩家的钱包交互，以发起交易或签署消息
* `OPEN_EXTERNAL_LINK`：提示玩家打开指向外部网站的链接

```json
"requiredPermissions": [
    "USE_FETCH",
    "OPEN_EXTERNAL_LINK"
  ],
```

如果一个 `requiredPermissions` 属性不存在于你的 `scene.json` 文件中，请在 JSON 树的根级别创建该属性。

当智能穿戴设备声明了这些权限中的任意一项时，玩家装备该设备时，Explorer 会请求玩家授权。如果玩家拒绝，穿戴设备的代码就不会运行。只声明你实际使用的权限，以免向玩家请求超出所需的授权。

{% hint style="warning" %}
**📔 注意**：此页面的旧版本还列出了 `ALLOW_TO_MOVE_PLAYER_INSIDE_SCENE`, `ALLOW_TO_TRIGGER_AVATAR_EMOTE` 和 `ALLOW_MEDIA_HOSTNAMES`。当前的 Explorer 会忽略这些权限，因此你可以将它们移除。移动玩家、播放表情动作、施加物理力和流媒体都不需要权限。
{% endhint %}

## 场景地块

当 [部署](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/fa-bu/publishing.md) 场景时，内容会上传到场景配置中指定的坐标。一个场景可以包含单个地块，也可以包含多达数十个地块的列表。

在 Scene Editor 中，打开场景菜单的第二个选项卡即可编辑此项。

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

使用下拉菜单，然后点击 **应用布局** 即可更改场景的尺寸。你也可以逐个点击地块，将其从布局中关闭。

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

默认场景的坐标设置为 *0,0*。离线开发场景时，无需更改此设置，除非你需要占用多个地块。在部署到你有权限部署的坐标之前，需要更改此设置。

你也可以在 `scene.json` 文件中更改场景坐标：

```json
 "scene": {
    "parcels": [
      "54,-14"
    ],
    "base": "54,-14"
  }
```

该 `base` 此字段用于定义将哪个地块视为基准地块。如果场景中只有一个地块，则该地块应作为基准地块。如果场景中有多个地块，则应将左下角（西南方）的地块作为基准地块。所有实体的位置均相对于该地块的西南角测量。

若要在场景预览中显示多个地块，请列出你打算使用的所有地块。它们不必是你最终部署到的确切地块，但必须彼此相邻，且相对位置排列一致。

```json
 "scene": {
    "parcels": [
      "54,-14",  "55,-14"
    ],
    "base": "54,-14"
  }
```

{% hint style="warning" %}
**📔 注意**：可设置的最大场景尺寸为 300 x 300 个地块（共 90,000 个地块）。
{% endhint %}

### 通过命令行设置地块

你可以在场景文件夹中运行以下命令来设置场景中的地块： `npx update-parcels` 此方法对于大型场景尤其有用，因为你无需逐一列出涉及的所有地块。

{% hint style="warning" %}
**📔 注意**: `update-parcels` 是一个第三方社区工具，不属于 Decentraland 官方 SDK，也不由 Decentraland 基金会维护。
{% endhint %}

**单个地块**

传入一个场景坐标参数。此坐标也会被设为基准地块。

`npx update-parcels <parcel>`

例如：

`npx update-parcels 15,-26`

**多个地块**

传入两个参数：西南地块和东北地块。西南地块也会被设为基准地块。

`npx update-parcels <parcel> <parcel>`

{% hint style="info" %}
**💡 提示**：西南地块在两个坐标上始终都具有较小的数值 *X* 和 *Y* 坐标。
{% endhint %}

例如：

`npx update-parcels 15,-26 17,-24`

此命令会生成一个 3x3 的场景，其基础地块位于 `15,-26`.

**自定义基础地块**

传入三个参数：西南角地块、东北角地块以及用作基础地块的地块。

`npx update-parcels <parcel> <parcel> <parcel>`

{% hint style="warning" %}
**📔 注意**：基础地块必须是场景中的一个地块。
{% endhint %}

**非矩形场景**

上述命令生成的都是矩形场景。Decentraland 场景可以是 L 形或其他形状。你可以使用 `npx update-parcels` 生成一个较大的正方形，然后从 `scene.json` 文件中手动移除多余的地块。

{% hint style="warning" %}
**📔 注意**：基础地块必须是场景中的一个地块。
{% endhint %}

## 天空盒时间

你可以为场景设置固定的时间。所有玩家都会看到该时间下的场景，天空盒也不会随昼夜循环变化。

打开场景设置，点击 **设置** 选项卡，找到 **天空盒** 部分。取消选中 **自动** 选项，然后设置所需的时间。

你也可以在场景代码中设置天空盒时间。为此，请在 `scene.json` 的根级别添加以下内容：

```json
 "skyboxConfig": {
    "fixedTime": 36000
  }
```

该数字表示从一天开始算起经过的秒数，范围为 0（表示 *00:00*）到 86400（表示 *24:00*）。任何大于 86400 的数字也会被视为午夜。

以下是更多有效值的示例：

* 0 秒 => *00:00*
* 21600 秒 => *06:00*
* 43200 秒 => *12:00*
* 64800 秒 => *18:00*
* 86400 秒 => *24:00*

## 景观地形

发布到 [Decentraland World](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/fa-bu/publishing-options.md#decentraland-worlds) 的场景周围会环绕着自动生成的草地、树木和海洋景观。如果这一景观与你的场景风格不符，例如场景漂浮在开阔水域或太空中，你可以将其禁用。为此，请在 `scene.json` 的根级别添加以下字段：

```json
{
	"landscapeTerrain": false
}
```

将 `landscapeTerrain` 设置为 `false`时，场景地块以外的区域不会渲染，玩家只能看到场景周围的天空盒。移除周围地形还可以释放渲染资源，从而让场景运行得更流畅。

如果未设置此字段，则默认值为 `true` ，景观将照常显示。

{% hint style="warning" %}
**📔 注意**：此字段仅适用于包含单个场景的 World。在 Genesis City 中，此字段会被忽略，因为周围环境始终由相邻地块决定。你也可以在本地预览场景时使用此字段，以查看隐藏景观后的场景效果。
{% endhint %}

## World 配置

发布到 [Decentraland World](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/fa-bu/publishing-options.md#decentraland-worlds)，你可以在 `scene.json` 文件中使用 `worldConfiguration` 对象配置多个特定于 World 的设置。

### World 基本配置

要发布到 World，必须在你的 `scene.json`:

```json
{
	"worldConfiguration": {
		"name": "my-name.dcl.eth"
	}
}
```

中指定名称或 ENS 域名。 **名称** 指定值可以是 Decentraland NAME 或 ENS 域名，并且必须由签署部署的钱包拥有（或由通过访问控制列表获得授权的任何钱包拥有）。

### 通信服务配置

该 `fixedAdapter` 属性用于指定场景应使用哪个通信服务。目前仅允许使用 `offline:offline` 值。设置后，场景将完全不使用通信服务，加入该世界的每位用户始终都会独处。若未设置，Worlds 内容服务器会根据其配置生成合适的值。

```json
{
	"worldConfiguration": {
		"name": "my-name.dcl.eth",
		"fixedAdapter": "offline:offline"
	}
}
```

{% hint style="warning" %}
**📔 注意**：设置 `fixedAdapter` 用于 `"offline:offline"` （或启用 **单人游戏** 中的 [设置选项卡](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-bian-ji-qi/fa-bu/manage-lands-and-worlds.md#settings) （在 Creator Hub 中）会停用实时串流功能。此功能依赖通信层将视频传送给观众。如果你希望在自己的世界中使用实时串流，请勿使用此选项。
{% endhint %}

### 场景列表配置

除非选择退出，否则所有世界都会自动列在 Places 页面中。如果你不希望自己的世界被 Places 编入索引，可以添加以下内容：

```json
{
	"worldConfiguration": {
		"name": "my-name.dcl.eth",
		"placesConfig": {
			"optOut": true
		}
	}
}
```

### 完整示例

以下是一个包含所有 World 配置选项的完整示例：

```json
{
	"worldConfiguration": {
		"name": "my-name.dcl.eth",
		"fixedAdapter": "offline:offline",
		"placesConfig": {
			"optOut": true
		}
	}
}
```

请参阅 [发布到 Worlds](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/fa-bu/publishing.md#publishing-to-worlds) 了解有关部署到 Worlds 的更多信息。

## 从场景代码中获取元数据

[场景 API 参考](https://js-sdk-toolchain.pages.dev/modules/js_runtime_apis.__system_Scene_)

你可能需要在场景代码中获取场景元数据中的字段，例如场景部署到的地块或出生点位置。对于需要复制的场景，或需要在其他场景中复用的代码，这尤其有用。对于需要了解场景边界的库来说，这也非常有用。

要访问这些数据，首先导入 `getSceneInformation` 函数：

```ts
import { getSceneInformation } from '~system/Runtime'
```

然后，您可以调用 `getSceneInformation()` 函数，它会返回一个 JSON 对象，其中包含 scene.json 文件的大部分内容。以下示例展示了如何从该函数的响应中访问一些常用字段：

```ts
import { getSceneInformation } from '~system/Runtime'

executeTask(async () => {
  const sceneInfo = await getSceneInformation({})

  if (!sceneInfo) return
  console.log("SCENE INFO: ", sceneInfo)
})
```

{% hint style="warning" %}
**📔 注意**: `getSceneInformation()` 必须在 [异步函数](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/bian-cheng-mo-shi/async-functions.md)中运行，因为返回数据可能会延迟几分之一秒甚至更久。请勿使用已弃用的 `getSceneInfo()` 函数。
{% endhint %}

getSceneInformation() `返回的对象` 包含以下内容：

* `baseUrl`：托管场景内容的基础 URL
* `content`：一个数组，包含场景的所有文件及其哈希值；可与 baseUrl 配合使用以获取这些文件。
* `metadataJson`：场景的 scene.json 文件的完整内容，以字符串形式提供。您必须解析此字符串才能获取特定值。
* `urn`：整个场景唯一的 URN。

以下示例解析 `metadataJson` 中的内容，以获取 scene.json 文件属性中的值

```ts
import { getSceneInformation } from '~system/Runtime'

executeTask(async () => {
	const sceneInfo = await getSceneInformation({})

	if (!sceneInfo) return

	const sceneJson = JSON.parse(sceneInfo.metadataJson)
	const spawnPoints = sceneJson.spawnPoints
	const parcels = sceneJson.scene.parcels
	console.log({ parcels, spawnPoints })
})
```


---

# 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/xiang-mu-lei-xing/scene-metadata.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.
