스마트 아이템 - 기본
씬에서 스마트 아이템을 사용하여 상호작용 기능을 추가합니다.
씬 편집기 카탈로그의 일부 항목은 스마트 아이템. 플레이어는 이들과 상호작용할 수 있고, 구성 가능한 속성을 가지며, 다른 스마트 아이템에 대한 액션을 트리거할 수 있습니다. 예를 들어 열고 닫을 수 있는 문, 위아래로 움직이는 플랫폼, 또는 다른 항목을 활성화할 수 있는 버튼과 레버가 있습니다.
이 항목들은 번개 아이콘과 다른 색상의 배경이 있어서 에셋 팩 탐색기에서 알아볼 수 있습니다.
엔티티 트리에서 번개 아이콘이 붙어 있어 씬 안의 어떤 항목이 스마트 아이템인지 알아볼 수 있습니다.
아이템 사용하기
스마트 아이템을 사용하려면 다른 아이템처럼 씬으로 드래그하세요. 모든 아이템에는 기본 동작이 포함되어 있으며, 씬 미리보기를 실행해 사용해 보세요.
다음은 일반적인 항목들과 그 기본 동작입니다:
문: 문은 클릭하면 열리거나 닫힙니다. 이 동작은 버튼, 트리거 영역 등으로 열리도록 변경할 수 있습니다.
버튼: 클릭하면 피드백으로 소리와 애니메이션을 재생합니다. 트리거 이벤트에 더 많은 액션을 추가해 다른 스마트 아이템을 활성화할 수 있습니다.
레버: 클릭하면 두 상태 사이를 전환합니다. 레버의 각 위치가 다른 스마트 아이템에 대해 서로 다른 액션을 수행하도록 만들 수 있습니다.
상자: 문처럼 동작하며, 기본적으로 클릭하면 열리거나 닫힙니다. 안에 더 작은 아이템을 넣을 수 있습니다.
플랫폼: 두 위치 사이를 이동합니다. 이동 위치, 속도 등을 제어하려면 트윈 액션을 사용하세요.
트리거 영역: 플레이어가 해당 영역으로 걸어 들어오면 다른 스마트 아이템을 트리거할 수 있는 보이지 않는 아이템입니다. 참조 트리거 영역 정보.
아바타 수정 영역: 아바타의 동작이나 모습을 영역 안에서 바꾸는 보이지 않는 영역입니다. 예를 들어 아바타를 숨기거나 여권 팝업을 비활성화할 수 있습니다. 참조 수정 영역.
카메라 수정 영역: 안에 있는 동안 플레이어의 카메라를 1인칭 또는 3인칭으로 강제하는 보이지 않는 영역입니다. 참조 수정 영역.
비디오 플레이어: 비디오나 라이브 스트림을 보여주는 화면입니다. 참조 비디오 재생.
오디오 스트림: 라이브 스트림에서 오디오를 재생합니다. 참조 오디오 스트림 재생
NFT: NFT 이미지를 초상화로 표시합니다. 참조 NFT 표시
모든 스마트 아이템은 원하는 방식으로 동작하도록 구성할 수 있습니다. 예를 들어 플랫폼이 얼마나 멀리 움직이는지, 또는 버튼이 무엇을 활성화하는지 등을 설정할 수 있습니다.
아이템 구성하기
씬 편집기에서 아이템을 선택하면 오른쪽에서 모든 속성을 볼 수 있습니다.
대부분의 스마트 아이템은 동작을 스크립트 컴포넌트에 저장합니다. 설정은 스크립트 패널에 표시되며, 매개변수마다 한 필드가 있고 각 필드에는 기능을 설명하는 툴팁이 있습니다. 사용하려고 코드를 작성할 필요는 없습니다.
많은 아이템에서 찾을 수 있는 일반적인 필드는 다음과 같습니다:
호버 텍스트: 플레이어가 커서를 아이템 위로 올렸을 때 힌트로 UI에 표시되는 텍스트입니다. 예를 들어 문에는 "열기"라고 표시될 수 있습니다.
상호작용: 어떤 버튼으로 아이템을 활성화할까요? 일반적인 키보드에서는:
기본 가 E
보조 가 F
포인터 가 마우스 왼쪽 버튼
동작3 키 1
동작4 키 2
동작5 키 3
동작6 키 4
아이템에 반응하는 훅: 특정 순간에 실행할 액션을 선택하는 매개변수입니다. 어떤 것이 있는지는 아이템이 무엇을 하는지에 따라 다릅니다. 버튼에는 onClick, 레버에는 onActivate 과 onDeactivate, 움직이는 플랫폼에는 onReachStart 과 onReachEnd, 종에는 onRing이 있습니다. 훅을 비워 두면 그 순간에는 아무 일도 일어나지 않습니다.
각 아이템에는 고유한 설정이 있으며, 아이템마다 다를 수 있습니다.
몇몇 아이템은 대신 이전 Config 패널을 사용합니다. 예를 들어 조명은 여전히 그곳에서 색상과 강도를 설정합니다.
모든 아이템에는 고급 모드 가 있어서 거의 모든 것을 구성할 수 있습니다. 여기에는 어떤 소리가 재생되는지, 플랫폼이 어느 방향으로 움직이는지 같은 것들이 포함됩니다. 또한 플레이어를 텔레포트시키기, 아바타 애니메이션 재생하기, 아이템을 플레이어의 손에 붙이기 등 온갖 작업을 포함하는 사용자 정의 액션도 추가할 수 있습니다. 특정 시나리오에서만 무언가를 활성화하도록 조건 로직도 추가할 수 있습니다. 참조 스마트 아이템 - 고급.
다른 항목에 액션 호출
스마트 아이템은 다른 스마트 아이템에서 액션을 트리거할 수 있어, 아이템이 활성화될 때마다 그런 일이 일어나게 할 수 있습니다. 씬의 모든 아이템 목록에서 호출하려는 아이템을 선택한 다음 액션을 선택하기만 하면 됩니다. 아이템마다 노출하는 액션은 다릅니다.
예를 들어 버튼 하나가 문을 열거나 닫는 경우를 보겠습니다. 버튼을 누를 때마다 문은 열리거나 닫힙니다.
활성화되면 문을 열고, 비활성화되면 그 문을 닫는 레버입니다.
서로 다른 아이템의 여러 액션을 한 번에 트리거하도록 추가할 수 있습니다. 다음을 클릭하기만 하세요 + 액션 할당.
액션 옆의 세 점을 클릭하고 다음을 선택하여 액션을 제거할 수 있습니다 액션 제거.
항목이 제공하는 액션은 다음과 같이 익숙한 이름을 유지합니다: 열기, 닫기, 여기에 앉기, 켜기또는 텔레포트, 따라서 항목 간 연결은 언제나와 같은 방식으로 작동합니다.
액션을 연쇄로 연결할 수도 있습니다. 예를 들어 레버의 onActivate 가 문을 열고, 그 문의 훅이 다른 것을 트리거하면 레버가 간접적으로 전체 연쇄를 작동시킵니다.
다음을 사용하면 고급 모드 이런 종류의 액션에 조건부 로직도 추가할 수 있습니다.
특수 스마트 아이템
일부 스마트 아이템은 일반적인 상황에서 매우 유용한 고유한 특성을 가지고 있습니다:
트리거 영역
플레이어가 영역으로 걸어 들어올 때 액션을 트리거하려면 Trigger Area 스마트 아이템을 사용하세요.
다음을 사용하세요 플레이어가 영역에 들어올 때 과 플레이어가 영역을 벗어날 때 항목의 트리거 구성 요소의 트리거 유형. 이 트리거 이벤트의 액션은 플레이어가 영역에 들어오거나 나갈 때마다 활성화됩니다.
다음 트리거 영역 에서 더 많은 정보를 확인하세요.
보이지 않는 벽
플레이어가 영역을 통과하거나 클릭해 지나가는 것을 막을 수 있는 보이지 않는 도형 모음입니다.
이 보이지 않는 벽은 충돌 메쉬가 없는 3D 모델을 가져올 때나, 플레이어에게 보이지 않는 벽을 만들고 싶을 때 유용합니다.
다음 콜라이더 에서 더 많은 정보를 확인하세요.
클릭 영역
플레이어가 클릭해 다른 스마트 아이템의 액션을 트리거할 수 있는 보이지 않는 큐브입니다. 이 아이템은 다른 스마트 아이템으로 활성화하거나 비활성화할 수 있으며, 비활성화되면 클릭할 수 없습니다. 커서를 올렸을 때 플레이어가 보게 될 텍스트도 설정할 수 있습니다.
좌석
의자, 벤치, 그 밖의 좌석은 클릭하면 플레이어가 앉을 수 있게 해줍니다.
좌석은 그것을 차지한 플레이어가 멀어져 서 1.5미터 이상 떨어지면 비워집니다.
벤치처럼 여러 자리가 있는 항목에서는 클릭하면 당신을 가장 가까운 빈 자리.
모든 자리가 차 있으면 호버 텍스트에 다음이 표시됩니다 자리가 찼습니다 그리고 클릭해도 아무 일도 일어나지 않습니다.
텔레포트
이 텔레포트 항목은 플레이어가 상호작용하면 다른 곳으로 보냅니다.
다음을 설정하세요 x 과 y 매개변수를 설정하면 Genesis City의 파셀로 보낼 수 있습니다. 대신 다음으로 보내려면 월드 대신 다음을 입력하세요 world 매개변수에 월드 이름을 입력합니다. 예: myname.dcl.eth를 입력하고 좌표는 비워 두세요.
이동 설정
이 이동 설정 항목은 플레이어가 씬 안에 있는 동안 이동 속도와 점프 높이를 바꿉니다. 씬을 더 둥둥 떠 있는 느낌으로 만들거나, 박물관에서 플레이어 속도를 늦추거나, 큰 맵에서 더 빠르게 이동하게 할 때 사용할 수 있습니다.
씬의 아무 곳에나 드래그하세요. 씬이 시작되면 값이 적용되며, 플레이스홀더 큐브는 편집기에서만 보이고 플레이어에게는 보이지 않습니다.
각 필드는 슬라이더이며, Decentraland의 기본값으로 미리 설정되어 있습니다:
walkSpeed
1.5 m/s
0~10
jogSpeed
8 m/s
0~30
runSpeed
10 m/s
0~50
jumpHeight
1 m
0~10
runJumpHeight
1.5 m
0~10
doubleJumpHeight
2 m
0~15
glidingSpeed
6 m/s
0~30
glidingFallingSpeed
1 m/s
0~10
hardLandingCooldown
0.75 s
0~5
조깅은 플레이어가 기본적으로 이동하는 속도입니다. 걷기와 달리기는 각각 Ctrl 또는 Shift 키를 누르고 있을 때 적용됩니다.
이 아이템은 다른 스마트 아이템이 호출할 수 있는 두 가지 액션도 제공합니다:
apply: 트리거 영역이나 버튼 이후처럼 현재 필드 값을 플레이어에게 다시 적용합니다.restoreDefaults: 값을 지워 플레이어가 다시 Decentraland 기본값으로 돌아가게 합니다.
다음 이동 설정 및 제한 각 설정이 정확히 무엇을 하는지, 그리고 코드에서 이 값을 어떻게 바꾸는지에 대한 자세한 내용입니다.
비디오 재생
다음에서 비디오를 재생할 수 있습니다:
로컬 파일
URL에서 스트리밍
다음에서 실시간 스트리밍 Decentraland Cast
다음에서 실시간 스트리밍 RTMP 소프트웨어 (OBS, XSplit, StreamYard 등)
다음 비디오 재생 에서 더 많은 정보를 확인하세요.
오디오 스트림 재생
다음을 사용하여 URL에서 오디오 스트림을 재생합니다 오디오 스트림 스마트 아이템.
스트림의 볼륨을 조절할 수 있습니다. 스트림 오디오는 위치 기반이 아니므로, 씬 전체에서 같은 볼륨으로 들립니다.
NFT 표시
그림 액자에 NFT를 표시하려면 다음을 사용하세요. NFT 스마트 아이템을 사용하세요. 다음 필드를 제공해야 합니다:
네트워크
NFT 컬렉션 컨트랙트: NFT 컬렉션의 스마트 컨트랙트.
토큰 ID: 이 특정 NFT 수집품의 토큰 ID.
이 정보는 다음에서 얻을 수 있습니다 OpenSea, 다음을 확인하여 세부정보 NFT 이미지 아래의 탭.
배경색도 구성할 수 있으며, 특히 배경이 투명한 NFT에 유용합니다.
또한 다음도 선택할 수 있습니다 프레임 스타일, 클래식 및 모던 등 다양한 스타일로 NFT를 액자에 넣을 수 있습니다.
다음 NFT 자세한 내용은.
체력 바
이 체력 바 스마트 아이템은 여러 게임 메커니즘을 위한 훌륭한 기본 블록입니다. 여러 방식으로 사용할 수 있습니다:
다음 아래에 배치하면 플레이어 아바타 위에 플레이어의 체력을 표시할 수 있습니다
다음 아래에 배치하면 카메라 UI에 고정해 표시할 수 있습니다
씬의 말 그대로 어떤 항목 아래에든 배치해 그 항목의 체력을 추적할 수 있습니다
다른 항목은 체력 바와 상호작용해 체력을 더하거나 뺄 수 있습니다.
다음과 같은 항목은 가시 또는 로봇 적 체력을 낮출 수 있습니다
다음과 같은 항목은 응급 처치 또는 치유 패드 체력을 회복할 수 있습니다.
체력이 0일 때 어떤 일이 일어날지 정의하려면 체력 바를 구성해야 합니다. 플레이어를 리스폰 패드 스마트 아이템의 위치로 다시 생성시키거나, 점수 카운터를 초기화하거나, 적을 다시 생성하거나, UI 텍스트를 표시하는 등 게임 로직에 맞는 어떤 것이든 할 수 있습니다.
체력이 특정 값보다 낮을 때 액션을 트리거할 수도 있습니다. 예를 들어 체력이 3보다 낮으면 특별한 음악을 재생하거나 UI 힌트를 표시할 수 있습니다.
체력 바는 무엇이든 영향을 주도록 구성할 수 있습니다! 예를 들어 다음 아래에 체력 바를 넣어 보세요 나무 문 스마트 아이템. 이 바는 플레이어가 다음을 사용해 체력을 낮출 수 있습니다 검 스마트 아이템뿐 아니라 다음의 폭발로도 통 또는 다음의 공격으로도 로봇 적. 이 작업을 하려면, 체력 바가 값이 0일 때 상위 항목에 대해 액션을 수행하도록 구성하세요.
다음과 같은 무기는 검 플레이어가 집어 들 수 있으며, 액션을 수행할 때 플레이어 근처에 있는 체력 바가 있는 다른 항목에 피해를 주는 데 사용할 수 있습니다.
멀티플레이어
거의 모든 스마트 아이템은 멀티플레이어 동작을 하므로, 씬의 모든 플레이어가 아이템의 상태 변경을 함께 경험합니다. 플레이어 A가 문을 열면 플레이어 B도 그 문이 열린 것을 봅니다. 그다음 플레이어 C가 다른 플레이어들이 아직 있는 동안 씬에 들어오면, 그 역시 문이 이미 열려 있는 것으로 보게 됩니다.
하지만 씬 근처에 플레이어가 없으면 씬은 기본 상태로 복원됩니다. 따라서 모든 플레이어가 떠났다가 플레이어 A가 다시 돌아오면, (그것이 문의 기본 상태였다면) 문이 닫혀 있는 것을 보게 됩니다.
뒤에 오는 다른 플레이어를 위해 한 플레이어의 행동이 씬을 망치지 않도록 씬을 설계하세요. 예를 들어 씬이 퍼즐 게임이라면, 다음을 사용할 수 있습니다 지연 액션을 도구 스마트 아이템으로, 퍼즐이 해결된 뒤 몇 초 후 씬의 모든 항목이 초기 상태로 재설정되게 할 수 있습니다.
항목의 멀티플레이어 동작을 비활성화할 수도 있습니다. 참조 스마트 아이템 - 고급.
문제 해결
내 씬의 항목은 클릭 가능해야 하는데 클릭할 수 없습니다.
다른 무엇인가에 의해 가려지지 않았는지 확인하세요. 다른 항목을 통해서는 클릭할 수 없습니다. 일부 항목에는 콜라이더 메시를 포함시킵니다. 간소화된 기하를 가진 것이 있어, 보이는 모양은 그렇지 않아 보여도 항목을 가리고 있을 수 있습니다. 항목을 옮겨 보고 무슨 일이 일어나는지 확인하세요.
또한 참조하세요
마지막 업데이트