Singleton을 어떻게 사용하나요?

6min
싱글턴은 프로그램 내에서 특정 클래스의 인스턴스가 하나만 존재하도록 보장하는 디자인 패턴입니다.
싱글턴 패턴은 클래스의 단일 전역 인스턴스를 제공하여, 논리 관리, 오디오, UI 및 월드 내 중앙 집중식 리소스와 같은 필요에 따라 다른 스크립트에서 쉽게 접근할 수 있도록 합니다.
ZEPETOScript에서 싱글턴을 다음과 같이 구현할 수 있습니다:
TypeScript
private static _instance: ClassName = null;

public static get Instance(): ClassName {
	if (this._instance == null) {
		this._instance = GameObject.FindObjectOfType<ClassName>();
	}
	return this._instance;
}
private static _instance: ClassName = null;

public static get Instance(): ClassName {
	if (this._instance == null) {
		this._instance = GameObject.FindObjectOfType<ClassName>();
	}
	return this._instance;
}
﻿
👍 팁
씬에 싱글턴 스크립트가 붙어 있는 GameObject가 이미 있다면, 이 형식을 사용할 수 있습니다.
없다면, GameObject를 생성하는 코드를 추가하세요.
예: new GameObject("ObjectName").AddComponent<ClassName>();
UI 관리를 위한 싱글턴을 예제로 구현해 보겠습니다:
1) 씬에 UI > 텍스트 및 버튼을 추가하세요.
"IncreaseScore" 버튼이 눌릴 때 점수를 증가시키는 로직을 설정하세요.
"DecreaseScore" 버튼이 눌릴 때 점수를 감소시키는 로직을 설정하세요.
﻿
﻿
2) "ScoreManager"라는 스크립트를 생성하여 Singleton을 적용합니다.
ScoreManager 스크립트는 점수를 증가/감소시키고 다른 스크립트에서 호출될 때 Text를 업데이트하는 역할을 합니다.
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GameObject } from 'UnityEngine';
import { Text } from 'UnityEngine.UI';
 
export default class ScoreManager extends ZepetoScriptBehaviour {
 
    // Singleton 선언
    private static _instance: ScoreManager = null;
 
    public static get Instance(): ScoreManager {
        if (this._instance == null) {
            this._instance = GameObject.FindObjectOfType<ScoreManager>();
        }
 
        return this._instance;
    }
 
    // 변수 선언
    public scoreText: Text;
    private _currentScore : number;
 
    Start() {   
        // 테스트를 위해 초기 점수를 0으로 설정
        this._currentScore = 0;
    }
 
    // 다른 스크립트에서 IncreaseScore를 호출할 수 있습니다.
    public IncreaseScore(amount: number) {
        this._currentScore += amount;
        this.scoreText.text = `점수 : ${this._currentScore}`;
    }
 
    // 다른 스크립트에서 DecreaseScore를 호출할 수 있습니다.
    public DecreaseScore(amount: number) {
        this._currentScore -= amount;
        this.scoreText.text = `점수 : ${this._currentScore}`;
    }
 
}

import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GameObject } from 'UnityEngine';
import { Text } from 'UnityEngine.UI';
 
export default class ScoreManager extends ZepetoScriptBehaviour {
 
    // Singleton 선언
    private static _instance: ScoreManager = null;
 
    public static get Instance(): ScoreManager {
        if (this._instance == null) {
            this._instance = GameObject.FindObjectOfType<ScoreManager>();
        }
 
        return this._instance;
    }
 
    // 변수 선언
    public scoreText: Text;
    private _currentScore : number;
 
    Start() {   
        // 테스트를 위해 초기 점수를 0으로 설정
        this._currentScore = 0;
    }
 
    // 다른 스크립트에서 IncreaseScore를 호출할 수 있습니다.
    public IncreaseScore(amount: number) {
        this._currentScore += amount;
        this.scoreText.text = `점수 : ${this._currentScore}`;
    }
 
    // 다른 스크립트에서 DecreaseScore를 호출할 수 있습니다.
    public DecreaseScore(amount: number) {
        this._currentScore -= amount;
        this.scoreText.text = `점수 : ${this._currentScore}`;
    }
 
}
﻿
﻿
스크립트 설명
private static _instance: 이것은 클래스 내의 비공식 정적 변수로, 처음에는 null로 설정됩니다.
public static get Instance: 이 정적 속성은 외부 코드가 이 클래스의 고유 인스턴스에 접근할 수 있는 방법을 제공합니다.
확인 if (this.\_instance == null). null인 경우, GameObject.FindObjectOfType<>()를 사용하여 ClassName 유형의 구성 요소를 찾아 반환하고 이를 정적 변수에 할당합니다.
﻿
3) 스크립트를 작성한 후, 검사기로 돌아가서 텍스트 컴포넌트를 연결합니다.
﻿
﻿
4) 다음으로, Singleton을 호출하는 방법을 보여주기 위해 "ScoreLogicSample"이라는 스크립트를 만듭니다. ScoreManager와 ScoreLogicSample이 같은 디렉토리에 있는지 확인하세요.
﻿
이와 같이 코드를 작성하세요:
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GameObject } from 'UnityEngine';
import { Text, Button } from 'UnityEngine.UI';
// Singleton 스크립트 가져오기
import ScoreManager from './ScoreManager';
 
export default class ScoreLogicSample extends ZepetoScriptBehaviour {
 
    public increaseScoreButton: Button;
    public decreaseScoreButton: Button;
 
    // ScoreManager 타입의 변수 선언
    private ScoreManager : ScoreManager;
 
    Start() {   
 
        // ScoreManager를 변수에 할당
        this.ScoreManager = GameObject.FindObjectOfType<ScoreManager>();
 
        this.increaseScoreButton.onClick.AddListener(()=> {
            // Singleton에 선언된 함수 호출
            this.ScoreManager.IncreaseScore(10);
        });
 
        this.decreaseScoreButton.onClick.AddListener(()=> {
            // Singleton에 선언된 함수 호출
            this.ScoreManager.DecreaseScore(10);
        });
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GameObject } from 'UnityEngine';
import { Text, Button } from 'UnityEngine.UI';
// Singleton 스크립트 가져오기
import ScoreManager from './ScoreManager';
 
export default class ScoreLogicSample extends ZepetoScriptBehaviour {
 
    public increaseScoreButton: Button;
    public decreaseScoreButton: Button;
 
    // ScoreManager 타입의 변수 선언
    private ScoreManager : ScoreManager;
 
    Start() {   
 
        // ScoreManager를 변수에 할당
        this.ScoreManager = GameObject.FindObjectOfType<ScoreManager>();
 
        this.increaseScoreButton.onClick.AddListener(()=> {
            // Singleton에 선언된 함수 호출
            this.ScoreManager.IncreaseScore(10);
        });
 
        this.decreaseScoreButton.onClick.AddListener(()=> {
            // Singleton에 선언된 함수 호출
            this.ScoreManager.DecreaseScore(10);
        });
    }
}
﻿
﻿
싱글톤 스크립트를 가져올 때 경로를 올바르게 지정하는 것이 중요합니다.
필요에 따라 자신의 스크립트에서 ScoreManager가 호출되는 부분을 조정할 수 있습니다.
﻿
5) [▶︎(재생)] 버튼을 눌러 테스트합니다.
ScoreLogicSample에서 버튼을 클릭할 때 ScoreManager의 함수가 호출되는 것을 관찰해야 하며, 예상대로 작동합니다.
﻿
﻿
업데이트됨 11 Oct 2024
이 페이지가 도움이 되었습니까?
QR 테스트가 원활하지 않아요
VSCode 에디터로 ZEPETO 스크립트 사용 시 에러가 제대로 검출되지 않아요.