GameObject와 Component

13min
세상에서는 객체를 생성하거나 특정 구성 요소를 수정하거나 추가하는 것이 매우 일반적입니다.
ZEPETOScript는 Unity 스크립트에서 사용되는 것과 동일한 인터페이스를 지원합니다.
GameObject 및 Component의 기본 예제
게임 객체를 생성하고 제거하기:
GameObject
// GameObject 생성
const tempObj = new GameObject();
const obj = Object.Instantiate(tempObj);
 
// GameObject 파괴
Object.Destroy(obj);
// GameObject 생성
const tempObj = new GameObject();
const obj = Object.Instantiate(tempObj);
 
// GameObject 파괴
Object.Destroy(obj);
﻿
GameObjects의 구성 요소를 가져오거나 새로 추가하려면 GetComponent 또는 AddComponent를 사용하세요.
Component
// 제네릭을 사용한 GetComponent
const myTransform = this.GetComponent<Transform>();
 
// 제네릭을 사용한 AddComponent
const animator = this.gameObject.AddComponent<Animator>();
// 제네릭을 사용한 GetComponent
const myTransform = this.GetComponent<Transform>();
 
// 제네릭을 사용한 AddComponent
const animator = this.gameObject.AddComponent<Animator>();
﻿
﻿
GameObject Component에 대한 전체 코드 예제를 확인하세요.
다음은 GameObject의 생성 및 속성 수정, 구성 요소 추가 및 파괴를 다루는 예제입니다.
GameObjectSample
import { GameObject, Object, Transform, Animator, Vector3, WaitForSeconds } from 'UnityEngine';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
 
export default class GameObjectSample extends ZepetoScriptBehaviour {
 
    private _testObject : GameObject;
 
    Start() {
 
        // 빈 GameObject 생성
        const tempObj = new GameObject();
        this._testObject = Object.Instantiate(tempObj) as GameObject;
 
        // 객체의 이름 변경
        this._testObject.name = "TestObject";
 
        // 객체의 변환 정보 변경
        this._testObject.transform.position = new Vector3(3,3,3);
 
        // 객체에 구성 요소 추가
        this._testObject.gameObject.AddComponent<Animator>();
 
        // GetComponent 사용 예
        const animator = this._testObject.GetComponent<Animator>();
        if(animator != null) {
            console.log("GetComponent 성공");
        }
 
        // 코루틴을 사용하여 5초 후 객체 파괴
        this.StartCoroutine(this.DestroyObject());
 
    }
 
    *DestroyObject() {
        yield new WaitForSeconds(5);
 
        // GameObject 파괴
        Object.Destroy(this._testObject);
    }
}  
import { GameObject, Object, Transform, Animator, Vector3, WaitForSeconds } from 'UnityEngine';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
 
export default class GameObjectSample extends ZepetoScriptBehaviour {
 
    private _testObject : GameObject;
 
    Start() {
 
        // 빈 GameObject 생성
        const tempObj = new GameObject();
        this._testObject = Object.Instantiate(tempObj) as GameObject;
 
        // 객체의 이름 변경
        this._testObject.name = "TestObject";
 
        // 객체의 변환 정보 변경
        this._testObject.transform.position = new Vector3(3,3,3);
 
        // 객체에 구성 요소 추가
        this._testObject.gameObject.AddComponent<Animator>();
 
        // GetComponent 사용 예
        const animator = this._testObject.GetComponent<Animator>();
        if(animator != null) {
            console.log("GetComponent 성공");
        }
 
        // 코루틴을 사용하여 5초 후 객체 파괴
        this.StartCoroutine(this.DestroyObject());
 
    }
 
    *DestroyObject() {
        yield new WaitForSeconds(5);
 
        // GameObject 파괴
        Object.Destroy(this._testObject);
    }
}  
﻿
﻿
Find 활용하기
Find 관련 메서드는 Unity 스크립트와 동일한 인터페이스 스타일을 ZEPETOScript에서도 지원합니다.
메서드
설명
GameObject.Find()
- 현재 씬에서 이름을 기반으로 활성 GameObject 객체를 찾고 반환합니다.
- 찾지 못하면 null을 반환합니다.
GameObject.FindGameObjectWithTag()
- 현재 씬에서 태그를 기반으로 활성 GameObject 객체를 찾고 반환합니다.
- 활성 객체 중에서 지정된 태그와 일치하는 첫 번째 객체를 찾고 반환하며, 찾지 못하면 null을 반환합니다.
GameObject.FindGameObjectsWithTag()
- 현재 씬에서 특정 태그를 가진 모든 활성 GameObject 객체를 찾아 배열로 반환합니다.
- 찾지 못하면 빈 배열을 반환합니다.
예를 들어, 씬을 다음과 같이 설정합니다:
여러 개의 3D 객체를 추가하고 모든 태그를 3D로 지정합니다.
스크립트를 붙일 빈 객체를 생성하고, 이름을 FindSample로 변경합니다.
﻿
﻿
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GameObject, Transform } from 'UnityEngine';

export default class FindSample extends ZepetoScriptBehaviour {

    public tempObj1: GameObject;
    public tempObj2: GameObject;
    public tempObj3: GameObject[];

    Start() {    
        // 지정된 이름을 가진 대상 GameObject를 찾습니다.
        // 동일한 이름을 가진 여러 GameObject가 있는 경우, 처음 발견된 것이 반환됩니다.
        this.tempObj1 = GameObject.Find("Cube");
        if(this.tempObj1 != null) {
            console.log("GameObject 찾기 성공");
        }
 
        // 지정된 태그를 가진 대상 GameObject를 찾습니다.
        // 동일한 태그를 가진 여러 GameObject가 있는 경우, 처음 발견된 것이 반환됩니다.
        this.tempObj2 = GameObject.FindGameObjectWithTag("3D");
        if(this.tempObj2 != null) {
            console.log("FindGameObjectWithTag 성공");
        }
 
        // 지정된 태그를 가진 GameObject의 배열을 반환합니다.
        this.tempObj3 = GameObject.FindGameObjectsWithTag("3D");
        if(this.tempObj3 != null) {
            console.log("FindGameObjectsWithTag 성공");
        }
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GameObject, Transform } from 'UnityEngine';

export default class FindSample extends ZepetoScriptBehaviour {

    public tempObj1: GameObject;
    public tempObj2: GameObject;
    public tempObj3: GameObject[];

    Start() {    
        // 지정된 이름을 가진 대상 GameObject를 찾습니다.
        // 동일한 이름을 가진 여러 GameObject가 있는 경우, 처음 발견된 것이 반환됩니다.
        this.tempObj1 = GameObject.Find("Cube");
        if(this.tempObj1 != null) {
            console.log("GameObject 찾기 성공");
        }
 
        // 지정된 태그를 가진 대상 GameObject를 찾습니다.
        // 동일한 태그를 가진 여러 GameObject가 있는 경우, 처음 발견된 것이 반환됩니다.
        this.tempObj2 = GameObject.FindGameObjectWithTag("3D");
        if(this.tempObj2 != null) {
            console.log("FindGameObjectWithTag 성공");
        }
 
        // 지정된 태그를 가진 GameObject의 배열을 반환합니다.
        this.tempObj3 = GameObject.FindGameObjectsWithTag("3D");
        if(this.tempObj3 != null) {
            console.log("FindGameObjectsWithTag 성공");
        }
    }
}
﻿
﻿
FindSample 객체에 스크립트를 추가하면 검사기가 비어 있습니다.
﻿
﻿
재생 버튼을 눌러 실행하면 검사기 창에서 각 객체가 할당되었는지 확인할 수 있으며, 콘솔 창을 통해 객체 찾기의 성공 여부를 확인할 수 있습니다.
﻿
프리팹 만들기
런타임 동안 프리팹을 만드는 방법을 탐색해 보겠습니다.
먼저, 3D 오브젝트 > 큐브를 씬에 추가합니다.
﻿
﻿
큐브의 인스펙터에서 구성 요소 추가를 누르고 Rigidbody를 추가합니다.
﻿
﻿
그런 다음 큐브를 프로젝트 영역으로 드래그하여 프리팹으로 만듭니다.
﻿
﻿
프리팹을 사용할 것이므로 씬에서 큐브를 삭제합니다.


﻿
﻿
아래 스크립트를 작성해 주세요.
TypeScript
import { GameObject, Object, Vector3, WaitForSeconds } from 'UnityEngine';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
 
export default class CloneSample extends ZepetoScriptBehaviour {
     
    public clonePrefab : GameObject;
 
    Start() {
 
        this.StartCoroutine(this.DoRoutine());
 
    }
 
    *DoRoutine() {
        while(true) {
            yield null;
            // Create a clone
            const clone = Object.Instantiate(this.clonePrefab) as GameObject;
             
            // Set the height of the clone object
            clone.transform.position = new Vector3(0, 10, 0);
             
            // Destroy it after 5 seconds of creation
            GameObject.Destroy(clone, 5);
            yield new WaitForSeconds(1);
        }
    }
}

import { GameObject, Object, Vector3, WaitForSeconds } from 'UnityEngine';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
 
export default class CloneSample extends ZepetoScriptBehaviour {
     
    public clonePrefab : GameObject;
 
    Start() {
 
        this.StartCoroutine(this.DoRoutine());
 
    }
 
    *DoRoutine() {
        while(true) {
            yield null;
            // Create a clone
            const clone = Object.Instantiate(this.clonePrefab) as GameObject;
             
            // Set the height of the clone object
            clone.transform.position = new Vector3(0, 10, 0);
             
            // Destroy it after 5 seconds of creation
            GameObject.Destroy(clone, 5);
            yield new WaitForSeconds(1);
        }
    }
}
﻿
그런 다음 Unity 편집기로 돌아가서 프리팹을 스크립트 검사기로 드래그하여 추가합니다.
﻿
﻿
재생 버튼을 눌러 3D 객체가 생성되고 매초 위에서 떨어지는지 확인합니다.
﻿
아래 링크를 클릭하여 ZEPETOScript에서 제공하는 Unity GameObjects 및 Components에 대해 자세히 알아보세요.
﻿
📘 GameObjects 생성하기
https://docs.unity3d.com/2020.3/Documentation/ScriptReference/Object.Instantiate.html﻿
📘 GameObjects 파괴하기
https://docs.unity3d.com/2020.3/Documentation/ScriptReference/Object.Destroy.html﻿
📘 컴포넌트 사용하기
https://docs.unity3d.com/kr/current/Manual/UsingComponents.html﻿
﻿
메서드	설명
GameObject.Find()	- 현재 씬에서 이름을 기반으로 활성 GameObject 객체를 찾고 반환합니다. - 찾지 못하면 null을 반환합니다.
GameObject.FindGameObjectWithTag()	- 현재 씬에서 태그를 기반으로 활성 GameObject 객체를 찾고 반환합니다. - 활성 객체 중에서 지정된 태그와 일치하는 첫 번째 객체를 찾고 반환하며, 찾지 못하면 null을 반환합니다.
GameObject.FindGameObjectsWithTag()	- 현재 씬에서 특정 태그를 가진 모든 활성 GameObject 객체를 찾아 배열로 반환합니다. - 찾지 못하면 빈 배열을 반환합니다.
업데이트됨 11 Oct 2024
이 페이지가 도움이 되었습니까?
Coroutine
UnityEvent