# 编写自定义效果（C#）
除了使用 [内置效果](https://docs.febucci.com/text-animator-unity/3.x-zh/xiao-guo/nei-zhi-xiao-guo-lie-biao) 或 [从检查器创建自定义效果](https://docs.febucci.com/text-animator-unity/3.x-zh/zi-ding-yi/chuang-jian-nin-zi-ji-de-xiao-guo), **你也可以通过 C# 轻松编写自定义效果** .
{% hint style="info" %}
附注：确保你已阅读 [gao-ji-gai-nian](https://docs.febucci.com/text-animator-unity/3.x-zh/bian-xie-zi-ding-yi-lei/gao-ji-gai-nian "mention") 页面！
{% endhint %}
效果有三个关键部分（可以写在同一个文件中）。
参数类/结构体 包含有关你将在效果中使用的数据/值的信息（状态） 状态 结构体主效果类。根据参数和字符，随时间修改它。同时处理 xiu-shi-fu 可脚本化封装 将前面的元素统一在一起并让你将内容保存到磁盘。只需几行代码让我们完成其余工作！
{% hint style="success" %}
这些名称只是约定，但 **你可以按自己喜欢的方式命名它们**!
只要知道你需要：
* 用于存储效果变量的东西
* 负责修改字母的结构体
* 将这两者黏合并允许你将信息保存到磁盘的可脚本化对象
{% endhint %}
## 编写你的自定义脚本
{% hint style="info" %}
在本示例中，我们制作了一个使字符按可变量上升的效果。
{% endhint %}
首先，确保导入必要的命名空间（你的 IDE 无论如何都会提示你 <3）
using UnityEngine;
// 导入 Text Animator 的命名空间
using Febucci.TextAnimatorCore;
using Febucci.TextAnimatorCore.Text;
using Febucci.Parsing;
using Febucci.TextAnimatorForUnity.Effects;
会将 "amount" 设为 5，而
// a*2 会使 "amount" 成为 defaultAmount 的两倍）
amount = parameters.ModifyFloat("a", defaultAmount);
}
public void Apply(ref CharacterData character, in ManagedEffectContext context)
{
// 使用 "amount" 将字符向上移动
// 使用清晰且易用的 API
character.MovePosition(
Vector3.Up * amount * context.progressionRange * context.intensity,
context.isUpPositive
);
// 1. 注意 context.progressionRange -> 它是
// 你在编辑器中分配的曲线！
// 允许你得到阶跃、正弦、弹跳等效果
// 2. 还要注意 context.intensity，需用于实现
// 阶段之间的平滑过渡。
}
}
```
### 可脚本化对象封装
创建将你的自定义效果挂接到 Text Animator 所需的逻辑，并将其保存在 Assets 文件夹中。
```csharp
[System.Serializable] // <-- 使其可序列化！！
[CreateAssetMenu(fileName = "Your Custom Effect")]
class CustomEffectScriptable : ManagedEffectScriptable
{
// 简单地根据参数（已由 text animator 管理）创建一个新状态
protected override CustomEffectState CreateState(CustomEffectParameters parameters)
=> new CustomEffectState(parameters);
}
```
{% hint style="info" %}
还有另一个接受更多类型的 "ManagedEffectScriptable" 版本，以及 "Referenced" 效果的实现，但我们将在未来的版本中介绍！
{% endhint %}
{% hint style="success" %}
这些脚本是 Text Animator 确保你获得以下内容所需的全部：
* 自动管理的曲线、播放、修饰符
* 无竞态条件的优化效果
* 兼容 AOT 平台的效果（无需使用反射）
* 我们强大的预览编辑器
* 在 UI Toolkit 和 Text Mesh Pro 上表现一致的效果，包括动态缩放
还有更多！<3
{% endhint %}
