> 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/creator/content-creator-ko/scene-editor/interactivity/smart-items-advanced.md).

# 스마트 아이템 - 고급

씬에서 스마트 아이템을 사용하여 상호작용 기능을 추가합니다.

대부분의 스마트 아이템에는 가장 일반적인 설정만 간단하게 구성할 수 있는 기본 모듈이 있습니다. 하지만 아래로 스크롤해 **고급** 표시를 지나면 아이템의 동작 방식을 거의 모든 면에서 맞춤 설정할 수 있습니다.

{% embed url="<https://www.youtube.com/watch?v=m_xWCSDDxpQ>" %}

다음 아이템에는 Transform 컴포넌트와 버튼 구성에 필요한 기본 필드만 표시하는 기본 모듈이 있습니다. 하지만 아래로 스크롤해 **고급** 표시를 지나면 사용 가능한 모든 설정을 확인할 수 있습니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-489d4458f5a0820fb2963f828c986787dabb1bc0%2Fadvanced-settings-smart-item.webp?alt=media)

{% hint style="info" %}
**📔 참고**: 기본 모듈의 설정 대부분은 아래쪽 컴포넌트에서도 사용할 수 있습니다. 기본 모듈에서 변경한 내용은 아래쪽 컴포넌트에도 반영되며, 그 반대도 마찬가지입니다. 단, 기본 설정이 아래쪽의 여러 설정을 추상화한 일부 경우는 예외입니다. 이러한 경우 고급 설정을 기본 모듈에서 지원하지 않는 값으로 변경하면 기본 모듈의 해당 필드가 정의되지 않음으로 표시됩니다.
{% endhint %}

## 고급 구성

속성은 [**컴포넌트**](https://docs.decentraland.org/creator/content-creator-ko/sdk7/architecture/entities-components.md)별로 그룹화됩니다. 스마트 아이템마다 기능에 따라 서로 다른 컴포넌트가 있을 수 있습니다.

대부분의 아이템 동작은 다음으로 제어됩니다.

* [**Actions**](#actions): Actions 컴포넌트는 아이템이 수행할 수 있는 동작을 정의합니다. 예를 들어 소리 재생, 애니메이션 재생, 위로 이동, 투명해지기 등이 있습니다.
* [**Triggers**](#triggers): Triggers 컴포넌트는 동작을 실행할 이벤트를 지정합니다. 예를 들어 플레이어가 아이템을 클릭할 때, 플레이어가 영역에 들어갈 때, 또는 장면이 처음 로드될 때입니다.

예를 들어 문 스마트 아이템의 **Actions** 컴포넌트에는 "열기"와 "닫기" 동작이 포함되어 있습니다. 해당 아이템의 **Triggers** 컴포넌트에는 플레이어가 문을 클릭하면 "열기" 동작을 실행하는 **클릭 시** 트리거가 포함되어 있습니다.

스마트 아이템의 트리거는 같은 스마트 아이템뿐만 아니라 장면에 있는 모든 스마트 아이템의 동작을 실행할 수 있습니다. 예를 들어 버튼 스마트 아이템에는 떠 있는 플랫폼의 **Triggers** 컴포넌트에 정의된 "위로 이동" 동작을 실행하는 **Actions** 컴포넌트를 추가할 수 있습니다.

트리거는 조건에 따라 실행되도록 할 수도 있습니다. 예를 들어 문 스마트 아이템의 Triggers 컴포넌트에는 **클릭 시** 트리거가 두 개 있습니다. 문이 닫혀 있으면 문을 여는 트리거 하나와, 문이 열려 있으면 문을 닫는 트리거 하나입니다. 자세한 내용은 [상태 및 조건부 논리](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/states-and-conditions.md).

## 아이템 간 상호작용

아이템이 서로 상호작용하도록 설정하려면 다음과 같이 하세요.

* 한 아이템의 [Actions](#actions) 컴포넌트에 동작을 하나 이상 정의해야 합니다.
* 다른 아이템의 [Triggers](#triggers) 컴포넌트에는 해당 동작을 가리키는 트리거가 있어야 합니다.

예를 들어 버튼으로 문을 열려면 다음과 같이 하세요.

1. 버튼 스마트 아이템을 추가하고 해당 아이템의 **Triggers** 컴포넌트를 엽니다. 기본 트리거 이벤트가 있어 버튼 자체의 소리와 애니메이션을 재생합니다.
2. 옆에 있는 **+** 기호를 클릭해 **할당된 동작**같은 트리거 이벤트에 세 번째 동작을 추가합니다.
3. 첫 번째 드롭다운에서 문 스마트 아이템을 선택합니다.
4. 두 번째 드롭다운에서 "열기" 작업을 선택합니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-18c5fd9a94ea5c0d3e90a62bbdd3a544dac54d57%2Fbutton-to-door.webp?alt=media)

{% hint style="info" %}
**💡 팁**: 대신 문 동작만 처리하는 새 트리거 이벤트를 만들 수도 있습니다. 버튼을 클릭할 때마다 두 트리거 이벤트가 모두 호출됩니다.

<img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a313d118307399f40a8b72051b897d1b44ae4000%2Fbutton-to-door2.webp?alt=media" alt="" data-size="original">
{% endhint %}

작업이 정의되어 있기만 하면 어떤 항목이든 다른 항목의 작업을 트리거할 수 있습니다. 자세한 방법은 [트리거](#triggers) 를 참조하세요.

다음을 사용하면 [상태와 조건부 논리](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/states-and-conditions.md) 를 통해 조건이 충족된 경우에만 작업을 트리거할 수 있습니다. 조건에서 세 번째 스마트 항목의 상태를 확인할 수도 있습니다. 예를 들어, 사용자 지정 "발전기" 스마트 항목의 상태가 "켜짐"으로 설정된 경우에만 버튼으로 문을 열 수 있습니다.

## 작업

항목이 수행할 수 있는 작업은 **작업** 구성요소에 나열됩니다. 각 스마트 항목에는 미리 정의된 작업이 포함되어 있습니다. 기존 작업을 맞춤 설정하거나 새 작업을 추가할 수 있습니다. 다음 유형의 작업을 사용할 수 있습니다.

* **애니메이션 재생**: 항목의 3D 모델에서 애니메이션을 재생합니다. 자세한 내용은 [애니메이션 재생 정보](#about-playing-animations)
* **애니메이션 중지**: 항목의 3D 모델에서 재생 중인 모든 애니메이션을 중지합니다.
* **사운드 재생**: 항목의 위치에서 파일의 사운드를 재생합니다. 자세한 내용은 [사운드 재생 정보](#about-playing-sounds)
* **사운드 중지**: 항목에서 재생 중인 모든 사운드를 중지합니다.
* **트윈 시작**: 지정된 시간 동안 위치, 회전 또는 크기를 점진적으로 변경합니다. 자세한 내용은 [이동, 회전 또는 크기 조정](#moving-rotating-or-scaling).
* **표시 여부 설정**: 항목을 표시하거나 숨깁니다.
* **플레이어에 연결**: 항목을 플레이어 아바타의 자식으로 설정합니다. 예를 들어 손에 들거나 머리 위에 올려놓을 수 있습니다.
* **플레이어에서 분리**: 플레이어 아바타에서 항목을 분리합니다.
* **링크 열기**: 브라우저 탭에서 외부 웹사이트 링크를 엽니다. 링크를 열기 전에 플레이어에게 해당 도메인을 신뢰하는지 묻습니다.

{% hint style="info" %}
**📔 참고**: 이 작업은 항목을 클릭한 결과로만 실행할 수 있습니다. 트리거 영역에 들어가는 동작으로는 트리거할 수 없습니다.
{% endhint %}

* **플레이어 이동**: 플레이어의 위치를 씬 내의 지정된 로컬 좌표로 변경합니다. 플레이어는 같은 씬 안에서만 이동할 수 있습니다.
* **플레이어 순간 이동**: 플레이어를 Decentraland의 다른 위치로 순간 이동시킵니다. 다음을 사용하세요. **순간 이동 모드** 드롭다운에서 플레이어를 다음 위치로 보낼 수 있습니다. **좌표로** Genesis City의 다른 씬 좌표를 지정하거나, **월드로**, 월드 이름을 지정합니다. 플레이어는 목적지 씬의 생성 지점에 나타납니다.
* **이모트 재생**: 플레이어 아바타가 기본 아바타 애니메이션(예: 손 흔들기 또는 박수)을 수행하게 합니다.
* **사용자 지정 이모트 재생**: 씬에 업로드한 파일의 사용자 지정 애니메이션을 플레이어 아바타가 수행하게 합니다.
* **텍스트 표시**: 화면 UI에 텍스트를 표시하고 몇 초 후 숨깁니다. 힌트, 대화, 알림 등에 적합합니다.
* **텍스트 숨기기**: 현재 표시 중인 UI 텍스트를 숨깁니다.
* **지연 시작**: 필요한 시간(초)만큼 같은 항목의 다른 동작을 지연합니다.
* **지연 중지**: 항목에 예약된 지연 동작을 모두 취소합니다.
* **반복 시작**: 지정한 간격으로 같은 항목의 동작을 반복 실행합니다.
* **반복 중지**: 항목의 반복 동작을 모두 취소합니다.
* **동영상 재생**: 기본 도형의 머티리얼로 동영상을 재생합니다.
* **동영상 중지**: 현재 재생 중인 동영상을 모두 중지합니다.
* **오디오 스트림 재생**: 오디오 스트림을 재생합니다.
* **오디오 스트림 중지**: 현재 재생 중인 오디오 스트림을 모두 중지합니다.
* **복제**: 지정된 위치에 항목의 복사본을 만듭니다.
* **엔터티 생성**: 동작을 수행하는 항목을 기준으로 한 위치에 씬의 항목 복사본을 새로 만듭니다. 생성할 항목은 씬에 배치되어 있지 않아도 됩니다. 자세한 내용은 다음을 참조하세요. [엔터티 생성에 관하여](#about-spawning-entities).
* **제거**: 씬에서 항목을 삭제합니다.
* **이미지 표시**: UI에 이미지를 표시하며, 표시 시간을 제한할 수도 있습니다. 캡션을 포함할 수도 있습니다.
* **이미지 숨기기**: 이미지 표시 동작으로 UI에 표시된 이미지를 숨깁니다.
* **피해**: 주변에 있는 체력 바의 체력을 감소시킵니다.  *레이어*  속성으로 플레이어의 체력 바에만 적용할지, 다른 항목의 체력 바에도 적용할지 정할 수 있습니다.
* **플레이어를 여기로 이동**: 플레이어의 위치를 이 항목의 위치로 변경합니다.
* **플레이어 위치에 배치**: 항목의 위치를 플레이어의 위치로 변경합니다.
* **플레이어 방향으로 회전**: 항목의 회전을 플레이어의 회전과 같게 변경합니다.
* **카메라 위치에 배치**: 항목의 위치를 카메라의 위치로 변경합니다.
* **카메라 방향으로 회전**: 항목의 회전을 카메라의 회전과 같게 변경합니다.
* **위치 설정**: 항목의 위치를 지정한 값으로 변경합니다. 절대 위치로 설정하거나 현재 위치를 기준으로 설정할 수 있습니다.
* **회전 설정**: 항목의 회전을 지정한 값으로 변경합니다. 절대 회전으로 설정하거나 현재 회전을 기준으로 설정할 수 있습니다.
* **크기 설정**: 아이템의 크기를 지정한 값으로 변경합니다. 절대값으로 지정하거나 현재 크기를 기준으로 상대값으로 지정할 수 있습니다.
* **플레이어 따라가기**: 플레이어의 위치를 향해 이동하고 방향을 바꾸기 시작합니다. 이동 경로의 장애물은 무시합니다. 속도를 설정하고 특정 축으로만 이동하도록 할 수 있습니다. 최소 거리는 플레이어에게 얼마나 가까이 다가갈지 결정합니다.
* **플레이어 따라가기 중지**: 플레이어 따라가기 동작을 중지합니다.
* **무작위 동작**: 여기에 나열된 동작 중 하나를 무작위 동작이 호출될 때마다 같은 확률로 실행합니다. 해당 아이템에 속하는 동작이라면 무엇이든 나열할 수 있습니다.
* **일괄 동작**: 여기에 나열된 모든 동작을 일괄 동작이 호출될 때마다 동시에 실행합니다. 해당 아이템에 속하는 동작이라면 무엇이든 나열할 수 있습니다.
* **플레이어 치유**: 플레이어의 체력 막대를 회복합니다.
* **플레이어가 아이템을 바라보게 하기**: 플레이어 아바타가 아이템을 바라보도록 방향을 바꿉니다.
* **플레이어 동결**: 플레이어가 이동하거나 점프하거나 감정 표현을 실행하지 못하게 합니다.
* **플레이어 동결 해제**: 플레이어 동결 동작 후 플레이어의 이동 능력을 복구합니다.
* **조명 켜기**: 아이템의 **Light Source** 구성 요소를 켭니다.
* **조명 끄기**: 아이템의 **Light Source** 구성 요소를 끕니다.
* **조명 수정**: 아이템의 **Light Source** 구성 요소 속성(예: 색상이나 강도)을 변경합니다.
* **카메라 선택**: 플레이어의 시점을 다음으로 전환합니다. **Virtual Camera**. 이 카메라는 이 아이템 또는 다른 엔터티에 있을 수 있습니다.
* **텍스트 변경**: **Text Shape** 구성 요소가 있는 아이템의 텍스트를 변경합니다. 글꼴 크기와 색상도 변경할 수 있습니다.
* **트윈 중지**: 현재 진행 중인 아이템의 트윈 이동을 모두 중지합니다.
* **텍스처 이동**: 아이템 머티리얼의 텍스처를 지정한 방향으로 계속 이동시켜 흐르는 물이나 컨베이어 벨트 같은 효과를 만듭니다.
* **충돌 설정 변경**: 물리 효과와 포인터 이벤트 모두에 대해 아이템의 충돌체를 활성화하거나 비활성화합니다.
* **스카이박스 변경**: 장면의 스카이박스를 자정 이후 경과한 초로 표시되는 특정 시각으로 변경합니다.
* **스카이박스 초기화**: 장면의 스카이박스를 기본 설정으로 복원합니다.
* **콘솔에 기록**: 장면을 개발하는 동안 디버깅에 유용하도록 콘솔에 메시지를 출력합니다.
* **삭제**: 씬에서 해당 항목과 모든 하위 항목을 제거합니다.

참조 [상태 및 조건부 로직](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/states-and-conditions.md) 에서 다음과 같이 로직 조건과 관련된 다른 작업을 알아보세요. **상태 설정** 및 카운터 작업을 참조하세요.

The **작업**  구성 요소는 가능한 작업을 정의하지만, 트리거되지 않으면 씬에서 아무 동작도 하지 않습니다. 작업은 다음에 의해 활성화됩니다. [트리거](#triggers), 같은 스마트 아이템에서 가져오거나 다른 스마트 아이템에서 가져올 수 있습니다.

아이템에 새 액션을 추가하려면 **새 액션 추가** 버튼을 액션 컴포넌트 하단에서 클릭합니다. 그런 다음 액션의 이름을 지정하고 유형을 선택한 후 해당 액션 유형에 필요한 추가 필드를 입력합니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-9e9472ac259c8fabec7c63bf7d5836ed287923c2%2Fnew-action.webp?alt=media)

### 트리거

이 **트리거** 컴포넌트는 특정 이벤트가 발생할 때 액션을 활성화하는 트리거 이벤트를 정의합니다. 트리거 이벤트에는 다음과 같은 유형이 있습니다.

* **클릭 시**: 플레이어가 아이템을 클릭할 때 발생합니다. 자세한 내용은 다음을 참조하세요. [클릭 트리거 정보](#about-click-triggers)
* **입력 동작 시**: 플레이어가 아이템을 가리킨 상태에서 입력 버튼을 누를 때입니다.
* **전역 클릭 시**: 플레이어가 아이템을 가리킬 필요 없이 포인터의 어느 곳이든 클릭할 때입니다.
* **전역 기본 동작 시**: 플레이어가 어디에서든 기본 동작(E) 버튼을 누를 때입니다.
* **전역 보조 동작 시**: 플레이어가 어디에서든 보조 동작(F) 버튼을 누를 때입니다.
* **플레이어가 영역에 진입**: 플레이어가 영역에 들어올 때입니다. 자세한 내용은 [영역 트리거](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/trigger-area.md)
* **플레이어가 영역을 떠남**: 플레이어가 영역을 떠날 때입니다. 자세한 내용은 [영역 트리거](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/trigger-area.md)
* **생성 시**: 장면이 시작되거나 항목이 장면에 생성될 때입니다. 자세한 내용은 [생성 시 트리거](#trigger-on-spawn)
* **지연 후**: 다음과 같은 경우 **시작 지연** 항목의 액션이 카운트다운을 마치면.
* **루프마다**: 다음의 반복이 실행될 때마다: **루프 시작** 항목의 액션.
* **복제 시**: 다음을 통해 항목을 복제하면: **복제** 액션을 실행하면 새 복사본이 이 트리거를 발생시킵니다.
* **이미지 클릭 시**: 플레이어가 다음에 의해 표시된 이미지를 클릭하면 **이미지 표시** 액션.
* **피해를 받을 때**: 아이템이 다음으로부터 피해를 받으면 **피해** 액션.
* **플레이어 치유 시**: 플레이어가 다음에 의해 치유되면 **플레이어 회복** 액션입니다.
* **틱마다**: 씬의 매 틱, 즉 프레임마다 한 번 실행됩니다. 이 동작으로 트리거되는 작업은 매우 자주 실행되므로 주의해서 사용하세요.

자세한 내용은  [상태 및 조건부 로직](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/states-and-conditions.md) 을 참조하여 다음과 같이 로직 조건과 관련된 다른 트리거를 알아보세요. **상태 변경 시**, **카운터 변경 시** 및 **트윈 종료 시**.

새 트리거를 추가하려면 다음을 클릭하세요. **새 트리거 이벤트 추가** Trigger 컴포넌트 하단에서 트리거 유형, 활성화할 엔티티, 해당 엔티티의 동작을 선택하세요.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-daae47bcc6247ff825168d5845a00619ccc41a22%2Fnew-trigger.webp?alt=media)

{% hint style="info" %}
**📔 참고**: 트리거를 실행하려면 먼저 해당 엔티티의 [Actions](#actions) 컴포넌트에 동작을 정의해야 합니다. 트리거는 Actions 컴포넌트가 있는 엔티티에만 영향을 줄 수 있습니다.
{% endhint %}

## 애니메이션 재생에 관해

다음 유형의 동작을 사용하세요. **애니메이션 재생** 을 선택하면 스마트 아이템의 3D 모델에서 애니메이션을 실행할 수 있습니다. 애니메이션은 3D 모델 파일에 이미 포함되어 있어야 합니다.  **애니메이션 선택**  드롭다운에는 3D 모델에서 사용할 수 있는 모든 애니메이션이 표시됩니다.

애니메이션의  **재생 모드**  필드에서는 애니메이션을 한 번만 재생할지, 계속 반복할지 선택할 수 있습니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c7abc86eb1816aa1e974d0ce2b5335c04ce55818%2Fplay-animation.webp?alt=media)

액션을 생성한 후에는 동일한 아이템이나 다른 아이템의  [트리거](#triggers)  컴포넌트를 통해 해당 액션을 활성화할 수 있습니다.

다음을 사용해 **애니메이션 중지** 동작으로 항목의 반복 및 비반복 애니메이션을 모두 중지할 수 있습니다.

{% hint style="info" %}
**💡 팁**: 3D 모델의 내용을 쉽게 확인하고, 어떤 애니메이션이 포함되어 있는지와 어떻게 보이는지 살펴보려면 다음 도구를 사용하면 좋습니다. [Babylon Sandbox](https://sandbox.babylonjs.com/). 3D 모델 파일을 창에 끌어다 놓기만 하면 됩니다. 하단에 애니메이션 목록이 있는 드롭다운이 표시됩니다.
{% endhint %}

애니메이션과 3D 모델의 일부로 애니메이션을 직접 만드는 방법에 대해 자세히 알아보려면 [애니메이션](https://docs.decentraland.org/creator/content-creator-ko/3d/animations.md).

## 사운드 재생 정보

다음 유형의 액션을 사용하세요: **Play Sound** 를 사용하면 사운드 파일을 재생할 수 있습니다. 장면 프로젝트로 가져온 파일이라면 어떤 사운드 파일이든 재생할 수 있습니다. 사운드는 아이템이 있는 위치에서 들리므로, 플레이어가 가까이 있을수록 더 크게 들립니다.

{% hint style="info" %}
**💡 팁**: 사운드 파일 경로를 직접 입력하는 대신, Scene Editor 하단의 파일 탐색 메뉴에서 파일을 **경로** 필드로 드래그할 수 있습니다.
{% endhint %}

사운드를 한 번만 재생할지, 계속 반복 재생할지 선택하려면 **재생 모드** 필드를 사용하세요.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-b68563c714883d68aaa32761fa72d3c58e17e2aa%2Fplay-sound.webp?alt=media)

액션을 생성한 후에는 동일한 아이템이나 다른 아이템의  [트리거](#triggers)  컴포넌트를 통해 해당 액션을 활성화할 수 있습니다.

아이템에서 반복 재생 중인 사운드와 반복 재생이 아닌 사운드를 모두 중지하려면 **Stop Sound** 액션을 사용하세요. 이 액션은 **AudioSource** 컴포넌트에서 재생 중인 사운드도 중지합니다.

예를 들어 분위기 효과음이나 음악처럼 아이템에서 사운드를 계속 반복 재생하려면 Actions와 Triggers를 사용하는 것보다 **AudioSource** 컴포넌트를 사용하는 편이 더 간편합니다. 이 컴포넌트에서는 파일 경로를 지정하고 다음 항목을 선택하기만 하면 됩니다: **재생 시작** 및 **반복**.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-8bc2b88cbd78240c40491ac5b8b768e014b0ad7d%2Faudiosource.webp?alt=media)

{% hint style="info" %}
**📔 참고**: 스마트 아이템은 한 번에 하나의 사운드만 재생할 수 있습니다. 두 번째 사운드를 재생하면 현재 재생 중인 다른 사운드가 모두 중단됩니다. 이는 **AudioSource** 컴포넌트의 사운드에도 적용됩니다. 두 사운드를 동시에 재생해야 한다면, 같은 위치에 보이지 않는 엔티티를 추가하고 여기에 **Play Sound** 액션을 설정해 보세요.
{% endhint %}

Decentraland에서 사운드를 재생하는 방법에 대한 자세한 내용은 [사운드](https://docs.decentraland.org/creator/content-creator-ko/sdk7/3d/sounds.md) 를 참조하세요.

## 이동, 회전 또는 크기 조정

아이템의 **Start Tween** 액션을 사용하면 일정 시간에 걸쳐 아이템의 **위치**, **크기**또는 **회전**을 변경할 수 있습니다. 모든 트윈 **Start Tween** 액션은 아이템의 원래 상태에서 시작해 일정 시간에 걸쳐 끝 상태로 변경합니다.

위치 트윈은 상대값 또는 절대값으로 설정할 수 있습니다. 절대 위치 트윈은 장면을 기준으로 아이템을 고정된 위치로 이동합니다. 아이템은 현재 위치에서 지정된 위치로 이동하며, 이미 그 위치에 있다면 움직이는 것처럼 보이지 않습니다. 상대 위치 트윈은 현재 위치에서 일정 거리만큼 아이템을 이동합니다. 예를 들어 상대 위치를 `1, 0, 0` 로 설정하면 아이템이 현재 바라보는 방향으로 1미터 앞으로 이동합니다. 트윈 액션을 두 번째로 실행하면 아이템은 다시 1미터 앞으로 이동합니다.

회전 트윈도 상대값 또는 절대값으로 설정할 수 있습니다. 상대 회전은 아이템의 현재 회전에 더해집니다. 절대 회전 트윈은 장면을 기준으로 아이템이 특정 방향을 향하게 합니다.

전체 이동에 걸리는 시간(초)을 설정하려면 **Duration** 필드를 사용하세요. 슬라이더는 최대 100초까지 설정할 수 있지만, 더 긴 시간이 필요하면 직접 큰 숫자를 입력할 수도 있습니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-722be741f04505c23cc8e2081e1675a166e13ec0%2Ftweens.webp?alt=media)

액션을 생성한 후에는 동일한 아이템이나 다른 아이템의  [트리거](#triggers)  컴포넌트를 통해 해당 액션을 활성화할 수 있습니다.

트윈에는 시간에 따른 변화율에 영향을 주는 다양한 **곡선 유형** 을 사용할 수 있습니다.  **선형** curve(기본값)는 시작부터 끝까지 변화 속도가 일정하다는 뜻입니다. 선택할 수 있는 옵션이 다양하며, 시작 부분이나 끝 부분(또는 둘 다)이 얼마나 느리게 시작하는지에 따라 서로 다른 모양의 곡선을 그립니다. 예를 들어 **easeinexpo** 곡선은 느리게 시작해 빠르게 끝나며, 속도가 기하급수적으로 증가합니다. 반대로 **easeoutexpo** 곡선은 빠르게 시작해 느리게 끝납니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-df967c421ebe6616c2a25a566fef8baa2ed10597%2Feasing-functions.webp?alt=media)

{% hint style="info" %}
**💡 팁**: 다양한 움직임 곡선을 사용해 보세요. 차이는 미묘한 경우가 많지만, 우리는 사물이 움직이는 방식에서 무게감, 마찰, 심지어 개성까지 무의식적으로 파악합니다.
{% endhint %}

트윈이 끝난 후 동작을 실행하려면 **트윈 종료 시** 이벤트를 **트리거** 컴포넌트에서 사용하세요. 떠 있는 플랫폼이 두 위치 사이를 계속 오가도록 반복 경로를 지정하려면 [상태와 조건부 로직](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/states-and-conditions.md) 을 사용하세요.

항목이 트윈을 수행하면 항목의 모든 요소에 영향을 줍니다. 예를 들어 크기가 변경되면 눈에 보이는 3D 모델뿐 아니라 보이지 않는 충돌체 형상과 텍스트 크기 등도 함께 바뀝니다. 항목에 자식 항목(왼쪽의 엔티티 트리에서 중첩된 항목)이 있으면 해당 자식 엔티티도 트윈의 영향을 받습니다.

{% hint style="info" %}
**📔 참고**: 각 엔티티는 한 번에 하나의 트윈만 수행할 수 있습니다. 예를 들어 항목을 옆으로 이동하면서 동시에 회전시킬 수는 없습니다. 해결 방법으로 부모 엔티티를 사용할 수 있습니다. 예를 들어, 옆으로 이동하는 보이지 않는 부모 엔티티와 회전하는 자식 엔티티를 만들 수 있습니다.
{% endhint %}

## 엔티티 생성에 관하여

씬이 실행되는 동안 항목의 새 복사본을 만들려면 **엔티티 생성** 액션을 사용하세요. 이 액션은 **복제** 액션과 달리 항목을 미리 씬에 배치하지 않아도 생성할 수 있습니다.

### 항목을 생성 가능하게 만들기

항목을 생성하려면 먼저 프로젝트 파일에서 사용할 수 있어야 합니다. 씬에 배치하지 않고 항목을 추가하려면 다음을 수행하세요.

1. 패널에서 **에셋** 카탈로그 또는 **사용자 지정 항목**.
2. 에서 항목을 찾은 다음, 해당 항목을 마우스 오른쪽 버튼으로 클릭하고 **파일 시스템에 추가**.

를 선택하세요. 이렇게 하면 항목이 프로젝트에 복사되어 나중에 생성할 수 있습니다. 씬에는 보이는 항목이 추가되지 않습니다. 그러면 해당 항목이 모든 **소스** 드롭다운에 표시됩니다. 이 드롭다운은 **엔티티 생성** 액션에서 사용할 수 있습니다.

### 액션 구성하기

각 **엔티티 생성** 액션에는 다음 두 필드가 있습니다.

* **소스**: 생성할 항목입니다. 프로젝트 파일에 추가된 항목 중에서 선택하세요.
* **위치**: 새 복사본이 표시될 X, Y, Z 좌표입니다. 액션을 수행하는 항목을 기준으로 합니다.

생성하는 항목 자체가 스마트 항목이면, 생성된 각 복사본은 자체 액션과 트리거를 서로 독립적으로 유지합니다.

{% hint style="info" %}
**💡 팁**: 대신 코드에서 항목을 생성하려면 [컴포지트](https://docs.decentraland.org/creator/content-creator-ko/sdk7/architecture/composites.md)를 참고하세요. 프로젝트 파일에 추가된 항목은 컴포지트로 저장되며, SDK의 생성 함수에서도 같은 형식을 사용합니다.
{% endhint %}

## 클릭 트리거에 관하여

항목을 클릭하여 동작을 트리거하려면 **On Click** 트리거를 만드세요. 플레이어가 엔티티를 클릭할 때마다 동작이 활성화됩니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5b8e97937e37b036049a84c9a0eaaa7e0c21fdd0%2Fon_click.webp?alt=media)

자세한 내용은 [모든 항목을 스마트하게 만들기](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/make-any-item-smart.md#interactivity) 를 참조하세요.

{% hint style="info" %}
**📔 참고**: 커스텀 3D 모델을 사용할 때 클릭할 수 있게 하려면 모델에 보이지 않는 콜라이더 형상이 있어야 합니다. 자세한 내용은 [콜라이더](https://docs.decentraland.org/creator/content-creator-ko/sdk7/3d/colliders.md#pointer-blocking).

대신 항목의 **GLTF** 컴포넌트를 구성하여 **Visible Layer** 충돌 레이어를 **Pointer**.

또 다른 방법은 **Click Area** 스마트 항목을 추가하여 클릭하려는 항목과 겹치는 큐브를 그리는 것입니다. Click Area 스마트 항목은 [보이지 않는 항목](#invisible-items).
{% endhint %}

## 생성 시 트리거

유형이 **On Spawn** 인 트리거는 씬이 로드될 때 동작을 활성화합니다. 플레이어가 항목과 상호작용할 때까지 기다리는 대신 동작이 즉시 실행됩니다.

예를 들어 플랫폼을 계속 움직이게 할 때 사용할 수 있습니다. **On Spawn** 트리거를 사용해 트윈 동작을 활성화하세요. 그런 다음 **On State Change** 트리거를 사용해 두 개 이상의 위치 사이에서 계속 움직이게 하세요.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-80691ad3f7a654f986fe7c7c1a14b9e004c9dbe8%2Fon_spawn.webp?alt=media)

## 멀티플레이어

모든 스마트 항목은 기본적으로 멀티플레이어를 지원합니다. 자세한 내용은 [스마트 항목 - 기본](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/smart-items.md) 을 참조하세요.

항목의 특정 컴포넌트만 동기화하도록 멀티플레이어 동작을 변경하거나 세부 조정할 수 있습니다.

항목의 **Multiplayer** 컴포넌트에서 공유하려는 컴포넌트의 확인란을 선택하세요.

예를 들어 문은 `Animator` 를 공유하여 모든 플레이어가 문이 열리는 애니메이션을 볼 수 있게 하고, `AudioSource` 를 공유하여 모두 소리를 들을 수 있게 하며, `State` 를 공유하여 현재 문이 열렸는지 닫혔는지 모두가 알 수 있게 합니다. 문은 일반적으로 항상 보이므로 `Visibility` 컴포넌트는 공유하지 않습니다. 문을 표시하거나 숨기는 동작을 포함하는 경우, 모든 플레이어 간에 변경 사항이 동기화되도록 이 컴포넌트도 선택하는 것이 좋습니다.

## 보이지 않는 항목

일부 항목은 플레이어에게 보이지 않도록 설계되었지만, 관리하기 쉽도록 씬을 편집하는 동안에는 표시됩니다. 이러한 항목의 예로는 **Ambience**, **Trigger Area**, **Click Area**등

고급 모드에서는 이러한 항목의 **표시 여부** 구성 요소가 보이지 않음으로 설정됩니다. 이 구성 요소는 장면 편집기에서 항목의 표시 여부에 영향을 주지 않지만, 보이지 않음으로 설정된 항목은 미리보기를 실행할 때 플레이어에게 표시되지 않습니다.

## 관련 항목

* [스마트 항목 - 기본](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/smart-items.md)
* [상태 및 조건](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/states-and-conditions.md)
* [모든 항목을 스마트하게 만들기](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/make-any-item-smart.md)
* [코드와 결합하기](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/extend-with-code/overview.md)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/smart-items-advanced.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
