【Unity游戏开发】UGUI不规则区域点击的实现

一、简介

　　马三从上一家公司离职了，最近一直在出去面试，忙得很，所以这一篇博客拖到现在才写出来。马三在上家公司工作的时候，曾处理了一个UGUI不规则区域点击的问题，制作过程中也有一些收获和需要注意坑，因此记录成博客与大家分享。众所周知在UGUI中，响应点击通常是依附在一张图片上的，而图片不管美术怎么给你切，导进Unity之后都是一个矩形，如果要做其他形状，最多只能旋转一下，或者自己做一些处理。而为了美术效果，很多时候我们不得不需要特定形状的UI，并且让它们实现精准的响应点击。例如下图就是一个不规则的点击区域。

^{图1：UGUI不规则点击区域示意图}

　　下面是处理了不规则区域点击后的演示效果，当点击按钮的时候，会对点击次数进行累加并且打印到控制台。可以看到进行了不规则区域点击处理以后，对我们原来的普通矩形Sprite的点击不会产生到影响，而不规则区域的表现效果也符合我们的预期。

^{图2：规则区域与不规则区域点击效果对比}

二、针对UGUI不规则区域点击的两种处理方法

　　针对UGUI的不规则区域响应点击，一般来说有两种处理办法：

　　1.精灵像素检测：该方法是指通过读取精灵(Sprite)在某一点的像素值(RGBA)，如果该点的像素值中的Alpha小于一定的阈值（比如0.5）则表示该点处是透明的，即用户点击的位置在精灵边界以外，否则用户点击的位置在精灵边界内部。

　　2.通过算法计算碰撞区域：通过一定的算法，手动计算出碰撞区域，然后在判断用户是点击在了精灵上面，还是点击在精灵外部。

1.精灵像素检测法

　　首先来说下精灵像素检测法，因为它实现起来比较简单也好理解。uGUI在处理控件是否被点击的时候，主要是根据IsRaycastLocationValid这个方法的返回值来进行判断的，而这个方法用到的基本原理则是判断指定点对应像素的RGBA数值中的Alpha是否大于某个指定临界值。例如，我们知道半透明通常是指Alpha=0.5，而对一个后缀名为png格式的图片来说半透明或者完全透明的区域理论上不应该被响应的，所以根据这个原理，我们只需要设定一个透明度的临界值，然后对当前鼠标位置对应的像素进行判断就可以了，因此这种方法叫做精灵像素检测。对于上面的这个IsRaycastLocationValid接口，我们可以通过下载UGUI源码或者反编译的方式看到它的实现：

 public virtual bool IsRaycastLocationValid(Vector2 screenPoint, Camera eventCamera)
 {
     //当透明度>=1.0时，表示点击在可响应区域返回true
     if(this.m_EventAlphaThreshold >= 1f){
         return true;
     }
 
     //当没有指定精灵时返回true，因为不指定Spirte的时候，Unity将其区域填充为默认的白色，全部区域都是可以响应点击的
     Sprite overrideSprite = this.overrideSprite;
     if(overrideSprite == null){
         return true;
     }
 
     //坐标系转换
     Vector2 local;
     RectTransformUtility.ScreenPointToLocalPointInRectangle(base.rectTransform, screenPoint, eventCamera, ref local);
     Rect pixelAdjustedRect = base.GetPixelAdjustedRect ();
     local.x += base.rectTransform.get_pivot ().x * pixelAdjustedRect.get_width ();
     local.y += base.rectTransform.get_pivot ().y * pixelAdjustedRect.get_height ();
     local = this.MapCoordinate(local, pixelAdjustedRect);
     Rect textureRect = overrideSprite.get_textureRect ();
     Vector2 vector = new Vector2(local.x / textureRect.get_width (), local.y / textureRect.get_height ());
 
     //计算屏幕坐标对应的UV坐标
     float num = Mathf.Lerp(textureRect.get_x (), textureRect.get_xMax (), vector.x) / (float)overrideSprite.get_texture().get_width();
     float num2 = Mathf.Lerp(textureRect.get_y (), textureRect.get_yMax (), vector.y) / (float)overrideSprite.get_texture().get_height();
     bool result;
 
     //核心方法：像素检测
     try{
         result = (overrideSprite.get_texture().GetPixelBilinear(num, num2).a >= this.m_EventAlphaThreshold);
     }catch(UnityException ex){
         Debug.LogError("Using clickAlphaThreshold lower than 1 on Image whose sprite texture cannot be read. " + ex.Message + " Also make sure to disable sprite packing for this sprite.", this);
         result = true;
     }
 
     return result;
 }

　　可以看到大概的思路就是经过一系列的坐标转换之后，将一个UV坐标的Alpha值与临界值作比较。基于这个像素这个思路我们又可以衍生出两种解决方案，一是直接更改临界值，二是在像素检测的思路上进行拓展与重写，定制我们自己的像素检测方法。

　　先来看下第一种直接更改阈值的方法，Unity在Image组件中为我们暴露出了一条属性alphaHitTestMinimumThreshold。关于它的含义我们可以参考Unity的官方文档：

　　　^{图3：alphaHitTestMinimumThreshold属性文档}

　　大概的意思就是点击的时候会将该像素的Alpah值与该阈值进行比较，Alpha小于该阈值的部分的点击事件会被忽略掉，意思也就是某一像素的Alpha只有大于设定的阈值，你才能接到响应事件。当值为1的时候，表示只有完全不透明的部分才能响应。默认值为0，即一个Image不管透明不透明的部分，都会参与事件的响应。为了能够让alphaHitTestMinimumThreshold这个属性生效和工作，我们需要把Advance选项中的Read/Writeable属性勾选上。

　　因此我们将alphaHitTestMinimumThreshold值设置为一个合理的范围就可以实现不规则区域的点击了，代码如下：

 using System.Collections;
 using System.Collections.Generic;
 using UnityEngine;
 using UnityEngine.UI;
 
 /// <summary>
 /// 不规则区域Button
 /// </summary>
 [RequireComponent(typeof(RectTransform))]
 [RequireComponent(typeof(Image))]
 public class IrregulaButton : MonoBehaviour
 {
     [Tooltip("设定Sprite响应的Alpha阈值")]
     [Range(, 0.5f)]
     public float alpahThreshold = 0.5f;
 
     private void Awake()
     {
         var image = this.GetComponent<Image>();
         if (null != image)
         {
             image.alphaHitTestMinimumThreshold = alpahThreshold;
         }
     }
 }

　　第二种基于像素检测的解决方案是自己重写IsRaycastLocationValid接口里面像素检测方法，将屏幕坐标转换为UI坐标，然后再根据Sprite的类型做一些处理，最后根据x,y坐标取出像素的Alpha值与我们的阈值进行比较，具体代码如下：

using UnityEngine;
using UnityEngine.UI;
 
/// <summary>
/// 不规则区域图形检测组件
/// </summary>
[RequireComponent(typeof(RectTransform))]
[RequireComponent(typeof(Image))]
public class IrregularRaycastMask : MonoBehaviour, ICanvasRaycastFilter
{
    private Image _image;
    private Sprite _sprite;
 
    [Tooltip("设定Sprite响应的Alpha阈值")]
    [Range(, 0.5f)]
    public float alpahThreshold = 0.5f;
 
    void Start()
    {
        _image = GetComponent<Image>();
    }
 
    /// <summary>
    /// 重写IsRaycastLocationValid接口
    /// </summary>
    /// <param name="sp"></param>
    /// <param name="eventCamera"></param>
    /// <returns></returns>
    public bool IsRaycastLocationValid(Vector2 sp, Camera eventCamera)
    {
        _sprite = _image.sprite;
 
        var rectTransform = (RectTransform)transform;
        Vector2 localPositionPivotRelative;
        RectTransformUtility.ScreenPointToLocalPointInRectangle((RectTransform)transform, sp, eventCamera, out localPositionPivotRelative);
 
        // 转换为以屏幕左下角为原点的坐标系
        var localPosition = new Vector2(localPositionPivotRelative.x + rectTransform.pivot.x * rectTransform.rect.width,
            localPositionPivotRelative.y + rectTransform.pivot.y * rectTransform.rect.height);
 
        var spriteRect = _sprite.textureRect;
        var maskRect = rectTransform.rect;
 
        var x = ;
        var y = ;
        // 转换为纹理空间坐标
        switch (_image.type)
        {
 
            case Image.Type.Sliced:
                {
                    var border = _sprite.border;
                    // x 轴裁剪
                    if (localPosition.x < border.x)
                    {
                        x = Mathf.FloorToInt(spriteRect.x + localPosition.x);
                    }
                    else if (localPosition.x > maskRect.width - border.z)
                    {
                        x = Mathf.FloorToInt(spriteRect.x + spriteRect.width - (maskRect.width - localPosition.x));
                    }
                    else
                    {
                        x = Mathf.FloorToInt(spriteRect.x + border.x +
                                             ((localPosition.x - border.x) /
                                             (maskRect.width - border.x - border.z)) *
                                             (spriteRect.width - border.x - border.z));
                    }
                    // y 轴裁剪
                    if (localPosition.y < border.y)
                    {
                        y = Mathf.FloorToInt(spriteRect.y + localPosition.y);
                    }
                    else if (localPosition.y > maskRect.height - border.w)
                    {
                        y = Mathf.FloorToInt(spriteRect.y + spriteRect.height - (maskRect.height - localPosition.y));
                    }
                    else
                    {
                        y = Mathf.FloorToInt(spriteRect.y + border.y +
                                             ((localPosition.y - border.y) /
                                             (maskRect.height - border.y - border.w)) *
                                             (spriteRect.height - border.y - border.w));
                    }
                }
                break;
            case Image.Type.Simple:
            default:
                {
                    // 转换为统一UV空间
                    x = Mathf.FloorToInt(spriteRect.x + spriteRect.width * localPosition.x / maskRect.width);
                    y = Mathf.FloorToInt(spriteRect.y + spriteRect.height * localPosition.y / maskRect.height);
                }
                break;
        }
 
        // 如果texture导入过程报错，则删除组件
        try
        {
            return _sprite.texture.GetPixel(x, y).a > alpahThreshold;
        }
        catch (UnityException e)
        {
            Debug.LogError("Mask texture not readable, set your sprite to Texture Type 'Advanced' and check 'Read/Write Enabled'" + e.Message);
            Destroy(this);
            return false;
        }
    }
}

　　最后为了验证我们的组件是否生效，可以在按钮上挂载一个ButtonClickCounter 脚本，当接收到点击事件的时候，记录点击次数并打印到控制台方便观察，具体代码如下：

 using System.Collections;
 using System.Collections.Generic;
 using UnityEngine;
 using UnityEngine.UI;
 
 /// <summary>
 /// 按钮点击次数计数器
 /// </summary>
 public class ButtonClickCounter : MonoBehaviour
 {
     private int count = ;
     private string btnName;
 
     void Start()
     {
         var text = this.transform.Find("Text").GetComponent<Text>();
         btnName = text.text;
     }
 
     public void Click()
     {
         count++;
         Debug.Log(string.Format("{0}点击了{1}次！", btnName, count));
     }
 }

　　我们只要简单地直接把组件挂载到Image上面便可以生效了，具体截图如下：

^{图4：不规则区域检测组件使用}

2.通过算法计算碰撞区域法

　　对于这种实现不规则碰撞区域的方法，马三并没有进行深入地研究，因为马三觉得挑选一个可靠的检测碰撞算法不是很容易，既要考虑到它的精准性又要考虑当图形复杂以后的计算效率，因此从易用性上面来讲，不如第一种实现方案好。关于这种方法的实现和原理，马三也是从网上搜集的一些资料进行整理的，感兴趣的读者可以深入研究一下哈，下面很多内容都是马三搜集整理网上大神的文章的资料得来的，其中给出了许多链接，大家可以直接参看链接里面的内容。

　　该方法是指给精灵(Sprite)添加一个多边形碰撞器(Rolygon Collider)组件，利用该组件来标记精灵的边界，这样通过比较鼠标位置和边界可以判断点击是否发生在精灵内部。关于这个算法与实现，PayneQin大神已经在他的博客中做了很详细的解析和说明，大家可以直接去看他的博客。知乎上关于判断一个点是否在多边形内部也有很多算法地讨论，具体可以看这里。其中这篇文献提供了判断一个点是否在任意多边形内部的两种方法，分别为Corssing Number和Winding Number。这两种方法在理论层面的相关细节请大家自行阅读这篇文章，PayneQin大神选择的是前者实现，其基本思想是计算从该点引出的射线与多边形边界相交的次数，当其为奇数时表示该点在多边形内部，当其为偶数时表示在多边形外部。马三在网上找到了相关的实现(偷懒)：

 bool ContainsPoint2(Vector2[] polyPoints,Vector2 p)
 {
     //统计射线和多边形交叉次数
     int cn = ;
 
     //遍历多边形顶点数组中的每条边
     for(int i=; i<polyPoints.Length-; i++)
     {
         //正常情况下这一步骤可以忽略这里是为了统一坐标系
         polyPoints [i].x += transform.GetComponent<RectTransform> ().position.x;
         polyPoints [i].y += transform.GetComponent<RectTransform> ().position.y;
 
         //从当前位置发射向上向下两条射线
         if(((polyPoints [i].y <= p.y) && (polyPoints [i + ].y > p.y))
             || ((polyPoints [i].y > p.y) && (polyPoints [i + ].y <= p.y)))
         {
             //compute the actual edge-ray intersect x-coordinate
             float vt = (float)(p.y - polyPoints [i].y) / (polyPoints [i + ].y - polyPoints [i].y);
 
             //p.x < intersect
             if(p.x < polyPoints [i].x + vt * (polyPoints [i + ].x - polyPoints [i].x))
                 ++cn;
         }
     }
 
     //实际测试发现cn为0的情况即为宣雨松算法中存在的问题
     //所以在这里进行屏蔽直接返回false这样就可以让透明区域不再响应
     if(cn == )
         return false;
 
     //返回true表示在多边形外部否则表示在多边形内部
     return cn %  == ;
 }

　　基于上面算法制作的多边形碰撞器实现的不规则按钮，以正五边形举例（PayneQin大神实现，马三只是搬运工）：

 /*
  * 基于多边形碰撞器实现的不规则按钮
  * 作者：PayneQin
  * 日期：2016年7月9日
  */
 
 using UnityEngine;
 using System.Collections;
 using UnityEngine.UI;
 using UnityEngine.EventSystems;
 
 public class UnregularButtonWithCollider : MonoBehaviour,IPointerClickHandler
 {
     /// <summary>
     /// 多边形碰撞器
     /// </summary>
     PolygonCollider2D polygonCollider;
 
     void Start()
     {
         //获取多边形碰撞器
         polygonCollider = transform.GetComponent<PolygonCollider2D>();
     }
 
     public void OnPointerClick(PointerEventData eventData)
     {
         //对2D屏幕坐标系进行转换
         Vector2 local;
         local.x = eventData.position.x - (float)Screen.width / 2.0f;
         local.y = eventData.position.y - (float)Screen.height / 2.0f;
         if(ContainsPoint(polygonCollider.points,local))
         {
 
             Debug.Log ("这是一个正五边形!");
         }
 
     }
 
     /// <summary>
     /// 判断指定点是否在给定的任意多边形内
     /// </summary>
     bool ContainsPoint(Vector2[] polyPoints,Vector2 p)
     {
         //统计射线和多边形交叉次数
         int cn = ;
 
         //遍历多边形顶点数组中的每条边
         for(int i=; i<polyPoints.Length-; i++)
         {
             //正常情况下这一步骤可以忽略这里是为了统一坐标系
             polyPoints [i].x += transform.GetComponent<RectTransform> ().position.x;
             polyPoints [i].y += transform.GetComponent<RectTransform> ().position.y;
 
             //从当前位置发射向上向下两条射线
             if(((polyPoints [i].y <= p.y) && (polyPoints [i + ].y > p.y))
                || ((polyPoints [i].y > p.y) && (polyPoints [i + ].y <= p.y)))
             {
                 //compute the actual edge-ray intersect x-coordinate
                 float vt = (float)(p.y - polyPoints [i].y) / (polyPoints [i + ].y - polyPoints [i].y);
 
                 //p.x < intersect
                 if(p.x < polyPoints [i].x + vt * (polyPoints [i + ].x - polyPoints [i].x))
                     ++cn;
             }
 
         }
 
         //实际测试发现cn为0的情况即为宣雨松算法中存在的问题
         //所以在这里进行屏蔽直接返回false这样就可以让透明区域不再响应
         if(cn == )
             return false;
 
         //返回true表示在多边形外部否则表示在多边形内部
         return cn %  == ;
     }

三、需要注意的坑

　　在像素检测法实现UGUI不规则碰撞区域的过程中，马三也遇到了很多需要注意的问题，在这里和大家分享一下：

1.图片需要开启Read/Writeable属性

　　如果选择使用像素检测法实现的话，需要注意开启Texture的Read/Writeable属性（我们需要读写该Texture的像素值），而且他必须是Advance类型。这样这张图片就不能打进我们的图集里面了，必须以散图的形式存在于工程当中，不利于统一管理。而且开启了Read/Writeable属性属性的话，在程序运行的时候，它会在内存中多复制出来一份，必然会影响到游戏的运行效率。所以尽量还是减少游戏中这种不规则UI的出现。

2.像素检测有偏移，不准确的问题

　　马三在实际操作的过程中，发现实际点击的时候经常会有偏移（经常偏下一些），有的透明的地方可以点击，而明明是不透明的地方却不能点击。刚开始马三还以为是图片格式或者是图片本身有什么问题，反反复复确认了好多次。直到后来马三在unity论坛上找到了这篇文章，才找到问题的症结所在。

　　对于如下图所示的这种周围有空白区域的图片，我们需要在Unity图片导入设置的时候，将Mesh Type格式设置为Full Rect，而unity导入时默认帮我们设置的是Tight模式。

         

^{图5：周围有空白的图片                                                                                     图6：正确的导入设置}

　　那么，它们有什么区别呢？关于它们的区别，Unity官方是这样解释的：

^{图7：Full Rect和Tight两种Mesh Type的官方解释}

　　总的来说就是，用Tight模式的话，如果你的图片周围有空白像素，它会帮你压缩掉减小面积，以减少DrawCall，但是会增加Sprite的面数。如果用Full Rect模式不会压缩，也不会增加面数，直接创建一个quab，然后把图片扔上去。如果尺寸小于32x32的话，Unity默认使用Full Rect格式导入，否则使用Tight格式导入。因此如果我们不对Mesh Type进行设置的话，原来的一些空白区域就相当于裁剪掉了，这样相对于左下角的坐标来说，一些像素坐标就发生了偏移，而我们使用的是像素检测方法，必然也会导致偏移误差。

四、总结

　　通过本篇博客，马三和大家一起学习了如何在Unity中实现UGUI不规则区域的点击，希望本篇博客能为大家的工作过程中带来一些帮助与启发。

　　本篇博客中的样例工程已经同步至Github:https://github.com/XINCGer/Unity3DTraining/tree/master/SomeTest/IrregularButton，欢迎大家Fork!

　　如果觉得本篇博客对您有帮助，可以扫码小小地鼓励下马三，马三会写出更多的好文章，支持微信和支付宝哟！

　      

参考资料：

• https://blog.csdn.net/qinyuanpei/article/details/51868638
• https://blog.csdn.net/shenmifangke/article/details/53504036
• https://www.zhihu.com/question/26551754?f3fb8ead20=b6b9d1289bcc893ff2fa0abd1e65fc52

作者：马三小伙儿
出处：https://www.cnblogs.com/msxh/p/9283266.html
请尊重别人的劳动成果，让分享成为一种美德，欢迎转载。另外，文章在表述和代码方面如有不妥之处，欢迎批评指正。留下你的脚印，欢迎评论！