# 타이핑 시 이벤트 트리거

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

<figure><img src="https://2318413514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJE1tNTWPRG3py6Cs3USD%2Fuploads%2FCXqGQa0BfAo5oW5UmaUt%2Ftextanimatorgif2febucci.gif?alt=media" alt="textanimatorgif2febucci"><figcaption><p>장면 '예제 3 - 이벤트'</p></figcaption></figure>

***

## 개요 <a href="#overview" id="overview"></a>

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

### 서식 <a href="#formatting" id="formatting"></a>

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

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

* 👍🏻 이벤트는 내장 효과 태그를 포함하여 모든 종류의 태그를 가질 수 있습니다.
* ⚠️ 이벤트는 대소문자를 구분합니다. 다음을 작성하는 것은 `<?camshake>` 와 같지 않습니다. `<?camShake>`주의하세요! (또는 이를 처리하기 위해 `string.ToLower()` 메서드를 스크립트에서 사용하세요.)

### 매개변수 <a href="#parameters" id="parameters"></a>

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

* 하나의 매개변수: `<?eventID=parameter1>`, 는 메시지 "eventID"와 하나의 매개변수 "parameter1"을 생성합니다.
* 여러 매개변수: `<?eventID=p1,p2>`, 는 메시지 "eventID"와 매개변수 "p1" 및 "p2"를 생성합니다.

***

## 이벤트 수신하기 <a href="#listening-to-events" id="listening-to-events"></a>

이벤트/메시지를 수신하려는 스크립트는 다음에 구독해야 합니다. `onMessage` 콜백을 `Typewriter` 클래스 내부에. ([스크립팅 API](https://www.api.febucci.com/tools/text-animator-unity/api/Febucci.UI.Core.TypewriterCore.html#Febucci_UI_Core_TypewriterCore_onMessage)).

예:

```csharp

//스크립트 내부

public Febucci.UI.Core.TypewriterCore typewriter;

//콜백 수신 추가 및 제거
void OnEnable() => typewriter.onMessage.AddListener(OnTypewriterMessage);
void OnDisable() => typewriter.onMessage.RemoveListener(OnTypewriterMessage);

//이벤트에 따라 동작 수행
void OnTypewriterMessage(Febucci.UI.Core.Parsing.EventMarker eventMarker)
{
    switch (eventMarker.name)
    {
        case "something":
            // 무언가 수행
            break;
    }
}
```

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

다음을 확인할 수 있습니다 [EventMarker API here](https://www.api.febucci.com/tools/text-animator-unity/api/Febucci.UI.Core.Parsing.EventMarker.html), 예를 들어 이벤트의 모든 매개변수(있는 경우)를 가져오기 위해.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.febucci.com/text-animator-unity/2.x-ko/typewriter/undefined-2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.