텍스트 설정

텍스트 애니메이터에 텍스트를 설정하는 방법은 두 가지 UI 시스템에서 가능합니다:

• 텍스트 설정

• Text Mesh Pro

이 페이지에는 이미 설치 및 빠른 시작에 있는 일부 정보가 포함되어 있지만, 각 시스템 및 일반적인 사용에 대한 다른 세부사항과 제안들도 포함되어 있습니다. 반드시 텍스트 설정 섹션을 읽어보세요!

---

UI 툴킷

추신. 이미 알고 있다고 가정합니다 UI 툴킷을 사용하는 방법을 그리고 그것이 무엇을 하는지.

UI 빌더에서

• 라이브러리 -> 프로젝트로 이동

• 드래그 "AnimatedLabel" 를 계층 구조의 "Custom Controls/Febucci/Text Animator for Unity"에서!

내장된 레이블과 버튼을 UI 툴킷에서 직접 애니메이션할 수 있도록 작업 중입니다! (Unity 6.3 이상.) 업데이트를 확인하세요!

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

코드로

"의 인스턴스를 생성할 수 있습니다Febucci.TextAnimatorForUnity.AnimatedLabel" 클래스와 UI 문서에 추가하는 방법은 다음과 같습니다:

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"); // <- 텍스트 설정
    }
}

이제 끝났습니다!! 당신은 준비가 되었습니다 효과 추가 방법

---

Text Mesh Pro

추신. 이미 알고 있다고 가정합니다 Text Mesh Pro 사용 방법 그리고 그것이 어떻게 작동하는지.

추가하기 텍스트 애니메이터 - Text Mesh Pro 동일한 GameObject에 구성 요소를 추가하세요 TextMeshPro 구성 요소(UI 또는 월드 공간 중 하나!):

인스펙터는 다음과 같아야 합니다:

이제 끝났습니다!! 당신은 준비가 되었습니다 효과 추가 방법

컴포넌트에 텍스트를 설정했는데 빈 텍스트가 보인다면, TextMeshPro 컴포넌트를 최소 한 번 클릭해 "Essentials"를 가져왔는지 확인하세요(창이 뜨면 가져오라는 요청이 표시됩니다).

코드로 텍스트를 설정할 때의 모범 사례

코드로 TextMeshPro 객체에 텍스트를 설정할 때는 TMPro 대신 Text Animator의 스크립트를 참조하세요. 예:

using UnityEngine;
using TMPro; 
using Febucci.TextAnimatorForUnity.TextMeshPro; // <- Text Animator의 네임스페이스를 임포트

public class ExampleScript : MonoBehaviour
{
    [SerializeField] TMP_Text textMeshPro;
    [SerializeField] TextAnimator_TMP textAnimator;

    void Start()
    {
        // 🚫 하지 말 것: TMPro를 통해 텍스트 설정
        textMeshPro.SetText("<wave>hello");

        // ✅ 할 것: Text Animator를 통해 직접 텍스트 설정
        textAnimator.SetText("<wave>hello");
    }

}

참고: TMPro를 참조해도 동작은 하지만, TextAnimator로 텍스트를 설정하면 텍스트에 대해 더 많은 제어가 가능하므로 통합이 더 잘됩니다.

---

모범 사례

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

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

정말로 나중에 텍스트를 추가해야 한다면 "textAnimator.AppendText" 메서드를 사용할 수 있습니다.

예

캐릭터가 "Helloooo how are you doing?"이라고 말하고 각 글자마다 표시하고 싶다면, 단순히 다음과 같이 하세요: typewriter.ShowText("Hellooooo how are you doing?"); 그게 전부입니다! 글자 동적 표시 및 숨기기

---

동적 문자열을 구성하는 경우에도 타입라이터/애니메이터에 값을 설정하기 전에 해당 문자열을 만들 수 있습니다.

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

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

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

(대화 시스템을 사용하고 있다면, 그들이 대신 이 작업을 해줄 것입니다 - 걱정하지 마세요! 통합)

왜 전체 텍스트를 한 번에 설정하고 문자별로 설정하지 않아야 하나요?

성능 때문입니다! (Text Animator가 없어도 마찬가지입니다.)

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

문자를 하나씩 표시하려면 전체 텍스트를 한 번 설정한 다음 타입라이터를 시작하면 됩니다: 글자 동적 표시 및 숨기기