# 修饰符

<mark style="color:默认;background-color:yellow;">**修饰符**</mark> <mark style="color:默认;background-color:yellow;">**让你单独更改效果的特性**</mark>，而无需为每个变体创建新的标签或可脚本对象。

`“我曾经<wiggle>强大</wiggle>……但现在我<wiggle a*3>强大了三倍</wiggle>!!!”`

<p align="center"><img src="/files/e32295f2afb8a309ddcc1a27d0c98739365bd398" alt="" data-size="original"></p>

{% hint style="info" %}
你可以在这里阅读每个效果可用修饰符的列表： [内置效果列表](/text-animator-unity/3.x-zh/xiao-guo/nei-zhi-xiao-guo-lie-biao.md)
{% endhint %}

***

### 数值

要修改效果 **的数值** （例如振幅或速度），请在其 **信息写在效果标签本身内部**.&#x20;

#### 乘以

格式： `<effectId`` `**`parameter*value`**`>`

<mark style="color:默认;background-color:yellow;">符号会告诉代码</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**`*`**</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">将</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**乘以**</mark> <mark style="color:默认;background-color:yellow;">**一个**</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">浮点参数与该值相乘</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**通过这种方式，你可以轻松知道被修改的效果相比基础效果会强/弱多少**</mark><mark style="color:默认;background-color:yellow;">.</mark> （出于这个原因，值为“1”的修饰符将返回与基础值相同的结果） *示例*.

<details>

<summary>使</summary>

* 一个“波动”效果的 `振幅` 变为三倍强： `<wave a*3>`
* 使“彩虹”效果变为两倍慢 `<rainb a*0.5>`

<figure><img src="/files/86c46fa636db8922d4da6a0d1c1dadb5140141c3" alt=""><figcaption><p>将摇摆增强五倍</p></figcaption></figure>

</details>

{% hint style="info" %}
符号会告诉代码 **`*`** 符号仅适用于数字。对于字符串，请使用 **`=`**
{% endhint %}

#### 设置

格式： `<effectId`` `**`parameter=value`**`>`

<mark style="color:默认;background-color:yellow;">符号会告诉代码</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**`=`**</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">将</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**来直接设置一个**</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">参数</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**值**</mark><mark style="color:默认;background-color:yellow;">.</mark> 当你需要在文字区域获得精确的运动/结果，或设置字符串时特别有用。

示例：写入“\<wave a=5>”等同于在检查器中将波动振幅设置为5！（当然好处是“\<wave a=5>”修饰符只在你设置的文本区域内使用该值，关闭标签后会恢复为默认值。）

### 关键词

<mark style="color:默认;background-color:yellow;">**某些**</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">效果</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**设置**</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">也可以通过一个</mark> <mark style="color:默认;background-color:yellow;"></mark><mark style="color:默认;background-color:yellow;">**单词**</mark>来修改，而无需在旁边写任何数值。&#x20;

格式： `<effectId`` `**`关键字`**`>`

示例：使用 [播放](/text-animator-unity/3.x-zh/xiao-guo/ru-he-bian-ji-xiao-guo/bo-fang.md)播放效果仅一次，写入 **\<wave once>**

***

### 提示与最佳实践

* 你可以在同一个效果标签上使用多个修饰符！

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXuXUTa2X5PYuYL6yRvl1%2Fuploads%2FvBzBoXx71oIcJLmnyO3s%2FMultiModifiers_Example_TAnim3.0.mp4?alt=media&token=a42f7f81-29ab-4c4d-af2e-8b4969faf79b>" %}

* 在检查器中，将你的效果设置为它们的“默认状态”/中性音调。\
  这样在你撰写对话时修改参数会更容易，而无需记住每个参数的精确数值。\
  一旦你设置好了一个中性的“抖动”，在写作时就会更容易知道“\<shake a=2>”会使其变为两倍强（例如：用于让某人生气！）

另外：

* :thumbsup: 你也可以在声明“[默认/回退](/text-animator-unity/3.x-zh/xiao-guo/ru-he-tian-jia-xiao-guo.md#set-default-effects-to-the-entire-text)”效果时使用修饰符（只需直接在检查器中写入）。
* :exclamation: 确保在修饰符ID、“=”符号及其值之间不要留空格
  * ❌ 错误： `<wiggle f = 3>`
  * ✅ 正确： `<wiggle f=3>`
* :warning: 如果在同一个富文本标签中写入相同的属性，只有最后一个会生效。

  写入“\<wiggle **`a=2`** **`a=5`**>”等同于写入“\<wiggle **`a=5`**>”，因为第一个“**`浮点参数与该值相乘`**”参数将被第二个丢弃/覆盖。


---

# Agent Instructions: 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/3.x-zh/xiao-guo/ru-he-bian-ji-xiao-guo/xiu-shi-fu.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.
