---
title: GameObject와 Component
slug: world-sdk-guide-kr/gameobject-component
docTags: 
createdAt: 2024-09-02T08:34:13.135Z
---

세상에서는 객체를 생성하거나 특정 구성 요소를 수정하거나 추가하는 것이 매우 일반적입니다.

ZEPETOScript는 Unity 스크립트에서 사용되는 것과 동일한 인터페이스를 지원합니다.

## GameObject 및 Component의 기본 예제

게임 객체를 생성하고 제거하기:

:::CodeblockTabs
GameObject

```typescript
// GameObject 생성
const tempObj = new GameObject();
const obj = Object.Instantiate(tempObj);
 
// GameObject 파괴
Object.Destroy(obj);
```
:::

GameObjects의 구성 요소를 가져오거나 새로 추가하려면 GetComponent 또는 AddComponent를 사용하세요.

:::CodeblockTabs
Component

```typescript
// 제네릭을 사용한 GetComponent
const myTransform = this.GetComponent<Transform>();
 
// 제네릭을 사용한 AddComponent
const animator = this.gameObject.AddComponent<Animator>();
```
:::



GameObject Component에 대한 전체 코드 예제를 확인하세요.

다음은 GameObject의 생성 및 속성 수정, 구성 요소 추가 및 파괴를 다루는 예제입니다.

:::CodeblockTabs
GameObjectSample

```typescript
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 객체를 찾고 반환합니다.<br />- 찾지 못하면 null을 반환합니다.                                          |
| GameObject.FindGameObjectWithTag()  | - 현재 씬에서 태그를 기반으로 활성 GameObject 객체를 찾고 반환합니다.<br />- 활성 객체 중에서 지정된 태그와 일치하는 첫 번째 객체를 찾고 반환하며, 찾지 못하면 null을 반환합니다. |
| GameObject.FindGameObjectsWithTag() | - 현재 씬에서 특정 태그를 가진 모든 활성 GameObject 객체를 찾아 배열로 반환합니다.<br />- 찾지 못하면 빈 배열을 반환합니다.                                  |

예를 들어, 씬을 다음과 같이 설정합니다:

- 여러 개의 3D 객체를 추가하고 모든 태그를 3D로 지정합니다.
- 스크립트를 붙일 빈 객체를 생성하고, 이름을 FindSample로 변경합니다.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-zzyzWZyF_39SRWiOi4pqT-20240904-102427.png)



:::CodeblockTabs
TypeScript

```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 성공");
        }
    }
}
```
:::



- FindSample 객체에 스크립트를 추가하면 검사기가 비어 있습니다.

::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-brkQtTPkzO4PVeCeTWY0C-20240904-102427.png" size="66" width="484" height="554" position="center" showCaption="false"}



- 재생 버튼을 눌러 실행하면 검사기 창에서 각 객체가 할당되었는지 확인할 수 있으며, 콘솔 창을 통해 객체 찾기의 성공 여부를 확인할 수 있습니다.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-v0TXlzool-ExIjeoQtL2q-20240904-102427.png)

## 프리팹 만들기

런타임 동안 프리팹을 만드는 방법을 탐색해 보겠습니다.

- 먼저, 3D 오브젝트 > 큐브를 씬에 추가합니다.

::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-n8sQHSZS0g09ODQKdPMFn-20240904-102428.png" size="50" width="592" height="742" position="center" showCaption="false"}



- 큐브의 인스펙터에서 구성 요소 추가를 누르고 Rigidbody를 추가합니다.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-uQQEDtu2B7HHrZZa09X1K-20240904-102428.png)



- 그런 다음 큐브를 프로젝트 영역으로 드래그하여 프리팹으로 만듭니다.

::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-mzQZpGo5GJ00sZShBiWbC-20240904-102428.png" size="88" width="367" height="397" position="center" showCaption="false"}



- 프리팹을 사용할 것이므로 씬에서 큐브를 삭제합니다.



  ::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-YGeJYJrbHhKghMigpQObo-20240904-102428.png" size="62" width="326" height="327" position="center" showCaption="false"}

- 아래 스크립트를 작성해 주세요.

:::CodeblockTabs
TypeScript

```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);
        }
    }
}

```
:::

- 그런 다음 Unity 편집기로 돌아가서 프리팹을 스크립트 검사기로 드래그하여 추가합니다.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-ZwlrtxyGBbAFEh2eKJeg--20240904-102428.png)



- 재생 버튼을 눌러 3D 객체가 생성되고 매초 위에서 떨어지는지 확인합니다.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-WsJD59NBM4Q9x0R_24yiH-20240904-102428.gif)

아래 링크를 클릭하여 ZEPETOScript에서 제공하는 Unity GameObjects 및 Components에 대해 자세히 알아보세요.



:::hint{type="info"}
**📘 GameObjects 생성하기**
[https://docs.unity3d.com/2020.3/Documentation/ScriptReference/Object.Instantiate.html](https://docs.unity3d.com/2020.3/Documentation/ScriptReference/Object.Instantiate.html)
:::

:::hint{type="info"}
**📘 GameObjects 파괴하기**
[https://docs.unity3d.com/2020.3/Documentation/ScriptReference/Object.Destroy.html](https://docs.unity3d.com/2020.3/Documentation/ScriptReference/Object.Destroy.html)
:::

:::hint{type="info"}
**📘 컴포넌트 사용하기**
[https://docs.unity3d.com/kr/current/Manual/UsingComponents.html](https://docs.unity3d.com/kr/current/Manual/UsingComponents.html)
:::