1. 项目概述与核心价值在Unity开发中尤其是涉及到移动端、AR/VR或者打包成WebGL、小游戏的项目有一个痛点几乎每个开发者都遇到过当游戏在真机或者打包后的环境下运行时传统的Inspector面板消失了。你无法像在编辑器里那样实时查看一个游戏对象的Transform、脚本变量更别提动态修改它们了。想象一下美术同学在测试机上觉得某个特效的位置差了一点点或者策划想微调一下某个怪物的血量你难道要让他们给你描述然后你猜着改代码、重新打包、再安装测试吗这个流程效率低得令人抓狂。这就是Runtime Inspector运行时检视器插件存在的意义。它让你能在游戏运行状态下在游戏画面内直接呼出一个类似Editor Inspector的面板实时查看和修改场景中任何游戏对象的组件和属性。今天要聊的这个“UnityRuntimeInspector”就是社区里一个非常流行且强大的开源解决方案。它不仅仅是一个调试工具更是连接开发、测试、甚至部分策划/美术需求的桥梁。通过这篇教程我将带你用5个核心步骤从零开始将它集成到你的项目中并实现游戏对象的实时调试。无论你是想快速定位线上Bug还是为团队搭建一个便捷的调参工具这套方案都值得你花时间掌握。2. 核心思路与方案选型在动手之前我们先理清思路。实现运行时调试本质上需要解决几个问题如何捕获场景中的对象如何动态生成UI来反射对象的属性信息如何实现属性的双向绑定即UI修改能同步到对象对象变化能更新UI市面上有不少Runtime Inspector方案比如付费的“Runtime Editor”套装或者一些轻量级的自己写的脚本。我们选择“UnityRuntimeInspector”这个开源项目主要是基于以下几点考量1. 功能全面且稳定它不仅仅支持查看基本类型int, float, string, bool还支持枚举、数组、列表、甚至自定义的Class和Struct。对于Unity特有的类型如Vector3、Color、GameObject引用它都提供了友好的UI比如颜色选择器、对象拖拽赋值。其Hierarchy面板还能实时显示场景中的对象树这对于在复杂场景中定位目标非常有用。2. 性能与兼容性平衡得好它使用C#的反射Reflection和PropertyDrawer的思路来动态构建UI虽然反射有一定开销但作者做了很多优化比如缓存、懒加载等在实际使用中只要不在一帧内刷新成百上千个属性性能是完全可接受的。它不依赖任何特殊的Unity新版本API兼容性从较旧的Unity版本到最新的LTS版本都表现良好。3. 高度可定制化整个UI是基于Unity的UGUI构建的这意味着你可以像修改普通UI一样修改它的字体、颜色、布局。更重要的是你可以通过继承特定的接口为你的自定义数据类型编写专属的绘制器RuntimeInspectorDrawer让它完全融入你的开发工作流。4. 活跃的社区与清晰的授权项目在GitHub上维护Issues和PR都比较活跃遇到问题有地方可寻。采用MIT许可证允许你在商业项目中自由使用、修改和分发。基于这些优点我们的技术路线就明确了集成这个开源库然后通过几个关键步骤将其核心功能与我们的游戏逻辑连接起来最终实现一个可通过热键或UI按钮触发、能够浏览和修改任意游戏对象的运行时调试面板。3. 环境准备与插件集成3.1 获取Runtime Inspector插件首先你需要获取“UnityRuntimeInspector”的源代码。最推荐的方式是通过Unity的Package Manager从Git URL添加这样便于后续更新。打开你的Unity项目建议使用2019.4 LTS或更新版本。打开Window Package Manager。点击左上角的“”按钮选择“Add package from git URL...”。输入该仓库的URL请注意由于网络环境你可能需要确认可访问的仓库地址。通常开源库会托管在GitHub上。一个常见的有效地址格式是https://github.com/yasirkula/UnityRuntimeInspector.git。你也可以先下载ZIP包然后通过Add package from tarball...来添加。点击“Add”。Unity会下载并导入这个包。导入后你可以在Package Manager中看到“Runtime Inspector”这个包。注意直接从Git导入要求你的Unity版本支持该功能且网络通畅。如果失败可以去GitHub发布页面下载最新的.unitypackage文件通过Assets Import Package Custom Package...进行传统导入。导入后所有相关脚本和预制体通常会在Assets/Plugins/RuntimeInspector或类似的目录下。3.2 基础场景与UI设置插件导入后它并不会自动出现在你的游戏里。我们需要手动创建一个用于承载调试面板的Canvas。在Hierarchy中右键选择UI Canvas。这将创建一个默认的CanvasEvent Camera可能会被自动设置。为了让调试面板在所有场景中持久存在且方便管理我通常会将这个Canvas做成一个单例预制体。右键Canvas选择Create Empty Child命名为“RuntimeDebugger”或类似的名字。将RuntimeInspector插件提供的预制体拖入这个空节点下。你可以在项目窗口中搜索“RuntimeInspector”或“RuntimeHierarchy”来找到它们。通常核心预制体叫做RuntimeInspectorCanvas或RuntimeInspector。拖入后你可能会看到一个已经布局好的面板。调整这个Canvas的渲染模式。对于全屏调试使用Screen Space - Overlay最简单。如果希望调试面板不影响游戏画面的渲染顺序比如被3D物体遮挡可以使用Screen Space - Camera并指定一个专门的UI摄像机。关键一步找到刚刚拖入的RuntimeInspector预制体实例在其Inspector面板上通常有一个Runtime Inspector或RuntimeHierarchy组件。这里有一个Canvas字段需要将它拖拽赋值为你刚创建的Canvas根节点。这一步是确保UI事件正确传递的关键。至此你的场景里已经有了一个隐藏的调试面板骨架。接下来就是让它“活”起来。4. 核心功能实现与脚本编写4.1 创建调试管理器单例为了全局控制调试面板的显示、隐藏以及目标对象的指定我们需要一个管理器脚本。使用单例模式可以方便地从任何地方访问。using UnityEngine; using RuntimeInspectorNamespace; // 引入插件的命名空间 public class RuntimeDebugManager : MonoBehaviour { public static RuntimeDebugManager Instance { get; private set; } [SerializeField] private RuntimeInspector runtimeInspector; // 拖拽赋值 [SerializeField] private RuntimeHierarchy runtimeHierarchy; // 拖拽赋值如果需要层次面板 [SerializeField] private Canvas debugCanvas; // 整个调试UI的Canvas [Header(Toggle Settings)] public KeyCode toggleKey KeyCode.F1; // 默认切换键 public bool startHidden true; // 启动时是否隐藏 private void Awake() { if (Instance ! null Instance ! this) { Destroy(gameObject); return; } Instance this; DontDestroyOnLoad(gameObject); // 跨场景不销毁 if (startHidden debugCanvas ! null) { debugCanvas.gameObject.SetActive(false); } } private void Update() { if (Input.GetKeyDown(toggleKey)) { ToggleDebugPanel(); } } public void ToggleDebugPanel() { if (debugCanvas ! null) { bool isActive !debugCanvas.gameObject.activeSelf; debugCanvas.gameObject.SetActive(isActive); // 面板显示时可以做一些初始化比如选中当前主摄像机 if (isActive runtimeInspector ! null Camera.main ! null) { runtimeInspector.Inspect(Camera.main.gameObject); } } } // 供其他脚本调用的方法检查指定对象 public void InspectObject(GameObject obj) { if (runtimeInspector ! null obj ! null) { if (!debugCanvas.gameObject.activeSelf) { debugCanvas.gameObject.SetActive(true); } runtimeInspector.Inspect(obj); } } // 供其他脚本调用的方法检查指定组件 public void InspectComponent(Component component) { if (runtimeInspector ! null component ! null) { if (!debugCanvas.gameObject.activeSelf) { debugCanvas.gameObject.SetActive(true); } runtimeInspector.Inspect(component); } } }将这个脚本挂载到场景中一个不会被销毁的GameObject上比如就叫RuntimeDebugManager然后将前面步骤中创建好的RuntimeInspector组件、RuntimeHierarchy组件如果有和Canvas分别拖拽到脚本的对应字段中。4.2 连接Hierarchy与Inspector如果你同时使用了RuntimeHierarchy运行时层次结构面板通常需要将它和RuntimeInspector关联起来实现点击Hierarchy中的对象Inspector面板就显示其详情的功能。在Hierarchy中找到你的RuntimeHierarchy预制体实例。在其组件上找到一个名为Inspector或Connected Inspector的字段。将你的RuntimeInspector实例拖拽赋值给它。同样在RuntimeInspector组件上可能也有一个Hierarchy字段可以将RuntimeHierarchy实例赋值给它实现双向选择同步。这样当你在运行时点击Hierarchy面板中的任意一个游戏对象右侧的Inspector面板就会自动刷新显示该对象的所有组件和属性。4.3 实现对象选择与过滤默认情况下RuntimeHierarchy会显示场景中的所有对象包括很多系统对象如EventSystem, DontDestroyOnLoad容器等。我们可能需要过滤掉一些不重要的对象或者只显示我们关心的对象。你可以通过脚本动态设置RuntimeHierarchy的Root Object。例如如果你只想调试某个特定管理节点下的所有对象// 在RuntimeDebugManager中增加方法 public void SetHierarchyRoot(GameObject root) { if (runtimeHierarchy ! null) { runtimeHierarchy.RootObject root; // 只显示root及其子对象 // 或者使用 runtimeHierarchy.Refresh() 强制刷新 } }更高级的过滤可以通过继承RuntimeHierarchy并重写其bool IsGameObjectExcludedFromHierarchy(GameObject go)方法来实现根据对象的名称、标签、层或者是否包含特定组件来决定是否显示。5. 高级功能与自定义扩展5.1 为自定义数据类型创建Drawer这是发挥RuntimeInspector威力的关键。假设你有一个自定义的玩家数据类[System.Serializable] public class PlayerStats { public string playerName; public int level; public float health; public Vector3 spawnPosition; }当这个类作为某个MonoBehaviour的公共字段出现时默认RuntimeInspector会将其展开显示其内部字段这已经很有用了。但如果你想为它创建一个更美观、更集成的UI比如用一个滑块来表示血量就需要自定义Drawer。创建一个新的C#脚本继承自RuntimeInspectorNamespace.RuntimeInspectorCustomEditor或者类似的基类具体类名请查看插件文档。重写相应的方法。以下是一个简化示例using RuntimeInspectorNamespace; using UnityEngine; using UnityEngine.UI; // 这个特性告诉RuntimeInspector这个Drawer用于绘制PlayerStats类型 [CustomEditor(typeof(PlayerStats))] public class PlayerStatsDrawer : RuntimeInspectorCustomEditor { // 当需要为PlayerStats创建UI时调用 protected override void CreateEditor(Transform parent, object value) { // 调用基类方法创建默认的字段展开UI base.CreateEditor(parent, value); // 你也可以在这里添加自定义的UI元素 // 例如在默认UI下方加一个按钮 GameObject customButton new GameObject(CustomButton); customButton.transform.SetParent(parent, false); Button btn customButton.AddComponentButton(); Text txt customButton.AddComponentText(); txt.text 重置状态; btn.onClick.AddListener(() { PlayerStats stats (PlayerStats)value; stats.health 100f; Refresh(); // 通知Inspector刷新显示 }); } // 当Inspector刷新时更新你的自定义UI protected override void UpdateEditor() { base.UpdateEditor(); // 如果需要在这里更新自定义UI的状态 } }编写完Drawer后RuntimeInspector在遇到PlayerStats类型的字段时会自动使用你的自定义绘制逻辑。5.2 属性暴露与隐私控制默认情况下RuntimeInspector通过反射获取所有公共字段和属性。但你可能不希望所有内部变量都被暴露。有几种控制方式使用[NonSerialized]或[HideInInspector]特性这是Unity的标准特性可以阻止字段在默认的Inspector和RuntimeInspector中显示。使用插件的特性RuntimeInspector可能提供了自己的特性比如[InspectorExclude]或[InspectorReadOnly]你需要在插件文档中确认。这些特性可以更精确地控制运行时调试时的可见性与可编辑性。通过代码动态排除你可以订阅RuntimeInspector的BeforeExposingMember或类似事件在成员被暴露到UI之前进行判断和过滤。5.3 集成到移动设备与触控操作在手机或平板设备上你需要一种方式来呼出调试面板因为物理键盘可能不存在。触控手势呼出修改RuntimeDebugManager的Update方法检测特定的触控手势。例如用三指同时长按屏幕if (Input.touchCount 3) { bool allStationary true; foreach (Touch touch in Input.touches) { if (touch.phase ! TouchPhase.Stationary) { allStationary false; break; } } if (allStationary) { ToggleDebugPanel(); // 避免连续触发可以加一个冷却时间 } }屏幕悬浮按钮在调试Canvas上创建一个始终显示的半透明小按钮点击它来切换主面板的显示。这更适合需要频繁开关调试功能的测试场景。摇一摇功能利用手机加速度计检测摇动事件来呼出面板。Unity的Input.acceleration可以帮到你但需要注意防抖和阈值判断。对于面板内的操作拖拽滑块、输入文本RuntimeInspector的UGUI基础已经能很好地处理触控输入无需额外适配。6. 实战应用构建一个简易的游戏内调试菜单将Runtime Inspector与一个简单的调试菜单结合可以极大提升测试效率。我们来创建一个包含常用调试功能的浮动菜单。创建菜单UI在调试Canvas下创建一个Panel作为菜单容器。里面可以放置一些按钮如“选中玩家”、“选中最近敌人”、“增加金币”、“无敌模式开关”等。编写菜单逻辑为每个按钮编写点击事件。核心是调用前面RuntimeDebugManager.Instance.InspectObject()或直接操作目标组件。public class DebugMenu : MonoBehaviour { public void InspectPlayer() { GameObject player GameObject.FindGameObjectWithTag(Player); if (player ! null) { RuntimeDebugManager.Instance.InspectObject(player); } } public void ToggleGodMode() { PlayerController playerCtrl FindObjectOfTypePlayerController(); if (playerCtrl ! null) { playerCtrl.isInvincible !playerCtrl.isInvincible; // 可以在这里添加一些UI反馈比如改变按钮颜色 } } public void AddCurrency(int amount) { GameManager.Instance.AddCoins(amount); // 由于RuntimeInspector是实时绑定的如果GameManager.Instance.coins是公共字段 // 那么当前正在检查GameManager的Inspector面板会自动更新显示新的金币数。 } }动态菜单生成更高级的做法是菜单内容可以根据上下文动态生成。例如长按屏幕上的某个游戏物体在物体位置弹出一个菜单选项包括“检查该对象”、“复制位置信息”、“销毁对象”等。这需要结合射线检测和UI世界空间渲染。通过这样的组合你就不仅仅拥有一个被动的属性查看器而是获得了一个主动的、功能强大的游戏内调试工具集。7. 性能优化与注意事项实录集成任何运行时工具性能都是必须考虑的一环。以下是我在实际项目中总结的几点经验1. 避免每帧刷新Inspecting除非必要不要每帧都调用runtimeInspector.Inspect(newObject)。这会导致UI频繁重建非常消耗CPU。通常只在目标对象改变时如通过Hierarchy点击或代码指定进行一次检查。2. 谨慎使用Hierarchy的实时更新RuntimeHierarchy组件通常有一个“Refresh Interval”或类似的设置。默认可能是每0.5秒或1秒刷新一次场景树。在对象数量很多1000的复杂场景中即使每秒刷新一次也可能造成卡顿。在发布版本或性能敏感的场景中可以考虑将其设置为手动刷新或者通过代码在需要时才调用runtimeHierarchy.Refresh()。3. 对复杂数据类型进行分页或懒加载如果你有一个包含上百个元素的数组或列表全部展开渲染会瞬间生成大量UI元素造成帧率下降。遗憾的是标准版RuntimeInspector可能没有内置分页。一个折中方案是对于这类字段在自定义Drawer中先只显示数组长度和一个“展开”按钮点击按钮后再动态创建内部元素的UI。4. 注意内存泄漏RuntimeInspector通过反射和UI绑定来工作。当你检查一个对象然后这个对象被销毁了例如一个被击败的敌人而Inspector面板还没有切换目标这时就可能因为引用而导致内存无法被GC回收或者UI显示异常。一个好的实践是在RuntimeDebugManager中监听场景卸载或对象销毁事件主动将Inspector的目标设置为null或另一个存活的对象。public void OnTargetDestroyed(GameObject destroyedObj) { if (runtimeInspector ! null runtimeInspector.InspectedObject destroyedObj) { runtimeInspector.Inspect(null); // 清空检查目标 // 或者切换到默认目标如主摄像机 runtimeInspector.Inspect(Camera.main?.gameObject); } }5. 构建发布时的处理调试工具显然不应该出现在给玩家的最终版本中。你有几种选择 *使用编译指令将所有调试相关的代码包括RuntimeDebugManager的整个类定义包裹在#if UNITY_EDITOR || DEVELOPMENT_BUILD中。这样只有在编辑器模式或你自定义的“开发版本”中这些代码才会被编译。 *通过预制体和场景管理将整个调试Canvas做成一个预制体在构建“Release”版本时确保这个预制体没有被包含在任何发布的场景里或者通过启动脚本在Awake时立即销毁它。 *使用插件提供的开关检查RuntimeInspector是否有全局的启用/禁用设置在发布版本中将其关闭。6. 输入冲突你设置的呼出热键如F1可能会和游戏本身的输入冲突。确保你的调试管理器在检测输入时检查游戏是否处于允许调试的状态例如不是在全屏播放过场动画时。也可以考虑使用更复杂的组合键如LeftShift F1。7. 自定义Drawer的复杂度为每一个简单类都写自定义Drawer会带来维护成本。评估其必要性只有那些在调试时频繁查看、且默认显示方式不直观的类才值得投入时间制作自定义Drawer。遵循这些注意事项你就能在享受运行时调试便利的同时将其对项目性能和最终包体的影响降到最低。这个工具最终会成为你开发过程中不可或缺的得力助手而非负担。
1. 项目概述与核心价值在Unity开发中尤其是涉及到移动端、AR/VR或者打包成WebGL、小游戏的项目有一个痛点几乎每个开发者都遇到过当游戏在真机或者打包后的环境下运行时传统的Inspector面板消失了。你无法像在编辑器里那样实时查看一个游戏对象的Transform、脚本变量更别提动态修改它们了。想象一下美术同学在测试机上觉得某个特效的位置差了一点点或者策划想微调一下某个怪物的血量你难道要让他们给你描述然后你猜着改代码、重新打包、再安装测试吗这个流程效率低得令人抓狂。这就是Runtime Inspector运行时检视器插件存在的意义。它让你能在游戏运行状态下在游戏画面内直接呼出一个类似Editor Inspector的面板实时查看和修改场景中任何游戏对象的组件和属性。今天要聊的这个“UnityRuntimeInspector”就是社区里一个非常流行且强大的开源解决方案。它不仅仅是一个调试工具更是连接开发、测试、甚至部分策划/美术需求的桥梁。通过这篇教程我将带你用5个核心步骤从零开始将它集成到你的项目中并实现游戏对象的实时调试。无论你是想快速定位线上Bug还是为团队搭建一个便捷的调参工具这套方案都值得你花时间掌握。2. 核心思路与方案选型在动手之前我们先理清思路。实现运行时调试本质上需要解决几个问题如何捕获场景中的对象如何动态生成UI来反射对象的属性信息如何实现属性的双向绑定即UI修改能同步到对象对象变化能更新UI市面上有不少Runtime Inspector方案比如付费的“Runtime Editor”套装或者一些轻量级的自己写的脚本。我们选择“UnityRuntimeInspector”这个开源项目主要是基于以下几点考量1. 功能全面且稳定它不仅仅支持查看基本类型int, float, string, bool还支持枚举、数组、列表、甚至自定义的Class和Struct。对于Unity特有的类型如Vector3、Color、GameObject引用它都提供了友好的UI比如颜色选择器、对象拖拽赋值。其Hierarchy面板还能实时显示场景中的对象树这对于在复杂场景中定位目标非常有用。2. 性能与兼容性平衡得好它使用C#的反射Reflection和PropertyDrawer的思路来动态构建UI虽然反射有一定开销但作者做了很多优化比如缓存、懒加载等在实际使用中只要不在一帧内刷新成百上千个属性性能是完全可接受的。它不依赖任何特殊的Unity新版本API兼容性从较旧的Unity版本到最新的LTS版本都表现良好。3. 高度可定制化整个UI是基于Unity的UGUI构建的这意味着你可以像修改普通UI一样修改它的字体、颜色、布局。更重要的是你可以通过继承特定的接口为你的自定义数据类型编写专属的绘制器RuntimeInspectorDrawer让它完全融入你的开发工作流。4. 活跃的社区与清晰的授权项目在GitHub上维护Issues和PR都比较活跃遇到问题有地方可寻。采用MIT许可证允许你在商业项目中自由使用、修改和分发。基于这些优点我们的技术路线就明确了集成这个开源库然后通过几个关键步骤将其核心功能与我们的游戏逻辑连接起来最终实现一个可通过热键或UI按钮触发、能够浏览和修改任意游戏对象的运行时调试面板。3. 环境准备与插件集成3.1 获取Runtime Inspector插件首先你需要获取“UnityRuntimeInspector”的源代码。最推荐的方式是通过Unity的Package Manager从Git URL添加这样便于后续更新。打开你的Unity项目建议使用2019.4 LTS或更新版本。打开Window Package Manager。点击左上角的“”按钮选择“Add package from git URL...”。输入该仓库的URL请注意由于网络环境你可能需要确认可访问的仓库地址。通常开源库会托管在GitHub上。一个常见的有效地址格式是https://github.com/yasirkula/UnityRuntimeInspector.git。你也可以先下载ZIP包然后通过Add package from tarball...来添加。点击“Add”。Unity会下载并导入这个包。导入后你可以在Package Manager中看到“Runtime Inspector”这个包。注意直接从Git导入要求你的Unity版本支持该功能且网络通畅。如果失败可以去GitHub发布页面下载最新的.unitypackage文件通过Assets Import Package Custom Package...进行传统导入。导入后所有相关脚本和预制体通常会在Assets/Plugins/RuntimeInspector或类似的目录下。3.2 基础场景与UI设置插件导入后它并不会自动出现在你的游戏里。我们需要手动创建一个用于承载调试面板的Canvas。在Hierarchy中右键选择UI Canvas。这将创建一个默认的CanvasEvent Camera可能会被自动设置。为了让调试面板在所有场景中持久存在且方便管理我通常会将这个Canvas做成一个单例预制体。右键Canvas选择Create Empty Child命名为“RuntimeDebugger”或类似的名字。将RuntimeInspector插件提供的预制体拖入这个空节点下。你可以在项目窗口中搜索“RuntimeInspector”或“RuntimeHierarchy”来找到它们。通常核心预制体叫做RuntimeInspectorCanvas或RuntimeInspector。拖入后你可能会看到一个已经布局好的面板。调整这个Canvas的渲染模式。对于全屏调试使用Screen Space - Overlay最简单。如果希望调试面板不影响游戏画面的渲染顺序比如被3D物体遮挡可以使用Screen Space - Camera并指定一个专门的UI摄像机。关键一步找到刚刚拖入的RuntimeInspector预制体实例在其Inspector面板上通常有一个Runtime Inspector或RuntimeHierarchy组件。这里有一个Canvas字段需要将它拖拽赋值为你刚创建的Canvas根节点。这一步是确保UI事件正确传递的关键。至此你的场景里已经有了一个隐藏的调试面板骨架。接下来就是让它“活”起来。4. 核心功能实现与脚本编写4.1 创建调试管理器单例为了全局控制调试面板的显示、隐藏以及目标对象的指定我们需要一个管理器脚本。使用单例模式可以方便地从任何地方访问。using UnityEngine; using RuntimeInspectorNamespace; // 引入插件的命名空间 public class RuntimeDebugManager : MonoBehaviour { public static RuntimeDebugManager Instance { get; private set; } [SerializeField] private RuntimeInspector runtimeInspector; // 拖拽赋值 [SerializeField] private RuntimeHierarchy runtimeHierarchy; // 拖拽赋值如果需要层次面板 [SerializeField] private Canvas debugCanvas; // 整个调试UI的Canvas [Header(Toggle Settings)] public KeyCode toggleKey KeyCode.F1; // 默认切换键 public bool startHidden true; // 启动时是否隐藏 private void Awake() { if (Instance ! null Instance ! this) { Destroy(gameObject); return; } Instance this; DontDestroyOnLoad(gameObject); // 跨场景不销毁 if (startHidden debugCanvas ! null) { debugCanvas.gameObject.SetActive(false); } } private void Update() { if (Input.GetKeyDown(toggleKey)) { ToggleDebugPanel(); } } public void ToggleDebugPanel() { if (debugCanvas ! null) { bool isActive !debugCanvas.gameObject.activeSelf; debugCanvas.gameObject.SetActive(isActive); // 面板显示时可以做一些初始化比如选中当前主摄像机 if (isActive runtimeInspector ! null Camera.main ! null) { runtimeInspector.Inspect(Camera.main.gameObject); } } } // 供其他脚本调用的方法检查指定对象 public void InspectObject(GameObject obj) { if (runtimeInspector ! null obj ! null) { if (!debugCanvas.gameObject.activeSelf) { debugCanvas.gameObject.SetActive(true); } runtimeInspector.Inspect(obj); } } // 供其他脚本调用的方法检查指定组件 public void InspectComponent(Component component) { if (runtimeInspector ! null component ! null) { if (!debugCanvas.gameObject.activeSelf) { debugCanvas.gameObject.SetActive(true); } runtimeInspector.Inspect(component); } } }将这个脚本挂载到场景中一个不会被销毁的GameObject上比如就叫RuntimeDebugManager然后将前面步骤中创建好的RuntimeInspector组件、RuntimeHierarchy组件如果有和Canvas分别拖拽到脚本的对应字段中。4.2 连接Hierarchy与Inspector如果你同时使用了RuntimeHierarchy运行时层次结构面板通常需要将它和RuntimeInspector关联起来实现点击Hierarchy中的对象Inspector面板就显示其详情的功能。在Hierarchy中找到你的RuntimeHierarchy预制体实例。在其组件上找到一个名为Inspector或Connected Inspector的字段。将你的RuntimeInspector实例拖拽赋值给它。同样在RuntimeInspector组件上可能也有一个Hierarchy字段可以将RuntimeHierarchy实例赋值给它实现双向选择同步。这样当你在运行时点击Hierarchy面板中的任意一个游戏对象右侧的Inspector面板就会自动刷新显示该对象的所有组件和属性。4.3 实现对象选择与过滤默认情况下RuntimeHierarchy会显示场景中的所有对象包括很多系统对象如EventSystem, DontDestroyOnLoad容器等。我们可能需要过滤掉一些不重要的对象或者只显示我们关心的对象。你可以通过脚本动态设置RuntimeHierarchy的Root Object。例如如果你只想调试某个特定管理节点下的所有对象// 在RuntimeDebugManager中增加方法 public void SetHierarchyRoot(GameObject root) { if (runtimeHierarchy ! null) { runtimeHierarchy.RootObject root; // 只显示root及其子对象 // 或者使用 runtimeHierarchy.Refresh() 强制刷新 } }更高级的过滤可以通过继承RuntimeHierarchy并重写其bool IsGameObjectExcludedFromHierarchy(GameObject go)方法来实现根据对象的名称、标签、层或者是否包含特定组件来决定是否显示。5. 高级功能与自定义扩展5.1 为自定义数据类型创建Drawer这是发挥RuntimeInspector威力的关键。假设你有一个自定义的玩家数据类[System.Serializable] public class PlayerStats { public string playerName; public int level; public float health; public Vector3 spawnPosition; }当这个类作为某个MonoBehaviour的公共字段出现时默认RuntimeInspector会将其展开显示其内部字段这已经很有用了。但如果你想为它创建一个更美观、更集成的UI比如用一个滑块来表示血量就需要自定义Drawer。创建一个新的C#脚本继承自RuntimeInspectorNamespace.RuntimeInspectorCustomEditor或者类似的基类具体类名请查看插件文档。重写相应的方法。以下是一个简化示例using RuntimeInspectorNamespace; using UnityEngine; using UnityEngine.UI; // 这个特性告诉RuntimeInspector这个Drawer用于绘制PlayerStats类型 [CustomEditor(typeof(PlayerStats))] public class PlayerStatsDrawer : RuntimeInspectorCustomEditor { // 当需要为PlayerStats创建UI时调用 protected override void CreateEditor(Transform parent, object value) { // 调用基类方法创建默认的字段展开UI base.CreateEditor(parent, value); // 你也可以在这里添加自定义的UI元素 // 例如在默认UI下方加一个按钮 GameObject customButton new GameObject(CustomButton); customButton.transform.SetParent(parent, false); Button btn customButton.AddComponentButton(); Text txt customButton.AddComponentText(); txt.text 重置状态; btn.onClick.AddListener(() { PlayerStats stats (PlayerStats)value; stats.health 100f; Refresh(); // 通知Inspector刷新显示 }); } // 当Inspector刷新时更新你的自定义UI protected override void UpdateEditor() { base.UpdateEditor(); // 如果需要在这里更新自定义UI的状态 } }编写完Drawer后RuntimeInspector在遇到PlayerStats类型的字段时会自动使用你的自定义绘制逻辑。5.2 属性暴露与隐私控制默认情况下RuntimeInspector通过反射获取所有公共字段和属性。但你可能不希望所有内部变量都被暴露。有几种控制方式使用[NonSerialized]或[HideInInspector]特性这是Unity的标准特性可以阻止字段在默认的Inspector和RuntimeInspector中显示。使用插件的特性RuntimeInspector可能提供了自己的特性比如[InspectorExclude]或[InspectorReadOnly]你需要在插件文档中确认。这些特性可以更精确地控制运行时调试时的可见性与可编辑性。通过代码动态排除你可以订阅RuntimeInspector的BeforeExposingMember或类似事件在成员被暴露到UI之前进行判断和过滤。5.3 集成到移动设备与触控操作在手机或平板设备上你需要一种方式来呼出调试面板因为物理键盘可能不存在。触控手势呼出修改RuntimeDebugManager的Update方法检测特定的触控手势。例如用三指同时长按屏幕if (Input.touchCount 3) { bool allStationary true; foreach (Touch touch in Input.touches) { if (touch.phase ! TouchPhase.Stationary) { allStationary false; break; } } if (allStationary) { ToggleDebugPanel(); // 避免连续触发可以加一个冷却时间 } }屏幕悬浮按钮在调试Canvas上创建一个始终显示的半透明小按钮点击它来切换主面板的显示。这更适合需要频繁开关调试功能的测试场景。摇一摇功能利用手机加速度计检测摇动事件来呼出面板。Unity的Input.acceleration可以帮到你但需要注意防抖和阈值判断。对于面板内的操作拖拽滑块、输入文本RuntimeInspector的UGUI基础已经能很好地处理触控输入无需额外适配。6. 实战应用构建一个简易的游戏内调试菜单将Runtime Inspector与一个简单的调试菜单结合可以极大提升测试效率。我们来创建一个包含常用调试功能的浮动菜单。创建菜单UI在调试Canvas下创建一个Panel作为菜单容器。里面可以放置一些按钮如“选中玩家”、“选中最近敌人”、“增加金币”、“无敌模式开关”等。编写菜单逻辑为每个按钮编写点击事件。核心是调用前面RuntimeDebugManager.Instance.InspectObject()或直接操作目标组件。public class DebugMenu : MonoBehaviour { public void InspectPlayer() { GameObject player GameObject.FindGameObjectWithTag(Player); if (player ! null) { RuntimeDebugManager.Instance.InspectObject(player); } } public void ToggleGodMode() { PlayerController playerCtrl FindObjectOfTypePlayerController(); if (playerCtrl ! null) { playerCtrl.isInvincible !playerCtrl.isInvincible; // 可以在这里添加一些UI反馈比如改变按钮颜色 } } public void AddCurrency(int amount) { GameManager.Instance.AddCoins(amount); // 由于RuntimeInspector是实时绑定的如果GameManager.Instance.coins是公共字段 // 那么当前正在检查GameManager的Inspector面板会自动更新显示新的金币数。 } }动态菜单生成更高级的做法是菜单内容可以根据上下文动态生成。例如长按屏幕上的某个游戏物体在物体位置弹出一个菜单选项包括“检查该对象”、“复制位置信息”、“销毁对象”等。这需要结合射线检测和UI世界空间渲染。通过这样的组合你就不仅仅拥有一个被动的属性查看器而是获得了一个主动的、功能强大的游戏内调试工具集。7. 性能优化与注意事项实录集成任何运行时工具性能都是必须考虑的一环。以下是我在实际项目中总结的几点经验1. 避免每帧刷新Inspecting除非必要不要每帧都调用runtimeInspector.Inspect(newObject)。这会导致UI频繁重建非常消耗CPU。通常只在目标对象改变时如通过Hierarchy点击或代码指定进行一次检查。2. 谨慎使用Hierarchy的实时更新RuntimeHierarchy组件通常有一个“Refresh Interval”或类似的设置。默认可能是每0.5秒或1秒刷新一次场景树。在对象数量很多1000的复杂场景中即使每秒刷新一次也可能造成卡顿。在发布版本或性能敏感的场景中可以考虑将其设置为手动刷新或者通过代码在需要时才调用runtimeHierarchy.Refresh()。3. 对复杂数据类型进行分页或懒加载如果你有一个包含上百个元素的数组或列表全部展开渲染会瞬间生成大量UI元素造成帧率下降。遗憾的是标准版RuntimeInspector可能没有内置分页。一个折中方案是对于这类字段在自定义Drawer中先只显示数组长度和一个“展开”按钮点击按钮后再动态创建内部元素的UI。4. 注意内存泄漏RuntimeInspector通过反射和UI绑定来工作。当你检查一个对象然后这个对象被销毁了例如一个被击败的敌人而Inspector面板还没有切换目标这时就可能因为引用而导致内存无法被GC回收或者UI显示异常。一个好的实践是在RuntimeDebugManager中监听场景卸载或对象销毁事件主动将Inspector的目标设置为null或另一个存活的对象。public void OnTargetDestroyed(GameObject destroyedObj) { if (runtimeInspector ! null runtimeInspector.InspectedObject destroyedObj) { runtimeInspector.Inspect(null); // 清空检查目标 // 或者切换到默认目标如主摄像机 runtimeInspector.Inspect(Camera.main?.gameObject); } }5. 构建发布时的处理调试工具显然不应该出现在给玩家的最终版本中。你有几种选择 *使用编译指令将所有调试相关的代码包括RuntimeDebugManager的整个类定义包裹在#if UNITY_EDITOR || DEVELOPMENT_BUILD中。这样只有在编辑器模式或你自定义的“开发版本”中这些代码才会被编译。 *通过预制体和场景管理将整个调试Canvas做成一个预制体在构建“Release”版本时确保这个预制体没有被包含在任何发布的场景里或者通过启动脚本在Awake时立即销毁它。 *使用插件提供的开关检查RuntimeInspector是否有全局的启用/禁用设置在发布版本中将其关闭。6. 输入冲突你设置的呼出热键如F1可能会和游戏本身的输入冲突。确保你的调试管理器在检测输入时检查游戏是否处于允许调试的状态例如不是在全屏播放过场动画时。也可以考虑使用更复杂的组合键如LeftShift F1。7. 自定义Drawer的复杂度为每一个简单类都写自定义Drawer会带来维护成本。评估其必要性只有那些在调试时频繁查看、且默认显示方式不直观的类才值得投入时间制作自定义Drawer。遵循这些注意事项你就能在享受运行时调试便利的同时将其对项目性能和最终包体的影响降到最低。这个工具最终会成为你开发过程中不可或缺的得力助手而非负担。
双梁正问题 【 torch 实战】（Python代码实现）)
