> For the complete documentation index, see [llms.txt](https://docs.febucci.com/text-animator-unity/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.febucci.com/text-animator-unity/3.x-ko/typewriter/show-and-hide-letters-dynamically.md).

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

<mark style="color:기본값;background-color:yellow;">**타이프라이터를 사용하면 글자를 동적으로 표시하고 숨길 수 있습니다**</mark><mark style="color:기본값;background-color:yellow;">,</mark> 문자 종류(구두점, 글자, \[…] 등)에 따라 서로 다른 일시정지를 선택하고, 이벤트를 트리거하는 등.

***

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

그 타이프라이터에는 일반 설정과 이벤트 리스너가 포함되어 있으며, 다양한 일시정지/타이밍 모드를 사용할 수 있습니다:

* **문자 단위로**: 한 글자씩 차례로 표시합니다.
* **단어 단위로**: 텍스트를 단어 단위로 진행합니다.

{% hint style="success" %}
이 새로운 구조(3.0부터)는 이벤트 참조와 설정은 그대로 유지한 채, 개발 중에 어떤 이유로든 타이프라이터의 타이밍을 변경할 수 있게 해줍니다! <3
{% endhint %}

**타이프라이터는 다음과 같이 보여야 합니다:**

{% tabs %}
{% tab title="Text Mesh Pro" %}
인스펙터의 TypewriterComponent에서:

<figure><img src="/files/ce75644b7dbb2976795578f5b8cc31637efbdb7f" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="UI Toolkit" %}
UI Builder의 AnimatedLabel에서:

<figure><img src="/files/c087d5db6246a625959facdce10a26fff715efce" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
timings ScriptableObject를 반드시 할당하세요. 그렇지 않으면 타이프라이터가 전체 텍스트를 즉시 표시합니다!
{% endhint %}

***

타이프라이터를 시작하는 방법은 크게 두 가지입니다:

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

타이프라이터를 사용하려면, **코드를 통해 해당 컴포넌트에 텍스트를 직접 설정하는 것이 권장됩니다.**

{% tabs %}
{% tab title="Text Mesh Pro" %}
TextMeshPro를 사용 중이라면, TMPro 또는 Text Animator를 참조하는 스크립트([텍스트 설정하기](/text-animator-unity/3.x-ko/effects/setting-up-texts.md))를 교체하고 `Febucci.TextAnimatorForUnity.TypewriterComponent`  를 대신 참조하세요.

* :x: 하지 마세요: “`tmproText.text = textValue;`” , 또는 "`textAnimator.SetText(textValue);`"&#x20;
* :white\_check\_mark: 하세요:  `typewriter.ShowText(textValue);`
  {% endtab %}

{% tab title="UI Toolkit" %}
UI Toolkit을 통해서는 `AnimatedLabel` 이미 "`Typewriter`" 값을 사용할 수 있습니다!\
타이프라이터 지연 시간을 할당했는지만 확인하면, 다른 작업은 필요 없습니다.
{% endtab %}
{% endtabs %}

### B) 자동 인식 <a href="#b-via-the-easy-integration" id="b-via-the-easy-integration"></a>

위 단계를 따르지 않았더라도, Typewriter 컴포넌트를 추가했거나 UI Toolkit의 AnimatedLabel을 통해 "Timings"를 설정했다면 TextAnimator는 여전히 타이프라이터를 자동으로 시작하려고 시도합니다.&#x20;

{% hint style="warning" %}
Easy Integration은 한 프레임 늦게 적용될 수 있습니다(먼저 무언가가 변경되었음을 감지해야 하는데, 보통 이는 이전 프레임에 이미 처리되어 있고, 그다음 타이프라이터를 시작하기 때문입니다). 이것이 문제가 된다면, 해당 단계를 따르거나 [글자를 동적으로 표시하고 숨기기](/text-animator-unity/3.x-ko/typewriter/show-and-hide-letters-dynamically.md#a-via-code-recommended), 또는 다음을 참고하세요 [문제 해결](/text-animator-unity/3.x-ko/other/troubleshooting.md#when-i-set-the-text-i-see-the-previous-one-for-one-frame-before-showing-the-new-one)
{% endhint %}

***

## 문자 제어

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

컴포넌트의 인스펙터에서 타이프라이터 시작이 어떻게 트리거될지 제어하는 몇 가지 옵션을 찾을 수 있습니다:

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

<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">“Showing Text” 섹션에서 설명한 대로</a>)</td></tr><tr><td><strong>모든 이벤트에서 자동으로</strong></td><td>위의 모든 항목</td></tr></tbody></table>

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

{% hint style="success" %}
다음을 호출하면 언제든지 타이프라이터를 일시정지할 수 있습니다 `typewriter.StopShowingText()`, 그리고 다음을 호출하여 시작/재개할 수 있습니다 `typewriter.StartShowingText()`.
{% endhint %}

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

전체 타이프라이터를 건너뛰려면 다음을 호출하면 됩니다 `typewriter.SkipTypewriter()` 메서드.

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

* `건너뛰기 시 등장 효과 숨기기`: 타이프라이터를 건너뛸 때마다 등장 효과가 재생되지 않게 하려면 true로 설정하세요(즉, 텍스트가 즉시 표시됩니다).
* `건너뛰기 시 이벤트 트리거`: 타이프라이터를 건너뛸 때 남아 있는 모든 이벤트를 한꺼번에 트리거하고 싶다면 true로 설정하세요(이벤트에 게임 로직이 연결되어 있다면 한 번에 모두 실행되므로 주의하세요). 이벤트에 대한 자세한 내용은 여기에서 확인하세요: [입력 중 이벤트 트리거](/text-animator-unity/3.x-ko/typewriter/trigger-events-when-typing.md)

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

{% hint style="warning" %}
이 기능은 3.0에서 테스트 중이며, 다음 버전에서 곧 복원될 예정입니다! 양해해 주셔서 감사합니다!
{% endhint %}

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

다음을 호출하여 스크립트로 글자를 동적으로 숨길 수 있습니다 `typewriter.StartDisappearingText()`, 그리고 다음을 호출하여 언제든지 중지할 수도 있습니다 `typewriter.StopDisappearingText()`.

***

{% hint style="info" %}
직접 타이밍 대기 시간을 만들 수 있습니다(다음을 읽어보세요 [여기 ](/text-animator-unity/3.x-ko/writing-custom-classes/c-1.md)C#으로 만드는 방법) 또는 내장된 기능을 사용할 수 있습니다.
{% endhint %}

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

타이프라이터는 같은 설정을 공유할 수도 있고 개별 설정도 가질 수 있으므로, 인스펙터에서 각 필드 위에 마우스 커서를 올려 툴팁을 확인하세요.

가장 중요하고 흔한 항목들을 간단히 살펴보면:

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

타이프라이터 동작에 따라 트리거되는 Unity 이벤트를 사용할 수 있습니다(예: 텍스트 표시가 막 끝났을 때).

<figure><img src="/files/6eaefeae41b85173987c19e2b5888f1e7c4c7913" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="288">이벤트</th><th>설명</th></tr></thead><tbody><tr><td><code>OnTextShowed</code></td><td>전체 텍스트가 표시된 후 호출되는 이벤트(<em>“Use Typewriter”를 true로 설정했다면, 모든 글자가 표시될 때까지 기다립니다</em>)</td></tr><tr><td><code>OnTextDisappeared</code></td><td>스크립트가 마지막 글자를 숨기기 시작하자마자 호출됩니다</td></tr></tbody></table>

아래 항목들은 “**use typewriter**”가 **true**:

<table><thead><tr><th width="288">이벤트</th><th>설명</th></tr></thead><tbody><tr><td><code>OnTypewriterStart</code></td><td>타이프라이터가 첫 글자를 표시하기 직전에 호출됩니다.<br>타이프라이터가 꺼져 있으면 “OnTextShowed” 이벤트와 겹치므로 작동하지 않습니다 <em>(이 경우에는 대신 그 이벤트를 사용할 수 있습니다)</em></td></tr><tr><td><code>OnCharacterVisible(Char)</code></td><td>문자가 보일 때마다 호출됩니다</td></tr><tr><td><code>OnMessage(EventMarker)</code></td><td>타이프라이터가 텍스트에서 메시지/이벤트를 만날 때마다 호출됩니다. 이벤트에 대해 더 읽어보기 <a href="/pages/62c42e116613b44ade473b34c0da6874cfbce04a">여기</a></td></tr></tbody></table>

{% hint style="info" %}
타이프라이터는 연결된 Text Animator를 사용하여 **시간 배율** 시간을 진행합니다(자세한 내용은 여기에서 확인할 수 있습니다: [애니메이터 설정](/text-animator-unity/3.x-ko/effects/how-to-add-effects/animator-settings.md#time-scale)), 즉 시간이 "Unscaled"로 설정되면 게임이 일시정지되어도 타이프라이터는 계속 진행됩니다.
{% endhint %}