在Unity中定义统一的对象搜索接口

最新推荐文章于 2025-06-03 00:56:36 发布

原创最新推荐文章于 2025-06-03 00:56:36 发布 · 1.1w 阅读

14 ·

CC 4.0 BY-SA版权

文章标签：

#Unity3d #搜索对象 #新手引导 #统一 #查找

Unity3D 同时被 2 个专栏收录

46 篇文章

订阅专栏

游戏开发

42 篇文章

订阅专栏

本文介绍了在Unity中如何使用统一的接口来搜索对象，包括按名字、tag、layer搜索，以及查找特定组件、迭代查找等方法，强调了这种方法在代码管理、配置和拓展方面的优势。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

我们经常要在Unity中以各种方式搜索对象。比如按名字搜索、按tag、layer或者是查找名字为xxx开头的对象。

本文是介绍以一种统一的接口来搜索对象。

1、定义统一的搜索接口

    /// <summary>
    /// 游戏对象搜索接口
    /// </summary>
    public interface IGameObjectFinder
    {
        /// <summary>
        /// 搜索
        /// </summary>
        /// <param name="root">搜索的开始位置/根节点</param>
        /// <param name="findResult">搜索存放的结果</param>
        void Find(Transform root, List<Transform> findResult);
    }

2、定义一个使用上面搜索接口的方法

public class Finder{

    /// <summary>
    /// 查找指定根节点下符合指定的查找器的Transform并保持到findResult中
    /// </summary>
    /// <param name="root"></param>
    /// <param name="findResult"></param>
    /// <param name="finder"></param>
    public static void Find(Transform root, List<Transform> findResult, IGameObjectFinder finder)
    {
        if (root == null)
        {
            throw new Exception("root can not be null, it defines the starting point of the find path");
        }

        if (findResult == null)
        {
            throw new Exception("findResult can not be null, it used to collect the find result");
        }

        if (finder == null)
        {
            throw new Exception("finder can not be null, it defines how to find transform");
        }
        finder.Find(root, findResult);
    }
}

可以看到，2步骤只是简单调用1的接口进行搜索。但是1只是接口，有啥用？接着看。

3、实现一个查找某个组件的接口

    /// <summary>
    /// 根据组件搜索
    /// </summary>
    /// <typeparam name="T"></typeparam>
    public class GameObjectFinderByComponent<T> : IGameObjectFinder where T : Component
    {
        public void Find(Transform root, List<Transform> findResult)
        {
            foreach (var componentsInChild in root.GetComponentsInChildren<T>())
            {
                findResult.Add(componentsInChild.transform);
            }
        }
    }

可以看到只要实现IGameObjectFinder就可以了。那么如果这时候想调用，应该怎么调用呢？

比如想查找transform下面的刚体组件，然后保存到result里面。只要：

Finder.Find(transform, result, new GameObjectFinderByComponent<Rigidbody>());

什么？看起来好像有点小题大作，直接用GetComponentsInChildren不就好吗？

先不急。我们继续看看其它查找需求。比如我想查找名字为xxx的对象。

4、实现一个迭代查找

首先，要查找指定节点下的某个名字的所有节点（不管深度多少），这个需要遍历。那么，我们可以先抽象出一个遍历的接口。

为了保证搜索的统一，那么我们还是从IGameObjectFinder中继承。

    /// <summary>
    /// 迭代遍历搜索
    /// </summary>
    public class GameObjectFinderByIteration : IGameObjectFinder
    {
        private IGameObjectFinderForIteration finderForIteration;
        public GameObjectFinderByIteration(IGameObjectFinderForIteration finderForIteration)
        {
            this.finderForIteration = finderForIteration;
        }

        public void Find(Transform root, List<Transform> findResult)
        {
            for (int i = 0, childCount = root.childCount; i < childCount; i++)
            {
                Transform t = root.GetChild(i);
                if (finderForIteration.isVaild(t))
                {
                    findResult.Add(t);
                }
                Find(t, findResult);
            }
        }
    }

这个代码的意思就是：我先把开始节点下面的每个子节点通过另一个接口IGameObjectFinderForIteration来判断是否符合要求，是的话则加入结果列表。然后继续查找这个子结点下的其他子节点。（该搜索是不包括第一个开始节点的）
IGameObjectFinderForIteration的接口也很简单：

    /// <summary>
    /// 迭代搜索判断
    /// </summary>
    public interface IGameObjectFinderForIteration
    {
        /// <summary>
        /// 指定节点是否合法
        /// </summary>
        /// <param name="node"></param>
        /// <returns></returns>
        bool isVaild(Transform node);
    }

好的，这样就意味着我们要想查找某个根节点下的所有子节点（包括直接和间接的），只要实现一个IGameObjectFinderForIteration。那么OK。看看怎么按名字搜索。

    /// <summary>
    /// 迭代遍历按名字搜索
    /// </summary>
    public class FinderForIterationByName : IGameObjectFinderForIteration
    {
        protected readonly string NAME;
        public FinderForIterationByName(string name)
        {
            NAME = name;
        }

        public bool isVaild(Transform getChild)
        {
            return getChild.gameObject.name.Equals(NAME);
        }
    }

使用也很简单，加入想找transform节点下，名字为“abc”的对象，并保存在result列表里面。只要这样：

Finder.Find(transform, result, new GameObjectFinderByIteration(new FinderForIterationByName("abc")));