# 最佳实践

{% hint style="info" %}
每个项目都不同，但在本页你可以找到一些常见的最佳实践，帮助你更好地设置一切并避免大多数常见问题！
{% endhint %}

### 在代码中使用 Text Animator 的“SetText/ShowText”方法，而不是 TMPro

如果你通过代码设置文本，请直接使用 Text Animator 或其打字机，而不是 TextMeshPro。

```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?");` 就这样！ [dong-tai-xian-shi-he-yin-cang-zi-mu](https://docs.febucci.com/text-animator-unity/2.x-zh/typewriter/dong-tai-xian-shi-he-yin-cang-zi-mu "mention")

***

如果你正在构建一个动态字符串，仍然可以在将其值设置给打字机/动画器之前完成构建。

```csharp
int apples = 5; // 稍后从游戏状态获取
string playerName = "Bob";

// 先构建整个对话行
string dialogue = $"Hello {playerName}, you've got {apples} apples";

// 然后只设置文本一次
typewriter.ShowText(dialogue);
```

（如果你使用对话系统，他们会为你处理这些——不用担心！ [ji-cheng](https://docs.febucci.com/text-animator-unity/2.x-zh/ji-cheng "mention"))

</details>

<details>

<summary>为什么我应该一次性设置整个文本，而不是逐字符设置？</summary>

性能！（即使你没有使用 Text Animator。）

每次设置文本时，TextMeshPro 都需要计算其网格、定位等，而 Text Animator 之后还要重新计算字符持续时间等。这意味着如果你每秒多次更改它（例如逐渐添加字母），这些计算会每次都进行。

要逐个显示字符，你只需将完整文本设置一次，然后启动打字机： [dong-tai-xian-shi-he-yin-cang-zi-mu](https://docs.febucci.com/text-animator-unity/2.x-zh/typewriter/dong-tai-xian-shi-he-yin-cang-zi-mu "mention")&#x20;

</details>

***

### 使用 TextAnimator 的“ScheduleMeshRefresh”而不是 TMPro.ForceMeshUpdate()

如果你调用 "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)] 它将在下一帧执行该方法，但会保持所有引用不变。

***

*如果你在文本检查器中更改了某些内容但没有得到更新，请告诉我们！*