Unity通用交互UI文本淡入淡出实现及CrossFadeAlpha失效排查

• 核心失效原因：每帧重复调用CrossFadeAlpha会直接重置渐变计时器，永远无法完成淡入/淡出流程
  你用Input.GetKey检测按键，按住F期间每帧都会触发一次CrossFadeAlpha(1,2f,false)，相当于每帧把淡入进度清0，最终表现就是方法完全不生效。如果坚持用CrossFadeAlpha，只需要在Input.GetKeyDown的判断里调用一次即可，不要每帧触发。
• 按键检测逻辑错误：应该用Input.GetKeyDown触发单次交互，避免按住按键重复跑逻辑
• 缺少“淡入完成后停留数秒自动淡出”的核心逻辑
• 未实现需求中的Vector3文本偏移配置
• 文本没有和交互物体做位置绑定，物体移动后文本会脱离对应位置

采用协程控制淡入、停留、淡出全流程，不再依赖逐帧调用的渐变方法，稳定性更高，可直接挂载到任意可交互物体上，所有参数均可在Inspector调整。

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

[RequireComponent(typeof(Collider))] // 可交互物体需携带碰撞体做范围检测
public class GenericInteractable : MonoBehaviour
{
    [Header("交互基础配置")]
    [Tooltip("玩家所在的层级")]
    public LayerMask playerMask;
    [Tooltip("触发交互的检测半径")]
    public float interactRadius = 1.5f;
    [Tooltip("交互键位")]
    public KeyCode interactKey = KeyCode.F;

    [Header("提示文本配置")]
    [Tooltip("要显示的提示文本")]
    public Text interactText;
    [Tooltip("文本相对于交互物体的位置偏移")]
    public Vector3 textOffset = new Vector3(0, 2f, 0);
    [Tooltip("淡入时长(秒)")]
    public float fadeInDuration = 0.5f;
    [Tooltip("文本停留时长(秒)")]
    public float stayDuration = 2f;
    [Tooltip("淡出时长(秒)")]
    public float fadeOutDuration = 0.5f;

    private bool isPlayerInRange;
    private Coroutine currentTextCoroutine;
    private Color originalTextColor;

    private void Start()
    {
        // 初始化时将文本透明度设为0
        originalTextColor = interactText.color;
        originalTextColor.a = 0;
        interactText.color = originalTextColor;
        // 绑定文本初始位置
        UpdateTextPosition();
    }

    private void Update()
    {
        // 实时检测玩家是否在交互范围内
        isPlayerInRange = Physics.CheckSphere(transform.position, interactRadius, playerMask);
        
        // 玩家在范围内且按下交互键时，触发文本显示流程
        if (isPlayerInRange && Input.GetKeyDown(interactKey))
        {
            // 停止之前未完成的文本协程，避免逻辑冲突
            if (currentTextCoroutine != null) StopCoroutine(currentTextCoroutine);
            currentTextCoroutine = StartCoroutine(ShowTextFlow());
        }

        // 玩家离开范围时强制将文本淡出
        if (!isPlayerInRange && interactText.color.a > 0)
        {
            if (currentTextCoroutine != null) StopCoroutine(currentTextCoroutine);
            currentTextCoroutine = StartCoroutine(FadeText(0));
        }

        // 交互物体移动时实时更新文本位置
        UpdateTextPosition();
    }

    // 文本完整生命周期：淡入 -> 停留 -> 自动淡出
    private IEnumerator ShowTextFlow()
    {
        yield return FadeText(1);
        yield return new WaitForSeconds(stayDuration);
        yield return FadeText(0);
    }

    // 通用淡入淡出控制
    private IEnumerator FadeText(float targetAlpha)
    {
        float startAlpha = interactText.color.a;
        float timer = 0;
        // 自动匹配对应渐变的时长：淡入用淡入参数，淡出用淡出参数
        float duration = targetAlpha > startAlpha ? fadeInDuration : fadeOutDuration;

        while (timer < duration)
        {
            timer += Time.deltaTime;
            float newAlpha = Mathf.Lerp(startAlpha, targetAlpha, timer / duration);
            Color tempColor = interactText.color;
            tempColor.a = newAlpha;
            interactText.color = tempColor;
            yield return null;
        }

        // 强制设置目标透明度，避免浮点精度问题卡进度
        Color finalColor = interactText.color;
        finalColor.a = targetAlpha;
        interactText.color = finalColor;
    }

    // 自动适配世界空间/屏幕空间的文本位置，跟随交互物体加偏移
    private void UpdateTextPosition()
    {
        if (interactText == null) return;
        // 世界空间UI直接使用世界坐标计算
        if (interactText.rectTransform.parent == null)
        {
            interactText.transform.position = transform.position + textOffset;
        }
        // 屏幕空间UI将世界坐标转屏幕坐标绑定
        else
        {
            Vector3 screenPos = Camera.main.WorldToScreenPoint(transform.position + textOffset);
            interactText.rectTransform.position = screenPos;
        }
    }

    // 在Scene视图可视化交互半径，方便调试
    private void OnDrawGizmosSelected()
    {
        Gizmos.color = Color.yellow;
        Gizmos.DrawWireSphere(transform.position, interactRadius);
    }
}

• 脚本直接挂载到桌椅等可交互物体上即可使用，无需额外适配
• 把需要的提示Text拖入配置项，通过textOffset参数即可灵活调整文本在物体周边的位置
• 所有时长、半径、键位参数均可在Inspector直接调整，不需要修改代码
• 选中物体时Scene视图会显示黄色线框的交互半径，方便快速调整检测范围
• 不需要文本跟随物体移动时，直接删除UpdateTextPosition的调用即可

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