Action 컴포넌트

스크립트를 연결하고 실행하는 컴포넌트입니다.

개요

Action 컴포넌트는 스크립트 파일을 오브젝트에 연결하여 코드 로직을 실행할 수 있게 해주는 컴포넌트입니다.

주요 속성

Script Path

연결할 스크립트 파일의 경로를 지정합니다.

Script Path: 스크립트 파일 경로
파일 브라우저 버튼을 클릭하여 파일 선택

Class Name

스크립트 파일 내의 클래스 이름을 지정합니다.

Class Name: 클래스 이름
스크립트 파일에 정의된 클래스 이름과 일치해야 합니다

스크립트 작성

Action 컴포넌트에 연결할 스크립트는 다음과 같은 구조를 가져야 합니다:

export class MyScript {
  // 초기화 (컴포넌트가 시작될 때 호출)
  start() {
    // 초기화 코드
  }

  // 업데이트 (매 프레임 호출)
  update(deltaTime: number) {
    // 업데이트 코드
  }

  // 정리 (컴포넌트가 제거될 때 호출)
  destroy() {
    // 정리 코드
  }
}

사용 예시

Action 컴포넌트 추가

Hierarchy 패널에서 오브젝트 선택
Inspector 패널에서 "Add Component" > "Action" 선택
Script Path 설정
Class Name 입력
스크립트가 연결되고 실행됩니다

스크립트 작성 예시

// MyScript.ts
export class MyScript {
  start() {
    console.log("스크립트 시작");
  }

  update(deltaTime: number) {
    // 매 프레임 실행되는 코드
    // deltaTime: 이전 프레임과의 시간 차이 (초)
  }
}

스크립트 API

스크립트 내에서 사용할 수 있는 주요 API:

this.transform: Transform 컴포넌트 접근
this.gameObject: 게임 오브젝트 접근
this.getComponent(): 다른 컴포넌트 가져오기
GCContext: 씬 컨텍스트 접근

다음 단계

스크립트 에디터 개요: 스크립트 에디터 사용하기
Collider 컴포넌트: 충돌 감지 사용하기

개요​

주요 속성​

Script Path​

Class Name​

스크립트 작성​

사용 예시​

Action 컴포넌트 추가​

스크립트 작성 예시​

스크립트 API​

다음 단계​

개요