> 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/contributor/contributor-ko/content/entity-types/scenes.md).

# 장면

씬은 [엔티티입니다](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md) 디센트럴랜드의 다양한 부분에서 동작을 생성하는 엔티티입니다. 이들은 여러 개의 토지 파셀에 걸칠 수 있으며, 월드 익스플로러에서 그들을 지나가는 플레이어는 씬이 제공하는 특수 코드를 실행하게 됩니다.

완전한 실제 예시는 [이 씬의 매니페스트](https://peer.decentraland.org/content/contents/bafkreidihplrc5cxarjkji2enmzhicpjoa2vrlqyyffnholmxb3o2xft3u) 재단의 콘텐츠 서버에서 확인할 수 있습니다.

### 포인터 <a href="#pointers" id="pointers"></a>

씬에는 하나 이상의 연결된 [pointers](https://github.com/decentraland/docs/blob/main/contributor/pointers/README.md) 파셀 좌표 문자열 형태의, 예를 들어 `"0,0"`. 씬을 실행 중인 모든 파셀은 [`pointers` 배열](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md#properties) 에 엔티티 매니페스트로 나열되며, 해당 포인터들은 모두 콘텐츠 서버에 의해 그 씬으로 해석됩니다.

즉, 파셀의 x/y 좌표를 선택하고 콘텐츠 서버에 `"<x>,<y>"` 포인터를 쿼리하여 실행 중인 씬을 찾을 수 있습니다. 이것이 월드 익스플로러가 플레이어가 세계를 탐색할 때 씬의 동작을 활성화할지 결정하는 방식입니다.

일반적인 `pointers` 배열은 다음과 같습니다:

```json
{
  "pointers": [
    "-113,-134",
    "-113,-133",
    "-113,-132",
  ],
  // ... 기타 엔티티 속성
}
```

이 데이터는 또한 아래에 자세히 설명된 `metadata.scene.parcels` 필드에서도 사용할 수 있으며, 매니페스트에 씬 전용 객체만 저장하고 싶을 때 유용합니다.

### 메타데이터 필드

다음에 대한 몇 가지 특수 속성이 있습니다 [엔티티입니다](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md) 형식의 `씬` 다음에 위치한 `메타데이터` 최상위 필드 내에 있습니다.

| 필드                    | 값                                                                                                                                  |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `owner`               | 씬 유지 관리 담당자에 대한 정보입니다.                                                                                                             |
| `main`                | 이 [내부 파일 이름](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md#files) 이 씬의 मुख्य JavaScript 파일을 가리킵니다. |
| `tags`                | 이 씬을 설명하는 문자열 레이블들의 배열입니다.                                                                                                         |
| `display`             | 플레이어에게 보여주기 위해 익스플로러가 사용하는 씬 정보입니다(아래 참조).                                                                                         |
| `씬`                   | 이 씬이 활성화되는 파셀과 중심 위치입니다(아래 참조).                                                                                                    |
| `contact`             | 씬의 제작자나 유지 관리 담당자에게 연락할 이름과 이메일 주소입니다(아래 참조).                                                                                      |
| `spawnPoints`         | 플레이어가 이 씬에 들어올 때의 위치와 카메라 각도입니다(아래 참조).                                                                                            |
| `requiredPermissions` | 익스플로러가 플레이어에게 요청하도록 권장되는 권한입니다(아래 참조).                                                                                             |
| `featureToggles`      | 기능 플래그 설정                                                                                                                          |

{% hint style="info" %}
엔티티와 그 메타데이터에는 사용자 정의 필드를 둘 수 있다는 점을 기억하세요. 여기 나열되지 않은 속성들을 보게 될 수도 있습니다.
{% endhint %}

#### 표시

에서 `metadata.display`, 플레이어가 씬에 들어가기 전에 씬에 대해 알려주는 데 유용한 속성들을 찾을 수 있습니다.

| 필드                | 값                                                                                                                                   |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `제목`              | 이 씬의 표시 이름입니다.                                                                                                                      |
| `설명`              | 이 씬에 대한 자세한 설명입니다.                                                                                                                  |
| `파비콘`             | *사용 중단됨* 이 [내부 파일 이름](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md#files) 이 씬이 활성화될 때 표시되는 아이콘입니다. |
| `navmapThumbnail` | 이 [내부 파일 이름](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md#files) 월드맵용 이 씬의 썸네일입니다.                 |

예:

```json
{
  "title": "my_cool_scene",
  "favicon": "favicon.png",
  "navmapThumbnail": "thumbnail.png"
}
```

#### 씬

이 `metadata.scene` 속성은 월드맵에서 이 씬의 위치를 설명하는 객체입니다.

| 필드        | 값                         |
| --------- | ------------------------- |
| `parcels` | 이 씬을 실행하는 파셀 포인터들의 배열입니다. |
| `base`    | 이 씬의 원점에 대한 파셀 포인터입니다.    |

실제로는 다음과 같습니다:

```json
{
  "parcels": [
    "17,-112", 
    "17,-113"
  ],
  "base": "17,-112"
}
```

이 `base` 필드는 항상 다음의 `parcels` 배열에 포함됩니다.

#### 연락처

이 `metadata.contact` 객체에는 씬 소유자 또는 유지 관리 담당자의 연락처 정보가 들어 있습니다.

| 필드    | 값                      |
| ----- | ---------------------- |
| `이름`  | 이 연락처의 이름입니다.          |
| `이메일` | (선택 사항) 연락할 이메일 주소입니다. |

JSON에서는:

```json
{
  "name": "cool_scene_maker",
  "email": "hello@decentraland.org"
}
```

비록 `이름` 필드는 모든 씬에 채워져 있지만, 실제로는 `이메일` 필드는 종종 빈 문자열입니다. 이는 씬 제작자가 내린 개인정보 보호 선택입니다.

#### 스폰 지점

이 `metadata.spawnPoints` 필드는 씬에 들어오는 플레이어가 어디에 나타나야 하는지, 그리고 처음 어디를 바라봐야 하는지를 결정하는 지점과 카메라 방향의 배열을 정의합니다. 정의된 스폰 지점이 적어도 하나는 있어야 합니다.

배열의 각 항목에는 여러 속성이 있습니다:

| 필드             | 값                                                  |
| -------------- | -------------------------------------------------- |
| `이름`           | 이 스폰 지점을 식별하는 레이블입니다.                              |
| `position`     | 시작 위치가 들어 있는 `{ x, y, z }` 부동소수점 좌표를 가진 객체입니다.     |
| `cameraTarget` | 시작 카메라 방향이 들어 있는 `{ x, y, z }` 부동소수점 좌표를 가진 객체입니다. |
| `기본값`          | 별도로 지정하지 않는 한 이 스폰 지점을 사용할지 여부입니다.                 |

예를 들면:

```json
[
  {
    "name": "spawn1",
    "position": { "x": 10.02, "y": 5.27, "z": 15.23  },
    "cameraTarget": { "x": 10.02, "y": 6.27, "z": 31.23 },
    "default": true
  }
]
```

{% hint style="info" %}
**📔 참고**: Spawn Area와 Camera Target은 Creator Hub를 사용해 설정할 수 있습니다. 자세한 내용은 [Spawn Area](https://github.com/decentraland/docs/blob/main/creator/scene-editor/build/spawn-areas.md) 문서로 이동하세요.
{% endhint %}

#### 필수 권한 <a href="#permissions" id="permissions"></a>

에서 `metadata.requiredPermissions` 월드 익스플로러가 특정 동작을 허용하기 전에 플레이어에게 어떤 권한을 요청해야 하는지를 선언하는 잘 알려진 문자열 배열을 찾을 수 있습니다. 이는 익스플로러의 책임이며, 다른 목적을 위해 만들어진 클라이언트는 이를 무시할 수 있습니다.

현재 지원되는 권한 목록은 다음과 같습니다:

| 권한                                  | 목적                                         |
| ----------------------------------- | ------------------------------------------ |
| `USE_FETCH`                         | 씬이 외부 HTTP 요청을 수행하도록 허용합니다.                |
| `USE_WEBSOCKET`                     | 씬이 WebSocket API를 사용하여 외부 연결을 설정하도록 허용합니다. |
| `OPEN_EXTERNAL_LINK`                | 씬이 URL을 열도록 허용합니다(브라우저 탭 또는 웹 뷰에서).        |
| `USE_WEB3_API`                      | 씬이 지갑과 통신하도록 허용합니다.                        |
| `ALLOW_TO_TRIGGER_AVATAR_EMOTE`     | 씬이 플레이어의 아바타를 이모트로 애니메이션하도록 허용합니다.         |
| `ALLOW_TO_MOVE_PLAYER_INSIDE_SCENE` | 씬이 플레이어의 위치를 변경하도록 허용합니다.                  |

#### 기능 토글

이 `metadata.featureToggles` 필드를 통해 씬은 월드 익스플로러의 특정 기능을 활성화 또는 비활성화할지 지정할 수 있습니다.

필드에는 다음 형식의 객체가 들어 있습니다 `{ [featureName]: 'enabled' | 'disabled' }`, 다음과 같습니다:

```json
{
  "voiceChat": "enabled"
}
```

현재, `voiceChat` 가 유일하게 일반적으로 지원되는 기능 플래그입니다.


---

# 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/contributor/contributor-ko/content/entity-types/scenes.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.