타이핑 시 이벤트 트리거

이벤트는 특정 텍스트 부분에 도달했을 때 타입라이터가 어떤 리스너 스크립트에 문자열 메시지를 보낼 수 있게 해주는 특수 태그입니다. (이런 이유로 이벤트는 타입라이터가 활성화된 경우에만 작동합니다)

장면 '예제 3 - 이벤트'

---

개요

리치 텍스트 태그를 사용하여 텍스트에 이벤트를 작성할 수 있습니다.

형식

이벤트의 메시지는 물음표로 시작합니다. 예: <?eventMessage>.

예: ‘shakeCamera’라는 이벤트를 호출하려면 다음과 같이 작성하세요: <?shakeCamera>

• 👍🏻 이벤트는 내장 이펙트 태그를 포함한 어떤 종류의 태그도 가질 수 있습니다.

• ⚠️ 이벤트는 대소문자를 구분합니다. 이렇게 작성하는 것은 <?camshake> 와 같지 않습니다 <?camShake>. 주의하세요! (또는 스크립트에서 string.ToLower() 메서드를 사용해 이를 보정하세요.)

매개변수

이벤트는 하나 이상의 매개변수를 가질 수 있습니다(첫 번째는 = 기호로 시작하고 다른 매개변수는 쉼표로 구분 ,), 스크립트로 여러 데이터를 보낼 수 있습니다.

• 하나의 매개변수: <?eventID=parameter1>, 는 “eventID”라는 메시지와 “parameter1”이라는 하나의 매개변수를 생성합니다.

• 여러 매개변수: <?eventID=p1,p2>, 는 “eventID”라는 메시지와 “p1” 및 “p2”라는 매개변수를 생성합니다.

---

이벤트 수신

이벤트/메시지를 수신하려는 스크립트는 onMessage 콜백에 구독해야 합니다 Typewriter 클래스 내부에. (스크립팅 API).

예:

// 스크립트 내부
[SerializeField] TypewriterComponent typewriter;

// 콜백을 추가하고 제거합니다
void OnEnable() => typewriter.onMessage.AddListener(OnMessage);
void OnDisable() => typewriter.onMessage.RemoveListener(OnMessage);

// 수신된 마커에 따라 처리합니다
void OnMessage(EventMarker marker)
{
    switch (marker.name)
    {
        // 타입라이터가 "<?something>" 태그를 만났을 때
        
        case "something":
            // 무언가를 수행합니다
            break;
    }
}

👍🏻 “message” 문자열에는 ‘<’, ‘?’ 및 ‘>’ 문자가 없고 메시지 텍스트만 포함되어 있다는 점에 유의하세요.