> 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/2.x-ko/undefined-3/undefined.md).

# 모범 사례

{% hint style="info" %}
모든 프로젝트는 다르지만, 이 페이지에서는 설정을 더 잘하고 가장 흔한 문제들을 피하는 데 도움이 되는 몇 가지 일반적인 모범 사례를 찾을 수 있습니다!
{% endhint %}

### TextMeshPro 대신 Text Animator의 "SetText/ShowText" 메서드를 사용하세요

코드로 텍스트를 설정하는 경우 TextMeshPro 대신 Text Animator 또는 그 타입라이터를 직접 사용하세요.

```csharp
// 일부 코드
TMP_Text tmpText;
Febucci.UI.Core.TAnimCore textAnimator;
Febucci.UI.Core.TypewriterCore typewriter;

// [...] 이렇게 하세요
textAnimator.SetText(value); // 텍스트를 즉시 설정하려면
//또는 
typewriter.ShowText(value); // 타입라이터가 있는 경우 이렇게 설정하려면
```

참고용 API: [textAnimator.SetText](https://www.api.febucci.com/tools/text-animator-unity/api/Febucci.UI.Core.TAnimCore.html#Febucci_UI_Core_TAnimCore_SetText_System_String_), [typewriter.ShowText](https://www.api.febucci.com/tools/text-animator-unity/api/Febucci.UI.Core.TypewriterCore.html#Febucci_UI_Core_TypewriterCore_ShowText_System_String_)

***

### 전체 텍스트/대사를 한 번만 설정하세요

가능하면 텍스트를 한 번만 설정하고 타입라이터/가시성 메서드로 표시 방식을 제어하세요.

{% hint style="info" %}
정말로 나중에 텍스트를 추가해야 한다면 "textAnimator.AppendText" 메서드를 사용할 수 있습니다.
{% endhint %}

<details>

<summary>예시</summary>

캐릭터가 "Helloooo how are you doing?"라고 말하고 이를 한 글자씩 표시하고 싶다면, 간단히 다음과 같이 하세요: `typewriter.ShowText("Hellooooo how are you doing?");` 이게 전부입니다! [글자를 동적으로 표시 및 숨기기](/text-animator-unity/2.x-ko/typewriter/undefined.md)

***

동적 문자열을 만들고 있다면, 값을 타입라이터/애니메이터에 설정하기 전에 그 작업을 수행할 수 있습니다.

```csharp
int apples = 5; // 나중에 게임 상태에서 가져옴
string playerName = "Bob";

// 전체 대사 줄을 먼저 구성하세요
string dialogue = $"Hello {playerName}, you've got {apples} apples";

// 그런 다음 텍스트를 한 번 설정하세요
typewriter.ShowText(dialogue);
```

(대화 시스템을 사용하고 있다면, 그들이 이 작업을 대신 처리해 줄 것입니다 - 걱정 마세요! [통합](/text-animator-unity/2.x-ko/undefined-2/undefined.md))

</details>

<details>

<summary>왜 글자별로가 아니라 전체 텍스트를 한 번만 설정해야 하나요?</summary>

성능 때문입니다! (Text Animator가 없더라도)

텍스트를 설정할 때마다 TextMeshPro는 메시와 위치 등을 계산해야 하고, Text Animator는 문자 지속시간 등도 다시 계산해야 합니다. 즉 초당 여러 번(예: 글자를 추가할 때) 변경하면 매번 이러한 계산을 수행하게 됩니다.

문자를 하나씩 표시하려면 전체 텍스트를 한 번 설정한 다음 타입라이터를 시작하면 됩니다: [글자를 동적으로 표시 및 숨기기](/text-animator-unity/2.x-ko/typewriter/undefined.md)&#x20;

</details>

***

### TMPro.ForceMeshUpdate() 대신 TextAnimator의 "ScheduleMeshRefresh"를 사용하세요

"tmpText.ForceMeshUpdate"를 호출하면 TextAnimator가 일부 참조를 잃어 문자를 올바르게 표시하지 못할 수 있습니다. 텍스트에서 무언가 변경되어 해당 함수를 호출하고 싶다면 대신 TextAnimator의 "ScheduleMeshRefresh"를 호출해 보세요! \[[스크립팅 API](https://www.api.febucci.com/tools/text-animator-unity/api/Febucci.UI.Core.TAnimCore.html#Febucci_UI_Core_TAnimCore_ScheduleMeshRefresh)] 이 메서드는 다음 프레임에 수행되지만 모든 참조를 그대로 유지합니다.

***

*텍스트 검사기에서 무언가를 변경했는데 업데이트되지 않는다면 알려주세요!*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/undefined-3/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.