안녕하세요! 원하는 언어를 선택해 주세요:
닫기

디센트럴랜드 씬 미리보기(preview) 기능은, 실행중인 서버에 무료로 콘텐츠를 업로드할 수 있게 해주는 편리한 서비스인 Now와 호환 가능합니다. 여러분은 디센트럴랜드 씬을 이들 서버들 중 하나에 쉽게 업로드할 수 있고, 해당 씬에 대한 미리보기가 각각의 방문자들에게 자동으로 론칭될 것입니다.

이는 여러분의 콘텐츠를 남들과 공유할 수 있는 환상적인 방법입니다! 이를 활용하면, 지구(district)의 리더들은 지구 개발 진척상황을 보여주는 데 활용할 수 있고, 개발자들은 다른 사람들로부터 피드백을 얻을 수 있으며, 또는 단순히 여러분이 구축한 내용을 커뮤니티와 공유함으로써 작업물에 대한 인지도를 얻거나 다른 사람들에게 영감을 줄 수도 있습니다.

일단 Now에 업로드하게 되면 다른 사람들은 여러분의 씬을 보기 위해 단지 링크를 따라가기만 하면 됩니다. 그들은 그들의 로컬 머신에서 미리보기를 실행시키기 위해 CLI, Node, NPM을 비롯해 어떠한 툴도 설치할 필요가 없습니다.

예를 들어, 현재 Now에서 실행중인 다음과 같은 씬 예제들이 있습니다:

링크를 여는 각각의 사람들은 다른 사람들과 독립적으로 씬을 실행하고 있다는 데 유의하실 필요가 있습니다. 설사 동일한 서버에서 씬이 실행된다고 할 지라도, 씬 상태는 각각의 사용자의 브라우저에 저장되기 때문에 여러분은 다른 사용자들과 상호작용하거나 그들을 볼 수는 없습니다.

반면 여러분이 원격 씬(remote scene)을 배포한다면, 여러분은 링크를 여는 다른 사람들과의 상호작용이 가능하게 됩니다. 원격 씬을 _Now_에 배포하는 방법에 대해서는 아래에 내용이 계속 이어집니다.

여러분의 씬을 실행가능한 상태로 만드세요

여러분의 씬을 Now에서 실행하기 위해서는 가장 최신 SDK 버전(4.1.0)을 사용 중인지 먼저 확인하시기 바랍니다. SDK 버전은 씬에 명시되며 CLI로 처음 씬을 생성할 때 결정된다는 것을 기억하시기 바랍니다. 그렇기 때문에, CLI 구 버전으로 생성한 씬을 보유한 상태에서 이후 CLI를 업데이트하였다면, 여러분은 수동으로 씬을 업데이트해서 씬이 SDK 최신 버전을 참조하도록 해야만 합니다.

씬을 수동으로 업데이트하기 위해서는, 상세 내용이 나와 있는 이곳을 여시고 Migrate a scene to 4.1.0 아래에 있는 설명을 따라가시면 됩니다.

일단 여러분의 씬이 버전 4.1.0로 업데이트되면, package.json 파일을 수정하셔서 scripts에 now-start 부분을 추가하시기 바랍니다. 이렇게 추가된 스크립트는 dcl start --ci 명령을 실행하게 됩니다.

여러분의 package.json 파일은 다음 내용을 포함해야만 합니다:

{
  "name": "dcl-project",
  "version": "1.0.0",
  "description": "My new Decentraland project",
  "scripts": {
    "start": "dcl start",
    "now-start": "dcl start --ci",
    "build": "decentraland-compiler build.json",
    "watch": "decentraland-compiler build.json --watch"
  },
  "author": "",
  "license": "MIT",
  "devDependencies": {
    "decentraland-api": "latest",
    "decentraland": "latest"
  },
  "dependencies": {
    "ajv": "^6.5.3"
  }
}

_Now_는 씬이 배포되자 마자 _now-start_에 있는 스크립트를 자동으로 실행시키게 될 것입니다. 이 때 dcl start 명령에 --ci 플래그(flag)를 붙여 사용하는데, 이는 미리보기 실행을 약간 다른 방식으로 조정하여 _Now_나 다른 호스팅 및 테스팅 서비스와 호환되게 하려는 것입니다.

Now 데스크톱 클라이언트를 다운로드 받아 사용하세요

  • _Now Desktop Client_를 다운로드 받기 위해서는 zeit.co 웹사이트를 방문하십시오.
  • 데스크톱 클라이언트를 설치하셔서 열게 되시면 여러분의 다른 실행 프로그램들 옆에 삼각형 모형의 Now 아이콘이 보여지게 됩니다.

  • 씬 폴더 전체를 클릭하셔서 툴바에 있는 Now 아이콘 위에 드롭하십시오. 그러면 폴더의 콘텐츠가 서버에 업로드되기 시작합니다.
  • 브라우저에서 자동으로 새로운 탭이 열리고 여러분의 씬을 실행하기 위한 필수 의존 파일들을 설치하는 서버 콘솔이 보일 것입니다. 이 과정에서 몇 분이 소요되지만, 모든 파일들이 설치되고 나면 씬 미리보기가 자동으로 열리게 될 것입니다.
  • 원하는 모든 사람들과 링크를 공유하세요! Now가 그 링크에서 여러분의 씬을 계속해서 호스팅하게 될 것입니다.

Now 무료 버전에서 허용하는 최대 파일 사이즈는 50 MB임에 주의하시기 바랍니다.

여러분의 씬이 만약 이 제한치를 초과하게 된다면, node_modules 폴더를 삭제하시고, 씬 폴더 안에서 업로드가 필요없거나 package.json 파일에 따라 서버가 자동적으로 설치하는 기타 파일들도 삭제해 주시기 바랍니다.

Now에 원격 씬 업로드하기

CLI에서 Remote Scene 옵션을 사용하여 씬을 생성하였다면, _Now_에 두 개의 별도 배포판을 만들 필요가 있는데, 하나는 서버용이고 다른 하나는 씬 클라이언트용입니다.

배포를 위해서는 툴바에 있는 Now 아이콘에 /server 폴더를 드래그해 갖다 놓으십시오. 브라우저 창이 열리고 모든 의존 파일들이 설치되는 콘솔이 보이게 될 것입니다. 완료 후 미리보기가 실행되면 브라우저 탭에서 URL을 복사하십시오.

/scene 폴더에서 scene.json 파일을 열고 main 필드를 수정하여 Now에 배포하고자 하는 서버의 링크(방금 복사했던 URL)를 가리키도록 하십시오. 이 때 URL 주소를 수동으로 수정하셔서 https 대신 wss (web socket secure)로 시작하도록 바꾸셔야만 합니다.

예를 들어, 서버 주소가 https://dcl-project-fsutefbepd.now.sh/ 라면, scene.json 파일은 다음과 같아야 합니다:

{
  "display": {
    "title": "scene-example",
    "favicon": "favicon_asset"
  },
  "owner": "",
  "contact": {
    "name": "",
    "email": ""
  },
  "main": "wss://dcl-project-fsutefbepd.now.sh/",
  "tags": [],
  "scene": {
    "parcels": ["0,0"],
    "base": "0,0"
  },
  "communications": {
    "type": "webrtc",
    "signalling": "https://rendezvous.decentraland.org"
  },
  "policy": {
    "contentRating": "E",
    "fly": true,
    "voiceEnabled": true,
    "blacklist": [],
    "teleportPosition": "0,0,0"
  }
}

scene.json 파일 편집 후 /scene 폴더를 툴바에 있는 Now 아이콘에 드래그해 놓으면 배포가 가능해집니다.

맺음말

여러분이 지금껏 SDK로 콘텐츠를 개발해 오셨다면, 이를 커뮤니티와 공유하실 것을 권장드립니다! 누구나 접근이 가능하며 여러분의 작업을 온전히 다 보여드릴 수 있다는 점에서, 상호작용이 가능한 미리보기 기능 제공은 콘텐츠 공유를 완벽히 실현할 수 있는 방법입니다. 아울러 여러분의 작업물을 보고 들뜨게 될 개발자와 아티스트들의 활기찬 커뮤니티가 있는 디스코드(Discord)에 여러분의 작업물 링크를 포스팅하시는 것도 권해드립니다!

그럼, 즐거운 개발되시기를 바랍니다!

구축 시작!
SDK는 게임 및 앱 개발에 필요한 모든 것을 제공합니다.
시작하기