添加音效 v0.1版

2026-07-04 18:35:23 +08:00
parent 8a6721f22a
commit 8ae4469c72
37 changed files with 588 additions and 7 deletions
@@ -0,0 +1,104 @@
+---
+name: water-reflection
+description: 为 Unity 项目中的 UI Image 或 Sprite 应用水面倒影效果。创建或复用 WaterReflection shader（IndianOcean/WaterReflection），创建材质并应用到目标物体。支持水面线位置、波浪振幅、扰动强度、倒影变暗、淡出长度、水面线亮度等参数配置。当用户提到水面倒影、水面反射、倒影效果、water reflection 时使用。
+---
+
+# 水面倒影效果 (Water Reflection)
+
+为 UI Image 或 SpriteRenderer 添加水面倒影效果：原图上半部分保持不变，下半部分显示垂直翻转的扰动倒影，水面分界线带波浪起伏和亮线。
+
+## 资源路径
+
+| 资源 | 路径 |
+|------|------|
+| Shader | `Assets/Light/shaders/WaterReflection.shader` |
+| 材质 | `Assets/Materials/WaterReflection.mat` |
+| Shader 名称 | `IndianOcean/WaterReflection` |
+
+## 使用流程
+
+### 1. 确保 Shader 存在
+
+检查 `Assets/Light/shaders/WaterReflection.shader` 是否存在。若不存在，从下方 [Shader 源码](#shader-源码) 创建。
+
+### 2. 创建或复用材质
+
+使用 MCP `assets-material-create` 工具：
+
+```
+shaderName: "IndianOcean/WaterReflection"
+assetPath: "Assets/Materials/WaterReflection.mat"
+```
+
+若材质已存在则跳过。
+
+### 3. 应用到目标物体
+
+通过 MCP `script-execute` 执行以下脚本（替换 `TARGET_NAME` 为目标物体名）：
+
+```csharp
+using UnityEngine;
+using UnityEditor;
+using UnityEngine.UI;
+
+public class Script
+{
+    public static void Main()
+    {
+        var target = GameObject.Find("TARGET_NAME");
+        var mat = AssetDatabase.LoadAssetAtPath<Material>("Assets/Materials/WaterReflection.mat");
+
+        // UI Image
+        var img = target.GetComponent<Image>();
+        if (img != null) { img.material = mat; return; }
+
+        // SpriteRenderer
+        var sr = target.GetComponent<SpriteRenderer>();
+        if (sr != null) { sr.material = mat; return; }
+
+        // Any Renderer
+        var r = target.GetComponent<Renderer>();
+        if (r != null) { r.material = mat; return; }
+    }
+}
+```
+
+### 4. 刷新资源
+
+调用 MCP `assets-refresh` 确保 Unity 编译 shader。
+
+## 可调参数
+
+| 参数 | 说明 | 默认值 | 范围 |
+|------|------|--------|------|
+| `_Waterline` | 水面线位置（UV.y） | 0.7 | 0.05 ~ 0.95 |
+| `_WaveAmplitude` | 水面线波浪振幅 | 0.012 | 0 ~ 0.05 |
+| `_WaveFreq` | 水面线波浪频率 | 4.0 | 1 ~ 15 |
+| `_WaveSpeed` | 水面线波浪速度 | 1.0 | 0 ~ 5 |
+| `_DistortStrength` | 倒影水平扰动强度 | 0.015 | 0 ~ 0.08 |
+| `_DistortSpeed` | 扰动动画速度 | 1.5 | 0 ~ 5 |
+| `_DistortFreq` | 扰动波纹频率 | 8.0 | 1 ~ 20 |
+| `_ReflDarken` | 倒影变暗系数 | 0.5 | 0 ~ 1 |
+| `_ReflFadeLen` | 倒影向下淡出长度 | 0.25 | 0 ~ 0.5 |
+| `_LineBrightness` | 水面线亮度 | 1.5 | 0 ~ 3 |
+| `_LineThickness` | 水面线粗细 | 0.004 | 0 ~ 0.02 |
+
+通过 MCP `gameobject-component-modify` 或 `object-modify` 修改材质参数。
+
+## Shader 源码
+
+若需重建 shader，完整源码见 [WaterReflection.shader](../../../Assets/Light/shaders/WaterReflection.shader)。
+
+核心原理：
+- 以 `_Waterline` 为轴，多层正弦+noise 叠加产生波浪形分界线
+- 倒影区 UV 垂直翻转：`reflUV.y = 2 * waterline - uv.y`
+- 水平扰动由多层 noise 叠加模拟随机水面波纹
+- 倒影从上往下逐渐淡出（alpha 衰减）
+- 水面分界线处叠加蓝白色亮线
+
+## 注意事项
+
+- 项目使用 **URP** 渲染管线，shader 已包含 `"RenderPipeline" = "UniversalPipeline"` tag
+- UI Image 通过 `Image.material` 设置，不是 `Renderer.material`
+- 修改 shader 文件后需调用 `assets-refresh` 触发重新编译
+- 波浪效果是动态的（依赖 `_Time.y`），在 Play 模式下最明显