# 글자를 동적으로 표시 및 숨기기

다음을 사용할 수 있습니다 `타자기` 문장 부호, 글자 등 어떤 종류의 문자(구두점, 문자, \[…])에 대해서도 서로 다른 일시정지를 선택하고, 이벤트를 트리거하는 등 동적으로 글자를 표시하고 숨기기 위해.

{% hint style="info" %}
타자기는 연결된 Text Animator를 사용합니다 **시간 스케일** 으로 시간을 진행합니다. 자세한 내용은 여기를 읽어보세요: [undefined-1](https://docs.febucci.com/text-animator-unity/2.x-ko/undefined-1/undefined-1/undefined-1 "mention")
{% endhint %}

***

## 텍스트 표시 <a href="#showing-text" id="showing-text"></a>

타자기에는 여러 종류가 있습니다. 예를 들어 “`문자별`” 는 한 글자씩 표시하거나, “`단어별`” 는 단어 단위로 텍스트를 진행합니다.

어떤 타자기를 사용할지 선택한 후(즉, TextAnimator가 있는 동일한 GameObject에 컴포넌트를 추가한 후) 다음 두 가지 주요 방법으로 시작할 수 있습니다:

### A) 코드로 (권장) <a href="#a-via-code-recommended" id="a-via-code-recommended"></a>

다음을 바꿉니다 “`tmproText.text = textValue;`” 를 `typewriter.ShowText(textValue);` 로 코드에서 ([스크립팅 API](https://www.api.febucci.com/tools/text-animator-unity/api/Febucci.UI.Core.TypewriterCore.html#Febucci_UI_Core_TypewriterCore_ShowText_System_String_)).

{% hint style="danger" %}
텍스트를 코드로 설정하고 있다면 이 단계를 놓치지 마세요! 문제가 발생하면 다음을 확인해 보세요: [undefined](https://docs.febucci.com/text-animator-unity/2.x-ko/undefined-3/undefined "mention")
{% endhint %}

### B) “쉬운 통합”을 통해 <a href="#b-via-the-easy-integration" id="b-via-the-easy-integration"></a>

다음을 활성화하기`타자기가 자동으로 시작됨`” 옵션을 TextAnimator 컴포넌트에서 활성화합니다 (참고: 이전에는 “쉬운 통합”이라고 불렸습니다).\
이렇게 하면 플러그인이 TextMeshPro 컴포넌트의 텍스트 변경을 자동으로 확인하고 이에 따라 타자기를 시작합니다.

![](https://2318413514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJE1tNTWPRG3py6Cs3USD%2Fuploads%2FTzcS2yuX8e5hE4uSJTW6%2Ftextanimator%20typewriter%20starts%20automatically.png?alt=media)

![](https://2318413514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJE1tNTWPRG3py6Cs3USD%2Fuploads%2FteoKAfKwf9pFdkQcdyKN%2Ftmpro%20box%20text%20changes.png?alt=media)

***

## 글자 제어

### 타이핑 시작 및 중지 <a href="#start-and-stop-typing" id="start-and-stop-typing"></a>

컴포넌트의 인스펙터 안에는 타자기 시작을 어떻게 트리거할지 제어하는 몇 가지 옵션이 있습니다:

![](https://2318413514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJE1tNTWPRG3py6Cs3USD%2Fuploads%2FKT1LRHcczgFX66AOItmX%2Ftext%20animator%20typewriter%20start.png?alt=media)

* `타자기 시작 모드`: 타자기가 언제 글자 표시를 시작할지 알려줍니다.

<table><thead><tr><th width="300">값</th><th>설명</th></tr></thead><tbody><tr><td><strong>스크립트에서만</strong></td><td>타자기는 다음을 호출할 때만 시작할 수 있습니다 <a href="https://www.api.febucci.com/tools/text-animator-unity/api/Febucci.UI.Core.TypewriterCore.html#Febucci_UI_Core_TypewriterCore_ShowText_System_String_">TextAnimatorPlayer.StartShowingText()</a></td></tr><tr><td><strong>OnEnable</strong></td><td>GameObject가 활성화될 때마다 타자기가 시작됩니다</td></tr><tr><td><strong>OnShowText</strong></td><td>새 텍스트가 설정되는 즉시 타자기가 시작됩니다 (<a href="#showing-text">“텍스트 표시” 섹션에 설명된 대로</a>)</td></tr><tr><td><strong>모든 이벤트에서 자동으로</strong></td><td>위의 모든 것</td></tr></tbody></table>

* `시작 시 타이핑 속도 재설정`: 새 텍스트가 표시될 때마다 타자기 속도를 1로 재설정하려면 true로 설정하세요. 그렇지 않으면 마지막에 사용한 속도를 유지합니다.

{% hint style="success" %}
다음 호출로 언제든지 타자기를 일시정지할 수 있습니다 [typewriter.StopShowingText()](https://www.api.febucci.com/tools/text-animator-unity/api/Febucci.UI.Core.TypewriterCore.html#Febucci_UI_Core_TypewriterCore_StopShowingText), 그리고 다음 호출로 시작/재개할 수 있습니다 [typewriter.StartShowingText()](https://www.api.febucci.com/tools/text-animator-unity/api/Febucci.UI.Core.TypewriterCore.html#Febucci_UI_Core_TypewriterCore_ShowText_System_String_).
{% endhint %}

{% hint style="success" %}
또한 인스펙터에서 재생 모드로 이 동작을 테스트할 수 있습니다(버튼들은 편집 모드에서는 비활성화되어 있습니다).
{% endhint %}

### 전체 텍스트 건너뛰기 <a href="#skip" id="skip"></a>

타자기를 전체 건너뛰려면 다음을 호출할 수 있습니다 [typewriter.SkipTypewriter()](https://www.api.febucci.com/tools/text-animator-unity/api/Febucci.UI.Core.TypewriterCore.html#Febucci_UI_Core_TypewriterCore_SkipTypewriter) 메서드.

동작 방식을 제어할 수 있는 몇 가지 옵션도 찾을 수 있습니다:

* `건너뛰기 시 등장 효과 숨기기`: 타자기가 건너뛸 때 등장 효과가 재생되는 것을 방지하여 텍스트가 즉시 표시되도록 하려면 true로 설정하세요.
* `건너뛰기 시 이벤트 트리거`: 타자기가 건너뛰면 나머지 모든 이벤트를 한꺼번에 트리거하려면 true로 설정하세요(게임 로직을 이 이벤트들과 함께 실행 중이라면 주의하세요. 모든 것이 한 번에 실행됩니다). 이벤트에 관해서는 여기에서 더 읽어보세요: [undefined-2](https://docs.febucci.com/text-animator-unity/2.x-ko/typewriter/undefined-2 "mention")

### 텍스트의 특정 부분 건너뛰기

다음 태그 "<`notype>`" 를 사용하여 텍스트의 특정 구간에서 타자기를 건너뛸 수 있습니다. 예를 들어 "`안녕하세요 <notype>저는 즉시 표시됩니다</notype> 그리고 이제 저는 다시 정상적으로 타이핑됩니다.`"

{% hint style="success" %}
전역 설정에서 이 태그를 변경할 수도 있으니, 다른 태그를 사용하고 싶다면 설정하세요.
{% endhint %}

### 텍스트 숨기기 <a href="#hiding-text" id="hiding-text"></a>

스크립트로 글자를 동적으로 숨기려면 다음을 호출하세요 [typewriter.StartDisappearingText()](https://www.api.febucci.com/tools/text-animator-unity/api/Febucci.UI.Core.TypewriterCore.html#Febucci_UI_Core_TypewriterCore_StartDisappearingText), 그리고 언제든지 다음을 호출하여 중지할 수 있습니다 [typewriter.StopDisappearingText()](https://www.api.febucci.com/tools/text-animator-unity/api/Febucci.UI.Core.TypewriterCore.html#Febucci_UI_Core_TypewriterCore_StopDisappearingText).

런타임 동안 인스펙터의 버튼을 통해서도 이를 테스트할 수 있습니다.

***

{% hint style="info" %}
자체 타자기를 만들 수 있습니다 (읽어보세요 [여기 ](https://docs.febucci.com/text-animator-unity/2.x-ko/c/c)C#을 통해 커스텀 타자기를 만드는 방법) 또는 내장된 것을 사용할 수 있습니다.
{% endhint %}

## 옵션 <a href="#options" id="options"></a>

타자기는 동일한 설정을 공유할 수 있고 특정 설정을 가질 수도 있으므로 인스펙터에서 해당 필드 위에 마우스 커서를 올려 각 필드의 툴팁을 확인하세요.

![](https://2318413514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJE1tNTWPRG3py6Cs3USD%2Fuploads%2FaYCnpGn5bQvKX9EOE5Vq%2Ftext%20animator%20unity%20typrewriter%20next%20tmp.png?alt=media)

다음은 가장 중요하고 일반적인 것들의 빠른 개요입니다:

### 콜백 (Unity 이벤트) <a href="#callbacks-unity-events" id="callbacks-unity-events"></a>

타자기 활동을 기반으로 트리거되는 Unity 이벤트를 사용할 수 있습니다 (예: 텍스트 표시가 끝났을 때).

![](https://2318413514-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJE1tNTWPRG3py6Cs3USD%2Fuploads%2Ff2Ss9H7cNm5dFJt1hbqp%2Ftext%20animator%20typewriter%20events.png?alt=media)

<table><thead><tr><th width="288">이벤트</th><th>설명</th></tr></thead><tbody><tr><td><code>텍스트 표시 완료 시</code></td><td>전체 텍스트가 표시된 후 호출되는 이벤트 (<em>“타자기 사용”을 true로 설정한 경우 모든 글자가 표시될 때까지 대기합니다</em>)</td></tr><tr><td><code>텍스트 사라짐 완료 시</code></td><td>스크립트가 마지막 글자 숨기기를 시작하는 즉시 호출됩니다</td></tr></tbody></table>

아래의 항목들은 “**타자기 사용**” 가 **true**:

<table><thead><tr><th width="288">이벤트</th><th>설명</th></tr></thead><tbody><tr><td><code>타자기 시작 시</code></td><td>타자기가 첫 글자를 표시하기 바로 전에 호출됩니다.<br>타자기가 꺼져 있으면 작동하지 않습니다. 그 경우에는 “텍스트 표시 완료 시” 이벤트와 동시에 발생할 수 있기 때문입니다. <em>(이 경우 대신 해당 이벤트를 사용할 수 있습니다)</em></td></tr><tr><td><code>문자 가시 시(문자)</code></td><td>문자가 보일 때마다 호출됩니다</td></tr><tr><td><code>메시지(이벤트 마커) 시</code></td><td>타자기가 텍스트에서 메시지/이벤트를 만날 때마다 호출됩니다. 이벤트에 대해서는 더 읽어보세요 <a href="undefined-2">여기</a></td></tr></tbody></table>

{% hint style="info" %}
타자기 옵션(예: 지연)에 마우스를 올려 툴팁과 추가 정보를 표시할 수 있습니다!
{% endhint %}


---

# 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.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.