Unity脚本修改材质透明度失效 Slider控制Alpha值异常问题

问题现象 #

• 通过UI Slider滑块修改材质Alpha参数调整透明度功能完全失效，控制台无任何报错
• 拖动滑块无法改变材质Alpha值，直接在Inspector面板修改脚本公开的alpha参数，挂载材质的球体透明度也无变化
• 手动在材质面板调整Alpha值可正常生效，材质已正确设置为Transparent透明渲染模式
• 附加适配需求：触控板输入给滑块的数值范围为-1_{1，而Alpha值有效取值范围为0}1，需要正确的数值映射实现方案

原有问题代码 #

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;

public class ColorChange : MonoBehaviour
{

    public GameObject currentGameObject;
    public float alpha = 0.5f;//half transparency
    //Get current material
    public Material currentMat;

    public Slider slider;

    // Start is called before the first frame update
    void Start()
    {
        currentGameObject = gameObject;
        currentMat = currentGameObject.GetComponent<Renderer>().material;

    }

    // Update is called once per frame
    void Update()
    {
        
    }

    void ChangeAlpha(Material mat, float alphaVal)
    {
        Color oldColor = mat.color;
        Color newColor = new Color(oldColor.r, oldColor.g, oldColor.b, alphaVal);
        mat.SetColor("_Color", newColor);

    }

    public void ChangeAlphaOnValueChange(Slider slider)
    {
        ChangeAlpha(currentMat, slider.value / 250);
    }

}

核心问题原因 #

• 滑块事件绑定方法签名错误：Unity Slider的OnValueChanged事件默认传递的参数是float类型的当前滑块值，不是Slider组件对象，原有方法参数写为Slider类型，事件触发时根本不会执行对应逻辑
• 公开的alpha字段无同步逻辑：原有代码从未将Inspector中修改的alpha值同步给材质，导致直接改面板参数无效果
• 数值计算逻辑错误：Alpha值本身是0_{1范围的浮点数，原有代码硬编码除以250，就算方法触发，得到的Alpha值也仅在0}0.004区间，几乎完全透明，肉眼看不到变化
• 未做数值合法性钳制，传入超出范围的值时会导致材质颜色参数异常

修复方案 #

基础功能修复 #

1. 修正滑块事件方法的参数类型为float，匹配Slider事件的传参规则
2. 增加alpha字段与材质参数的同步逻辑，支持Inspector下修改参数实时生效
3. 直接将Slider的数值范围设置为0~1，去掉错误的除以250逻辑
4. 对传入的Alpha值做0~1范围钳制，避免非法值

触控板数值映射 #

用线性换算公式即可完成-1_1到01的范围映射：
mappedAlpha = (touchInputValue + 1f) / 2f

• 触控板输入-1时，映射结果为0（完全透明）
• 触控板输入0时，映射结果为0.5（半透明）
• 触控板输入1时，映射结果为1（完全不透明）

修复后完整代码 #

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;

public class ColorChange : MonoBehaviour
{
    public GameObject currentGameObject;
    [Range(0f, 1f)] public float alpha = 0.5f;
    private Material currentMat;
    public Slider slider;

    void Start()
    {
        currentGameObject = gameObject;
        // 获取Renderer的实例化材质，避免修改项目内的共享材质资源
        currentMat = currentGameObject.GetComponent<Renderer>().material;
        // 初始化滑块范围与默认值
        slider.minValue = 0f;
        slider.maxValue = 1f;
        slider.value = alpha;
        // 初始化材质默认透明度
        ChangeAlpha(currentMat, alpha);
        // 注册滑块值变更监听
        slider.onValueChanged.AddListener(ChangeAlphaOnValueChange);
    }

    void Update()
    {
        // 同步Inspector面板修改的alpha值到材质和滑块
        if (Mathf.Abs(currentMat.color.a - alpha) > 0.001f)
        {
            ChangeAlpha(currentMat, alpha);
            slider.value = alpha;
        }
    }

    void ChangeAlpha(Material mat, float alphaVal)
    {
        // 钳制Alpha值到合法范围
        alphaVal = Mathf.Clamp01(alphaVal);
        Color oldColor = mat.color;
        mat.color = new Color(oldColor.r, oldColor.g, oldColor.b, alphaVal);
    }

    // Slider事件绑定方法，参数为float类型的滑块当前值
    public void ChangeAlphaOnValueChange(float sliderValue)
    {
        alpha = sliderValue;
        ChangeAlpha(currentMat, alpha);
    }

    // 触控板输入调用该方法，传入-1~1范围的触控值即可
    public void SetAlphaFromTouch(float touchInput)
    {
        float mappedAlpha = Mathf.Clamp01((touchInput + 1f) / 2f);
        slider.value = mappedAlpha;
    }
}

配置注意事项 #

• 绑定Slider事件时，拖入挂载该脚本的对象，在下拉菜单中选择ColorChange -> ChangeAlphaOnValueChange (Single)选项，不要选错带Slider参数的重载
• 不要使用Renderer.sharedMaterial修改参数，否则会直接修改项目内的材质源文件，导致编辑器退出后参数永久变更
• 确认材质的Surface Type设置为Transparent，Render Queue自动分配为3000（透明队列）即可，无需手动调整

内容的提问来源于stack exchange，提问作者newdevnoob