씬

씬은 엔티티입니다 디센트럴랜드의 다양한 부분에서 동작을 생성하는 엔티티입니다. 이들은 여러 개의 토지 파셀에 걸칠 수 있으며, 월드 익스플로러에서 그들을 지나가는 플레이어는 씬이 제공하는 특수 코드를 실행하게 됩니다.

완전한 실제 예시는 이 씬의 매니페스트 재단의 콘텐츠 서버에서 확인할 수 있습니다.

포인터

씬에는 하나 이상의 연결된 pointers 파셀 좌표 문자열 형태의, 예를 들어 "0,0". 씬을 실행 중인 모든 파셀은 pointers 배열 에 엔티티 매니페스트로 나열되며, 해당 포인터들은 모두 콘텐츠 서버에 의해 그 씬으로 해석됩니다.

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

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

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

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

메타데이터 필드

다음에 대한 몇 가지 특수 속성이 있습니다 엔티티입니다 형식의 씬 다음에 위치한 메타데이터 최상위 필드 내에 있습니다.

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

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

표시

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

필드	값
제목	이 씬의 표시 이름입니다.
설명	이 씬에 대한 자세한 설명입니다.
파비콘	사용 중단됨 이 내부 파일 이름 이 씬이 활성화될 때 표시되는 아이콘입니다.
navmapThumbnail	이 내부 파일 이름 월드맵용 이 씬의 썸네일입니다.

예:

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

씬

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

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

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

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

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

연락처

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

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

JSON에서는:

{
  "name": "cool_scene_maker",
  "email": "[email protected]"
}

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

스폰 지점

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

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

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

예를 들면:

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

📔 참고: Spawn Area와 Camera Target은 Creator Hub를 사용해 설정할 수 있습니다. 자세한 내용은 Spawn Area 문서로 이동하세요.

필수 권한

에서 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' }, 다음과 같습니다:

{
  "voiceChat": "enabled"
}

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