씬 메타데이터

씬을 설정하고 메타데이터를 구성하는 방법을 알아보세요.

씬은 공간적으로 구분되며 하나 또는 여러 패럴셀에 매핑되는 Decentraland 프로젝트입니다. 씬이 Decentraland Genesis City 맵에 배포되면 플레이어는 씬의 좌표를 방문해 이를 경험할 수 있습니다. 씬이 다음에 배포되면 월드, 플레이어는 URL을 통해 방문할 수 있습니다.

참조 씬의 파일 씬 프로젝트에서 어떤 파일이 사용되는지 목록을 보려면.

메타데이터

에서 씬의 메타데이터를 편집하려면 Creator Hub의 씬 편집기, 씬을 열고 다음을 클릭하세요 연필 아이콘.

그러면 씬 메뉴가 열리고, 여기서 여러 속성을 구성할 수 있습니다.

또는 다음을 직접 편집할 수도 있습니다 scene.json 파일. 이 모든 값이 저장되어 있습니다.

📔 참고: 다음에 사용자 정의 필드를 추가하지 마세요 scene.json 이 페이지에 언급되지 않은 파일에는 추가하지 마세요. 씬 로드에 문제가 생길 수 있습니다.

씬 제목, 설명, 이미지

플레이어를 끌어들이고 무엇을 기대해야 하는지 알 수 있도록 씬에 제목, 설명, 썸네일 이미지를 제공하는 것이 매우 중요합니다.

플레이어는 맵에서 씬의 패럴셀을 선택하면 모달에 표시된 이 항목들을 보게 됩니다. 또한 다음될 때 확인 화면에서도 이를 보게 됩니다 텔레포트 되어 다른 씬에서 그곳으로 이동할 때도 이를 보게 됩니다. 여기서 매력적인 데이터를 설정하면 씬으로의 유입을 크게 늘리는 데 도움이 됩니다.

플레이어가 월드를 탐색해 씬에 들어오면 미니맵 아래에서 씬 제목을 읽을 수 있습니다.

이 데이터는 씬 편집기의 씬 메뉴를 통해 추가하세요.

다른 개발자가 연락할 수 있도록 씬에 연락처 정보도 추가할 수 있습니다.

📔 참고: 월드는 씬의 메타데이터와 별도로 자체 이름, 설명, 썸네일을 유지합니다. 월드에 단일 씬이 포함되어 있으면, 월드의 메타데이터는 매번 게시할 때 씬의 메타데이터에서 업데이트됩니다. 여러 씬이 포함되어 있으면 월드의 메타데이터는 독립적이며 다음에서만 편집할 수 있습니다 관리 탭에서만 편집할 수 있습니다. 참조 월드 메타데이터 vs 장면 메타데이터.

장면 썸네일

썸네일은 다음에서 설정합니다 navmapThumbnail 필드. 반드시 .png 또는 .jpg 이미지여야 합니다 16:9 비율을 가져야 합니다. 1920x1080 픽셀을 목표 크기로 하세요. 다른 크기도 16:9 비율만 유지하면 사용할 수 있습니다.

플랫폼의 일부 영역에서는 썸네일의 축소된 정사각형 버전을 중앙 1080x1080 픽셀로 잘라 표시합니다. 텍스트나 로고 같은 중요한 요소는 잘리지 않도록 그 안전 영역 안에 두세요.

📔 참고: Creator Hub는 16:9가 아닌 이미지를 거부합니다. 다음을 설정하면 navmapThumbnail 를 수동으로 다른 형태의 이미지에 지정하면, 이를 표시하는 클라이언트에서 예측할 수 없게 늘어나거나 잘릴 수 있습니다. 참조하세요 장면 썸네일.

다음의 이미지는 navmapThumbnail 프로젝트 폴더의 이미지 파일 경로여야 합니다. 다른 곳에 호스팅된 이미지의 URL 링크도 사용할 수 있습니다.

📔 참고: 이미지를 다른 곳에 호스팅하는 경우, 다른 사이트의 콘텐츠 표시를 허용하는 CORS 정책을 가진 사이트인지 확인하세요.

카테고리

플레이어가 Decentraland를 탐색하는 데 도움이 되도록 씬에 카테고리를 추가할 수 있습니다. 이는 다음에서 사용됩니다 Decentraland Places dApp 각 장소를 분류하고 플레이어가 관심 있는 것을 더 쉽게 찾을 수 있게 하기 위해 사용됩니다.

카테고리 사전에 정의된 옵션 목록에서 선택해야 합니다:

🎨 아트
🕹️ 게임
🃏 카지노
👥 소셜
🎶 음악
👠 패션
🪙 크립토
📚 교육
🛍️ 상점
🏢 비즈니스
🏅 스포츠
🏃 파쿠르

씬은 여러 카테고리에 속할 수 있으며, 나열할 수 있는 카테고리는 최대 3개입니다.

다음에서 scene.json 카테고리는 다음에 나열됩니다 태그 배열.

사전 정의된 카테고리는 다음과 같습니다:

아트
게임
카지노
소셜
음악
패션
크립토
교육
상점
비즈니스
스포츠
파쿠르

예를 들어, 씬은 다음으로 태그될 수 있습니다 게임 및 카지노 다음을 추가하여 scene.json

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

그러면 씬은 Places dApp의 다음 아래에 표시됩니다 게임 및 카지노 카테고리.

연령 등급

다음 연령 등급 필드는 씬의 콘텐츠를 분류하는 데 사용됩니다. Decentraland는 18+ 플랫폼입니다. 다음 옵션을 사용할 수 있습니다:

🟡 A 성인용(18+): 이는 Decentraland의 다음에 명시된 최소 연령 요건입니다 이용약관. 씬에 성인에게 적합한 콘텐츠(예: 다소 수위가 있거나 강한 언어, 폭력, 노골적인 콘텐츠, 도박, 또는 알코올, 담배, 마약 같은 물질)가 포함된 경우 이 카테고리를 선택하세요.

다음을 통해 연령 등급을 편집할 때 scene.json, 등급은 한 글자 코드, 다음을 작성하세요 A 성인용입니다. 다음 등급 필드는 JSON 트리의 루트 수준에 들어갑니다.

 "rating": "A"

제한 콘텐츠

씬에는 세 번째 카테고리가 있습니다: 🔴 R 제한용입니다. 이 등급은 Decentraland의 다음을 위반하는 씬에 콘텐츠 관리자에 의해 수동으로 적용됩니다 콘텐츠 정책. 위반 사항에는 다음이 포함될 수 있으며, 이에 국한되지 않습니다:

의심스러운 콘텐츠 또는 스팸
모욕적이거나 혐오적인 콘텐츠
성적이거나 비하적인 콘텐츠
아동 학대
괴롭힘 또는 따돌림
테러/폭력 조장
IP/저작권 침해

이 등급의 씬은 로드되지 않으며 누구도 상호작용할 수 없습니다. 씬이 이 범주에 해당하면 검토하고 다음을 준수하도록 업데이트해야 합니다 콘텐츠 정책.

기능 토글

플레이어가 이를 악용하지 못하도록 특정 씬에서 비활성화할 수 있는 기능이 있습니다. 다음에서 이를 구성하세요 설정 씬 설정의 탭.

현재는 다음 기능만 이렇게 처리됩니다:

음성 채팅: 플레이어가 마이크를 사용해 주변의 다른 플레이어와 음성 채팅으로 대화하는 것을 말합니다.
포터블 익스피리언스 비활성화: 이 설정은 플레이어가 씬 안에 서 있을 때 어떤 포터블 익스피리언스든 그 동작을 지정합니다. 여기에는 다음뿐만 아니라 포터블 익스피리언스 뿐만 아니라 스마트 웨어러블. 이 설정을 사용하면 모두 활성화 상태로 유지(기본값)하거나, 비활성화하거나, UI를 숨길 수 있습니다. 이는 예를 들어 파쿠르 챌린지에서 제트팩을 사용하는 것처럼 포터블 익스피리언스가 일부 플레이어에게 불공정한 이점을 줄 수 있는 씬에 유용합니다. 또한 블록체인 거래가 이루어지고 악의적인 포터블 익스피리언스가 씬의 UI를 사칭할 가능성이 있는 씬에서는 이를 차단하는 것이 좋습니다.

다음에서 scene.json 파일에서 이러한 토글은 다음 아래에서 관리됩니다 featureToggles. 해당 기능은 다음으로 지정되지 않는 한 기본적으로 활성화됩니다 비활성화됨 다음에서 scene.json 파일.

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

만약 featureToggles 속성이 다음에 존재하지 않으면 scene.json 파일, JSON 트리의 루트 수준에 생성하세요.

팁 보내기

장면을 방문하는 플레이어로부터 팁을 받을 수 있습니다. 팁 기능을 활성화하려면 장면 설정의 세부 정보 탭으로 이동하여 다음 아래에 이더리움 주소를 입력하세요. 제작자 지갑 주소.

씬의 팁 주소도 다음에서 제공할 수 있습니다 scene.json 파일의 다음 아래에서 creator 필드.

  "creator": "0x1234567890123456789012345678901234567890"

플레이어가 장면을 방문하면 화면 왼쪽 상단에 돼지저금통 아이콘이 보입니다. 이를 클릭하면 팁을 보낼 수 있는 모달이 열립니다. 이 메뉴는 지도에서 장면 정보를 열어도 접근할 수 있습니다.

팁 모달에서는 플레이어가 보내고 싶은 MANA 양을 선택할 수 있습니다. 팁을 보내려면 플레이어가 지갑에 MANA를 보유하고 있어야 합니다. 제공한 주소가 Decentraland NAME에 연결되어 있으면, 이 모달에 이더리움 주소와 함께 지갑 소유자의 이름이 표시됩니다.

플레이어가 팁을 보낼 때마다 Decentraland 알림 탭에서 알림을 받게 됩니다.

스폰 위치

다음 스폰 설정 다음에서 설정 탭은 플레이어가 브라우저에 좌표를 직접 입력하거나 텔레포트하여 씬에 직접 접근할 때 어디에서 스폰되는지 정의합니다.

씬에는 나무나 계단처럼 플레이어가 그 위에 스폰되면 이동을 막을 수 있는 오브젝트가 있을 수 있습니다. 씬에 높은 지형이 있을 수도 있습니다. 플레이어가 움직일 수 없는 위치에 스폰되는 것을 방지하려면 특정 위치에 여러 스폰 위치를 설정할 수 있습니다.

위치는 씬 내부의 좌표로 구성됩니다. 이 숫자는 패럴셀 내부의 위치를 나타내며, 씬 코드의 Transform 컴포넌트에서 다음을 위해 사용하는 것과 비슷합니다 엔티티를 배치.

📔 참고: 모든 스폰 포인트는 씬을 구성하는 패럴셀 안에 있어야 합니다. 플레이어를 이러한 패럴셀 공간 밖에 스폰할 수는 없습니다.

다음 항목을 체크하세요 랜덤 오프셋 체크박스에서 스폰되는 플레이어를 스폰 포인트 주변에 무작위로 오프셋하세요. 이렇게 하면 스폰될 때 모든 플레이어가 서로 겹쳐 보이는 것을 방지할 수 있는데, 특히 사람이 많은 씬에서 보기 좋지 않습니다. 다음 최대 오프셋 값은 원래 스폰 포인트에서 X축과 Z축 양쪽 모두에서 가능한 최대 거리입니다.

다음을 설정하세요 카메라 타겟 을 사용해 플레이어가 씬에 들어올 때 바라보는 방향을 제어할 수 있습니다. 이렇게 하면 첫인상을 더 잘 제어할 수 있고 특정 방향으로 유도하는 데도 도움이 됩니다. 기본적으로 이는 다음을 가리킵니다 {x: 8, y:1, z:8}, 단일 패럴셀 씬에서는 씬의 중앙이고, 더 큰 씬에서는 왼쪽 아래 패럴셀의 중앙입니다.

를 클릭하세요 스폰 포인트 추가 를 눌러 원하는 만큼 스폰 포인트를 나열하세요. 플레이어는 그중 하나에 무작위로 나타납니다.

JSON의 스폰 포인트

스폰 포인트는 다음을 통해서도 구성할 수 있습니다 scene.json 파일의 다음에서 spawnPoints 필드.

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

단일 씬에도 여러 스폰 포인트를 둘 수 있습니다. 이는 큰 씬에서 특히 유용합니다. 여러 스폰 포인트를 두려면 단순히 배열로 나열하세요.

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

여러 스폰 포인트가 있을 경우, 플레이어가 지정한 좌표에 가장 가까운 것이 선택됩니다.

스폰 포인트가 다음으로 표시되어 있으면 기본값, 가장 가까운지와 관계없이 항상 사용됩니다. 여러 스폰 포인트가 다음으로 표시되어 있으면 기본값, 가장 가까운 것이 선택됩니다.

  "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].

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

위 예시에서 플레이어는 꼭짓점이 다음에 있는 정사각형의 아무 곳에나 나타날 수 있습니다 1,1,2 및 5,1,4.

씬은 여러 스폰 포인트를 가질 수 있는 것처럼 여러 스폰 영역도 가질 수 있습니다.

  "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 필드.

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

이 예시는 플레이어를 다음 위치에 스폰합니다 5, 1, 4 동쪽을 향해 10, 1, 4. 스폰 위치가 범위인 경우, 플레이어의 회전은 항상 지정된 타겟과 일치합니다. 여러 스폰 포인트가 있으면 각 스폰 포인트에 별도의 타겟을 둘 수 있습니다.

필수 권한

다음 requiredPermissions 속성은 악용될 수 있고 플레이어 경험을 해칠 수 있는 여러 제어 기능을 관리합니다.

📔 참고: 권한은 다음에서만 관련이 있습니다 포터블 익스피리언스 및 스마트 웨어러블. 일반 씬(패럴셀 또는 월드 모두)은 이러한 권한의 영향을 받지 않으며, 해당 기능을 자유롭게 사용할 수 있습니다.

이러한 기능은 다음에서 권한이 요청되지 않는 한 씬에서 사용할 수 없습니다 scene.json 파일.

"requiredPermissions": [
    "ALLOW_TO_MOVE_PLAYER_INSIDE_SCENE",
		"OPEN_EXTERNAL_LINK",
  ],

다음 권한을 요청할 수 있습니다:

ALLOW_TO_MOVE_PLAYER_INSIDE_SCENE: 다음을 의미합니다 플레이어를 이동시키는 것
ALLOW_TO_TRIGGER_AVATAR_EMOTE: 다음을 의미합니다 플레이어 아바타에서 이모트를 재생하는 것
ALLOW_MEDIA_HOSTNAMES: (레거시) 다음과 같은 스트리밍 미디어를 의미합니다 비디오 또는 오디오)를 외부 도메인에서 가져오는 것.
USE_WEB3_API: 플레이어의 브라우저 지갑과 상호작용하여 거래를 하거나 메시지에 서명하는 것을 의미합니다.
USE_FETCH: 다음을 사용해 제3자 서버로 HTTP 요청을 보내는 것을 의미합니다 fetch 또는 signedFetch
USE_WEBSOCKET: 제3자 서버와 웹소켓 연결을 여는 것을 의미합니다
OPEN_EXTERNAL_LINK: 플레이어에게 외부 사이트 링크를 열도록 요청하는 것을 의미합니다

만약 requiredPermissions 속성이 다음에 존재하지 않으면 scene.json 파일, JSON 트리의 루트 수준에 생성하세요.

다음을 사용할 때 ALLOW_MEDIA_HOSTNAMES, 또한 다음을 포함하세요 allowedMediaHostnames 필드를 루트 수준에 추가하여 씬이 미디어를 스트리밍할 수 있는 도메인 목록을 나열하세요:

"requiredPermissions": [
    "ALLOW_MEDIA_HOSTNAMES"
  ],
"allowedMediaHostnames": [
    "somehost.com",
    "otherhost.xyz"
  ],

📔 참고: ALLOW_MEDIA_HOSTNAMES 및 allowedMediaHostnames 은 레거시 설정이므로 추가할 필요가 없습니다. 웹 클라이언트의 이전 버전에서만 강제되었으며, 현재 Decentraland 클라이언트는 없어도 외부 미디어를 재생합니다.

씬 패럴셀

다음 때 배포 씬을 배포하면 콘텐츠가 씬 설정에 지정된 좌표로 업로드됩니다. 씬에는 단일 패럴셀 또는 수십 개까지의 패럴셀 목록을 포함할 수 있습니다.

Scene Editor의 씬 메뉴 두 번째 탭에서 이를 편집할 수 있습니다.

드롭다운을 사용하고 다음을 클릭하세요: 레이아웃 적용 씬의 크기를 변경합니다. 각 개별 구획을 클릭하여 레이아웃에서 제외할 수도 있습니다.

기본 씬의 좌표는 다음으로 설정됩니다 0,0. 오프라인에서 씬을 개발하는 동안에는 여러 패럴셀을 차지해야 하는 경우가 아니라면 이를 바꿀 필요가 없습니다. 배포 권한이 있는 좌표로 배포하기 전에 이를 변경해야 합니다.

씬 좌표도 다음에서 변경할 수 있습니다 scene.json 파일:

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

다음 base 필드는 어떤 패럴셀을 기준 패럴셀로 볼지 정의합니다. 씬에 단일 패럴셀이 있으면 base는 그 패럴셀이어야 합니다. 씬에 여러 패럴셀이 있으면 base는 왼쪽 아래(남서) 패럴셀이어야 합니다. 모든 엔티티 위치는 이 패럴셀의 남서쪽 모서리를 기준으로 측정됩니다.

씬 미리보기에서 여러 패럴셀을 표시하려면 사용할 패럴셀 수만큼 나열하세요. 실제로 배포할 패럴셀과 정확히 같을 필요는 없지만, 모두 인접해 있고 같은 상대 위치로 배치되어 있어야 합니다.

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

📔 참고: 설정할 수 있는 최대 씬 크기는 300 x 300 패럴셀(총 90,000개)입니다.

명령줄로 패럴셀 설정

다음을 실행해 씬의 패럴셀을 설정할 수 있습니다 npx update-parcels 를 씬 폴더에서 실행하세요. 이는 관련된 모든 패럴셀을 나열할 필요가 없으므로 큰 씬에서 특히 유용합니다.

📔 참고: update-parcels 는 제3자 커뮤니티 도구이며, 공식 Decentraland SDK의 일부가 아니고 Decentraland Foundation에서 유지 관리하지 않습니다.

단일 패럴셀

씬 좌표를 하나의 인자로 전달하세요. 이 좌표는 base 패럴셀로도 설정됩니다.

npx update-parcels <parcel>

예:

npx update-parcels 15,-26

여러 패럴셀

두 개의 인자를 전달하세요: 남서쪽과 북동쪽 패럴셀입니다. 남서쪽 패럴셀이 base 패럴셀로도 설정됩니다.

npx update-parcels <parcel> <parcel>

💡 팁: 남서쪽 패럴셀은 항상 다음 두 좌표 모두에서 가장 낮은 숫자를 가진 패럴셀입니다 X 및 Y 좌표.

예:

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

이 명령은 base 패럴셀이 다음에 있는 3x3 씬을 생성합니다 15,-26.

base 패럴셀 사용자 지정

세 개의 인자를 전달하세요: 남서쪽 패럴셀, 북동쪽 패럴셀, 그리고 base 패럴셀로 사용할 패럴셀입니다.

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

📔 참고: base 패럴셀은 씬에 있는 패럴셀 중 하나여야 합니다.

정사각형이 아닌 씬

위 명령들은 모두 직사각형 형태의 씬을 생성합니다. Decentraland 씬은 L자형이나 다른 구성도 가질 수 있습니다. 다음으로 더 큰 정사각형을 생성한 뒤 npx update-parcels 그다음 초과 패럴셀을 수동으로 다음에서 제거할 수 있습니다 scene.json 파일.

📔 참고: base 패럴셀은 씬에 있는 패럴셀 중 하나여야 합니다.

스카이박스 시간대

씬에 고정된 시간대를 설정할 수 있습니다. 모든 플레이어는 이 시간대의 씬을 보게 되며, 스카이박스는 낮/밤 주기를 따르지 않습니다.

씬 설정을 열고 다음을 클릭하세요 설정 탭에서 다음을 찾으세요. 스카이박스 섹션. 다음의 선택을 해제하세요. 자동 옵션을 선택한 뒤 원하는 시간대를 설정하세요.

씬 코드에서도 스카이박스 시간대를 설정할 수 있습니다. 이렇게 하려면 다음 섹션을 당신의 scene.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 월드 는 초원, 나무, 바다로 이루어진 자동 생성 풍경으로 둘러싸입니다. 이 풍경이 예를 들어 열린 물 위나 우주에 떠 있는 씬처럼 씬의 미적 요소와 맞지 않으면 비활성화할 수 있습니다. 이렇게 하려면 다음 필드를 여러분의 scene.json 루트 수준에 추가하세요:

{
	"landscapeTerrain": false
}

다음과 함께 landscapeTerrain 로 설정하면 false, 씬의 구획 너머에는 아무것도 렌더링되지 않으며, 플레이어는 씬 주변의 스카이박스만 보게 됩니다. 주변 지형을 제거하면 렌더링 리소스도 확보되어 씬이 더 부드럽게 실행되는 데 도움이 될 수 있습니다.

이 필드가 설정되지 않으면 기본값은 true 이며 풍경은 평소대로 표시됩니다.

📔 참고: 이 필드는 단일 씬이 포함된 World에만 적용됩니다. Genesis City에서는 주변 환경이 항상 인접한 구획에 의해 결정되므로 이 필드는 무시됩니다. 또한 로컬 미리보기로 씬을 실행할 때 풍경 없이 씬이 어떻게 보이는지 확인하는 데 사용할 수 있습니다.

World 설정

다음에 게시할 때 Decentraland 월드, 여러분의 scene.json 파일에서 다음을 사용하여 worldConfiguration 객체.

기본 World 설정

World에 게시하려면 여러분의 scene.json:

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

다음 name 지정된 값은 Decentraland NAME 또는 ENS 도메인일 수 있으며, 배포에 서명하는 지갑(또는 액세스 제어 목록을 통해 권한을 부여받은 다른 지갑)이 소유해야 합니다.

통신 서비스 설정

다음 fixedAdapter 속성은 씬에서 사용할 통신 서비스를 지정합니다. 현재는 오직 offline:offline 값만 허용됩니다. 이 값을 설정하면 씬에는 통신 서비스가 전혀 없게 되며, 해당 World에 참여하는 각 사용자는 항상 혼자 있게 됩니다. 설정하지 않으면 Worlds 콘텐츠 서버가 구성 방식에 따라 적절한 값을 생성합니다.

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

📔 참고: 설정 fixedAdapter 을 "offline:offline" (또는 싱글 플레이어 를 Creator Hub의 World 설정에서 활성화하면) 라이브 스트리밍이 비활성화됩니다. 스트리밍 기능은 시청자에게 영상을 전달하기 위해 통신 계층에 의존합니다. 여러분의 World에서 라이브 스트리밍이 필요하다면 이 옵션을 사용하지 마세요.

Places 목록 설정

옵트아웃하지 않는 한 모든 World는 자동으로 Places 페이지에 표시됩니다. World가 Places에서 인덱싱되지 않도록 옵트아웃하려면 다음을 추가할 수 있습니다:

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

전체 예시

모든 World 설정 옵션이 포함된 전체 예시입니다:

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

참조 World에 게시하기 World에 배포하는 방법에 대한 자세한 내용은

씬 코드에서 메타데이터 가져오기

Scene API 참조

씬 메타데이터의 필드에 접근하려면 씬 코드가 필요할 수 있습니다. 예를 들어 씬이 배포된 구획이나 스폰 지점 위치 등이 있습니다. 이는 복제 대상으로 만들어진 씬이나 다른 씬에서 재사용하려는 코드에 특히 유용합니다. 또한 씬의 경계가 어디인지 알아야 하는 라이브러리에도 매우 유용합니다.

이 데이터에 접근하려면 먼저 다음을 import하세요: getSceneInformation 함수:

import { getSceneInformation } from '~system/Runtime'

그다음 다음을 호출할 수 있습니다: getSceneInformation() 함수는 scene.json 파일의 대부분 내용을 포함한 JSON 객체를 반환합니다. 아래 예시는 이 함수의 응답에서 더 일반적인 필드 몇 가지에 접근하는 방법을 보여줍니다:

import { getSceneInformation } from '~system/Runtime'

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

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

📔 참고: getSceneInformation() 다음으로 실행되어야 합니다: async 함수, 응답이 데이터를 반환하는 데 0.몇 초 이상 지연될 수 있으므로. 더 이상 사용되지 않는 getSceneInfo() 함수를 사용하지 마세요.

다음이 반환한 객체: getSceneInformation() 에는 다음이 포함됩니다:

baseUrl: 씬 콘텐츠가 호스팅되는 기본 URL
content: 해시를 포함한 씬의 모든 파일이 들어 있는 배열로, baseUrl과 함께 사용하여 파일을 가져올 수 있습니다.
metadataJson: 씬의 scene.json 전체 내용이 문자열로 들어 있습니다. 특정 값을 얻으려면 이를 파싱해야 합니다.
urn: 씬 전체에 대한 고유한 urn

아래 예시는 다음의 내용을 파싱합니다: metadataJson scene.json 파일의 속성에서 값을 얻기 위해

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 })
})

이전씬 파일

다음스마트 웨어러블

마지막 업데이트 11일 전