> 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/quick-start/install-and-quick-start.md).

# 설치 및 빠른 시작

{% hint style="info" %}
에셋을 사용하는 것은 몇 번의 클릭(import -> 컴포넌트 추가 -> 재생 버튼)으로 끝나지만, 모든 것을 더 잘 이해하려면 다음 페이지들을 살펴보아 더 빠르고 올바른 방향으로 시작할 수 있습니다.
{% endhint %}

### 1. Unity용 Text Animator 가져오기 <a href="#how-to-implement-text-animator" id="how-to-implement-text-animator"></a>

가장 먼저 프로젝트에 Text Animator for Unity를 가져와야 합니다.

#### 호환성 확인

<mark style="color:기본;background-color:green;">**이 에셋은 다음 UI 및 Unity 버전과 함께 작동합니다**</mark>:

* **텍스트 메시 프로** (Unity 2022.3 이상)
* **UI 툴킷** ([Unity 6.3 이상](#user-content-fn-1)[^1]).

새로운 Unity 입력 시스템(및 레거시 시스템)도 지원합니다.

#### 패키지 가져오기

프로젝트가 올바르게 설정되면 Package Manager(Asset Store 탭)에서 Text Animator를 가져올 수 있습니다.

설치가 성공하면 **환영 창** 이 나타나고 Text Animator로 텍스트 애니메이션을 시작할 준비가 됩니다!

{% hint style="info" %}
만약 정보 창이 나타나지 않거나 나중에 다시 보고 싶다면, 언제든지 메뉴에서 접근할 수 있습니다: `Tools/Febucci/TextAnimator/About Window`
{% endhint %}

<figure><img src="/files/52e234dbd9283126539051094f5522fe18c7daef" alt="" width="375"><figcaption><p>가져온 후 표시되는 환영 창의 일부</p></figcaption></figure>

### 데이터베이스 가져오기

기본 효과 및 액션 데이터베이스를 가져왔는지 확인하세요. 모든 파일을 다음에서 볼 수 있어야 합니다: `Assets/Plugins/Febucci/Text Animator for Unity` 폴더들

<figure><img src="/files/28549adec1c36ac4645c1d9e399fb77ff55a49e7" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
기본 데이터가 보이지 않거나 재설치/초기화하려면 언제든지 About Window로 가서 "Install Built In Effects"(또는 재설정)를 클릭하면 됩니다.

![](/files/2061a909d54b15f2e4a22e93f1cf92e702027624)
{% endhint %}

{% hint style="success" icon="thumbs-up" %}
이렇게 하면 효과를 편집한 내용이 덮어써질까 걱정하지 않고도 에셋을 업데이트할 수 있습니다. 좋죠!
{% endhint %}

### 2. 예제 씬

대부분의 Text Animator 기능은 인스펙터에서 직접 배우고, 예제 씬에서 우리가 설정한 방식과 그 결과를 확인할 수 있습니다.&#x20;

다음 항목들을 가져왔는지 확인하세요 **샘플** 패키지와 씬은 About 창이나 패키지 매니저에서 가져올 수 있습니다.

{% columns %}
{% column %}

<figure><img src="/files/75abdc39b76529d125e191d74b7dc4827c3451c2" alt="" width="375"><figcaption><p>About 창에서 샘플 씬을 가져올 수 있습니다</p></figcaption></figure>

{% endcolumn %}

{% column %}

<figure><img src="/files/fc8ee5d6e7079cdb7485fd42a528f2a82034d3f8" alt="" width="375"><figcaption><p>패키지 매니저에서도 샘플 씬을 가져올 수 있습니다</p></figcaption></figure>

{% endcolumn %}
{% endcolumns %}

다음 씬인 "**00 - Welcome**"에서 시작하여 각 기능과 사용 사례를 따라가 보세요!

{% hint style="success" icon="thumbs-up" %}
더 이상 필요하지 않은 예제 씬은 삭제할 수 있으며, 언제든지 다시 가져올 수 있습니다.
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXuXUTa2X5PYuYL6yRvl1%2Fuploads%2FMz4d3PjHJeuB5XSjowp0%2FClipboard-20251115-165101-841.mp4?alt=media&token=b4b87677-6ca5-4a9a-abad-5711119b9562>" %}

## 3. 첫 텍스트에 애니메이션 적용하기 <a href="#animating-your-first-texts" id="animating-your-first-texts"></a>

몇 번의 클릭으로 텍스트를 실행할 수 있습니다!

{% tabs %}
{% tab title="UI 툴킷" %}
*추신. 이미 알고 있다고 가정합니다* [*UI 툴킷을 사용하는 방법을*](https://docs.unity3d.com/Documentation/Manual/UIElements.html) *그리고 그것이 무엇을 하는지.*

#### UI 빌더에서

* 라이브러리 -> 프로젝트로 이동하세요
* 다음을 드래그하세요 "<mark style="color:기본;background-color:yellow;">AnimatedLabel</mark>" 를 계층 구조에서 "Custom Controls/Febucci/Text Animator for Unity"에서!

{% hint style="info" %}
UI 툴킷에서 기본 제공 Label과 Button을 직접 애니메이션할 수 있도록 작업 중입니다! *(Unity 6.3 이상.)*  업데이트를 확인하세요!
{% endhint %}

.uxml은 다음과 같이 보여야 합니다:

<figure><img src="/files/9384488d5a574456471f9085056c965539e265b3" alt="" width="302"><figcaption></figcaption></figure>

#### 코드로

다음 "의 인스턴스를 생성할 수 있습니다<mark style="color:기본;background-color:yellow;">Febucci.TextAnimatorForUnity.AnimatedLabel</mark>" 클래스와 UI 문서에 추가하세요, 다음과 같이:

```csharp
using UnityEngine;
using UnityEngine.UIElements;
using Febucci.TextAnimatorForUnity; // <- Text Animator의 네임스페이스를 임포트합니다

public class ExampleScript : MonoBehaviour
{ 
    [SerializeField] UIDocument document;

    void Start()
    {
        var container = document.rootVisualElement.contentContainer;
        var animatedLabel = new AnimatedLabel(); // <- 애니메이션 라벨을 생성합니다
        container.Add(animatedLabel); // <- 콘텐츠 컨테이너에 추가합니다
        // [..]
        animatedLabel.SetText("<wave>hello"); // <- 텍스트를 설정합니다
    }
}
```

{% endtab %}

{% tab title="Text Mesh Pro" %}
*추신. 이미 알고 있다고 가정합니다* [*Text Mesh Pro를 사용하는 방법*](https://docs.unity3d.com/Packages/com.unity.ugui@2.0/manual/TextMeshPro/index.html) *그리고 그것이 어떻게 작동하는지.*

추가하기 <mark style="color:기본;background-color:yellow;">텍스트 애니메이터 - Text Mesh Pro</mark> 같은 GameObject에 구성 요소로 <mark style="color:기본;background-color:yellow;">TextMeshPro</mark> 구성요소(UI 또는 월드 공간 모두 가능!):

인스펙터는 다음과 같이 보여야 합니다:

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

{% hint style="success" %}
자세한 내용과 제안은 [텍스트 설정하기](/text-animator-unity/3.x-ko/effects/setting-up-texts.md) 을(를) 읽어보세요!
{% endhint %}

### 텍스트에 효과 쓰기 <a href="#id-1-writing-effects-in-your-text" id="id-1-writing-effects-in-your-text"></a>

텍스트에 효과를 추가하는 한 가지 방법은 다음과 같이 리치 텍스트 태그를 사용하는 것입니다: “`I'm <shake>freezing</shake>`”, 여기서 "shake"는 내장 효과의 ID입니다.&#x20;

* 다음 태그들을 사용해 실험하면서 텍스트를 작성해 보세요: `<wiggle>` `<shake>` `<wave>` `<bounce>`처럼 “`<wiggle>I'm joking</wiggle> hehe now <shake>I'm scared</shake>`”를 입력한 다음 Unity의 재생 모드로 들어가 보세요.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXuXUTa2X5PYuYL6yRvl1%2Fuploads%2F7y8S1JvFDd8t4bYFdZ4D%2FClipboard-20251115-172643-241.mp4?alt=media&token=de2d715d-e02a-4667-9d0b-66e643e0df55>" %}

{% hint style="success" %}
입력한 효과에 따라 텍스트의 글자들이 애니메이션됩니다!
{% endhint %}

***

텍스트 애니메이션을 즐기세요! 에셋의 모든 기능을 더 자세히 보려면 다음 페이지로 진행하세요.

[^1]: 다른 버전은 고려/테스트 중입니다! (일부 중요한 우회 방법이 필요합니다.) 계속 지켜봐 주세요!