简介这款Unity插件面向需要将Windows桌面画面实时集成到Unity项目中的开发者能够便捷捕捉并显示当前桌面或指定窗口适合桌面镜像、远程协作、直播辅助或HUD投影等场景。压缩包共141个文件以C#脚本为核心包含窗口管理与渲染模块同时配备Shader、材质、预制体及DLL运行库整体仅600KB轻量易集成。已有567人学习并使用资源内文件结构清晰可将主要模块直接放入Assets目录后调用与扩展也可参考UwcDesktopLayouter等代码快速搭建多窗口布局。对需要快速实现Windows桌面同步展示的Unity开发者而言这套插件提供了完整的窗口捕获与展示方案兼具实用性和参考价值。1. 桌面进 Unity这个 Windows Capture 插件到底能干嘛做数字孪生项目最烦的一件事就是把 Windows 桌面“塞进”Unity 场景里。客户要看大屏上实时滚动报表、要在一个 3D 场景里内嵌几个正在运行的业务系统而且明确说“不能是截图要真的在动”。传统做法是截图轮询但延迟高、锯齿明显动起来就像放 PPT。我第一次拆这个 Windows Capture 插件时看到UwcManager、UwcWindowTexture、UwcLib这套文件第一反应是“终于有人把 Windows 桌面捕获封装成了 Unity 能直接用的组件”。它要解决的就是一类具体问题在 Unity 里实时展示 Windows 任意窗口或全屏桌面内容让桌面画面变成场景里的动态纹理随窗口状态同步变化。用一句话概括不用自己写 C 插件把资源解压进 Assets挂组件选窗口桌面就进场景了。适合正在做数字孪生、多屏演示、远程协作、桌面控制类工具的 Unity 开发者尤其是被系统级 API 卡过的人。2. 从文件清单看插件架构UwcManager、UwcWindowTexture、cginc 各管什么2.1 先读懂六个核心文件拿到资源第一眼看到的是一堆.cs、.asmdef、.cginc散文件。别急着全拖进项目先花五分钟看结构。从文件名基本能判断出这个插件的分层思路UwcWindowTexture.cs是对外主组件UwcManager.cs是全局管理器UwcLib.cs是底层 API 封装UwcWindow.cs是窗口数据模型UwcCommon.cginc是着色器公共代码剩下两个 Editor 文件负责 Inspector 面板和子物体窗口管理。UwcLib.cs是整个插件的“黑匣子”层负责把 Windows 系统 API 通过 P/Invoke 封装给上层调用。它做的事本质上就三类枚举桌面上的窗口、读取窗口位置和尺寸、建立纹理与窗口内容的绑定关系。常见做法是调用user32.dll里EnumWindows、GetWindowRect、GetForegroundWindow这类接口再加上新版本 Windows 的 Graphics Capture API 拿到帧数据。这个文件的代码看起来枯燥但实际上决定了插件能不能在目标机器上跑起来——不同 Windows 版本底层捕获路径完全不一样。UwcWindowTexture.cs是使用频率最高的组件类。它挂在任何一个 GameObject 上就可以指定捕获某个窗口或整个桌面捕获结果会输出成一张动态纹理。往下读你会发现它内部逻辑不复杂把UwcLib返回的帧数据转换成Texture2D或RenderTexture然后每隔 N 帧刷新一次。真正的“实时”不靠 Unity 的 Update 硬顶而是靠这套纹理更新机制在驱动。两个.asmdef放在同一目录下不是摆设一个给 Runtime 编译一个给 Editor 编译。UwcWindowTextureEditor.cs这类编辑器工具代码如果混进运行时程序集打包到 Android 或 WebGL 必然炸。这提醒我们自己写插件时也要坚持 Editor 代码和 Runtime 代码分离别图省事全塞一个程序集。2.2 安装解压放 Assets 只是第一步资源本身确实是个“傻瓜包”解压后整个文件夹丢进 Assets 即可。但我一般不建议直接丢到 Assets 根目录而是建一个Assets/Plugins/UwcDesktop之类的目录原因是后期更新或移除时不容易误删别的文件。更重要的是别把资源放进StreamingAssets或Resources这类有特殊语义的目录否则打包时会被二次处理。放置完成后Unity 会自动编译。此时要盯住 Console 面板重点看两类错误一是.asmdef和 Unity 版本不匹配导致的程序集引用错误二是脚本里用到的新版 C# 语法在当前编译器下不通过。如果 Console 有红字优先做的不是查代码而是确认 Unity 版本。这个插件的捕获能力依赖 Windows 版本与 Unity 版本的双重支持我一般建议 Windows 10 1803 以上、Unity 2019.4 LTS 以上。摘要里说“如果存在问题请更换 Unity 版本”指的就是这种情况——有时候不是代码坏了是老版本 Unity 自带的编译器太旧连 WinRT 相关的类型都解析不了。安装完成后怎么判断“真的装上了”不要只看 Console 没报错就算成功按下面这个清单核对一遍检查项预期现象失败时的表现程序集编译Console 无红色错误asmdef 引用解析失败组件可搜索Add Component 时能搜到 UwcWindowTexture搜索不到窗口枚举组件面板有窗口下拉选择列表为空说明 UwcLib 没拿到窗口句柄运行时显示RawImage 上有动态画面RawImage 黑屏或全白窗口移动跟随窗口位置改变场景纹理不变形纹理固定不更新2.3 验证安装是否成功别只看 Console 没有红字编译通过只是第一步。我见过最典型的翻车现场是Console 干干净净组件也挂上了但运行时 RawImage 黑屏。这时候要先确认权限环境。Windows 的桌面捕获 API 要求调用方和被捕获窗口在同一个桌面会话里Unity 如果被“以管理员身份运行”而目标窗口是普通用户权限启动的两边的会话上下文不一致捕获就会静默失败。验证安装成功最直观的方法是做“窗口跟随测试”打开一个能实时变动的窗口比如任务管理器把捕获源选成它然后在 Windows 里拖动这个窗口。画面跟着动、内容持续刷新说明整套链路是通的。如果画面卡在某一帧多半是纹理刷新逻辑没跑起来这时候去 Inspector 里看 UwcWindowTexture 有没有生成一张有效的纹理对象如果没有问题大概率在 UwcLib 层而不是 Unity 层。还要记得处理光标。默认情况下很多捕获插件会把鼠标光标也画进纹理如果你的场景是大屏展示光标会严重影响观感。好的插件会把光标处理做成参数关闭后纹理里不含光标如果没做这个开关常见的做法是在捕获后把光标区域用上一帧内容覆盖掉但这样会有拖影。所以拿到插件后第一件事就是去 Inspector 翻一遍所有开关把所有关于 cursor、overlay、alpha 的参数都试一遍摸清这版插件的行为边界。3. 把 Windows 桌面接进场景接入、参数与渲染链路3.1 最小接入窗口模式还是桌面模式接入方式非常直接创建空物体挂UwcWindowTexture组件然后在组件面板里选择要捕获的目标。这里有两个模式理解它们的区别比写代码更重要。窗口模式捕获的是某个具体窗口比如“记事本”或“Chrome”。它的优势是内容跟随窗口逻辑窗口移动、缩放纹理内容也跟着变缺点是窗口一旦最小化或被完全遮挡内容就会丢失。桌面模式捕获的是整个桌面相当于把所有窗口拼在一起当成一张画面适合做整体展示但会暴露桌面图标和无关窗口大屏场景下容易显得杂乱。运行时切换捕获目标也很简单下面是一个最小接入示例using UnityEngine; using UnityEngine.UI; public class DesktopMirrorDemo : MonoBehaviour { public UwcWindowTexture source; public RawImage rawImage; void Start() { if (source ! null) { source.StartCapture(); } } void Update() { if (source ! null source.Texture ! null rawImage ! null) { rawImage.texture source.Texture; } } }这段脚本的逻辑是Start 时启动捕获Update 里持续把捕获生成的纹理同步给 RawImage 显示。source.Texture是 UwcWindowTexture 对外暴露的纹理属性你不需要自己创建 RenderTexture也不需要关心底层帧数据怎么来。这类组件通常已经封装好了纹理的生命周期频繁在 Update 里赋值纹理引用不会造成大的性能问题因为赋值的是引用不是拷贝像素。参数说明脚本里我不建议写任何具体的 FPS 数字应该把帧率控制权留在组件的 Inspector 面板上。实际项目里捕获帧率 15 到 30 是比较合理的区间。屏幕上是静态报表时 15 帧足够有滚动动画或视频内容时再提到 30。盲目拉到 60 帧你会发现 GPU 开销直线上升尤其是大屏场景用了高分辨率纹理时收益极低。3.2 关键参数怎么给分辨率、帧率与光标这类插件通常会在组件面板上暴露一组捕获参数虽然不同版本命名有差异但核心就下面这几个参数建议值说明Capture FPS15~30捕获刷新率不是 Unity 渲染帧率Max Texture Size1920 或按 UI 实际尺寸限制纹理大小避免高分辨率屏下 GPU 带宽爆炸Include Cursorfalse大屏展示时务必关闭否则光标会显示在业务系统画面上Capture ModeWindow / Desktop按场景需求选Refresh On Resizetrue窗口尺寸变化时自动更新纹理否则会拉伸这几个参数里最容易翻车的是 Max Texture Size。假设桌面是 4K 分辨率你直接用原始尺寸生成纹理那么一张 3840x2160 的纹理在 GPU 里占用的带宽是普通 1080p 的四倍。大屏看板上如果同时铺了六路窗口画面即使什么都不做光纹理采样就能把显卡拖到瓶颈。所以我一般习惯先把 Max Texture Size 压到 1920再看实际显示效果不够清晰再往上调。画面清晰度不够的时候优先保证 UI 里的 RawImage 尺寸不要超过纹理尺寸否则 Unity 做了一次放大采样边缘就会发虚。捕获取频和渲染帧率的关系也值得说清楚。Unity 的渲染帧率是引擎侧决定的捕获帧率是捕获管线决定的两者互不绑定。捕获帧率设为 20Unity 跑 60 帧视觉效果也不会超过 20 FPS 的流畅度多余的帧都在做无效刷新。反过来捕获帧率设 60 但场景里其他逻辑卡到 30 帧捕获的内容也会因为渲染时机而显得断断续续。所以接进项目时先确认目标机器实际能跑到多少帧再回推捕获帧率值而不是两边都往高了设。3.3 渲染链路从桌面像素到 RawImage 上的纹理把 Windows 桌面搬进 Unity底层链路不是想象中的“截图然后上传”而是一条系统级纹理通道。桌面合成器 DWM 会维护桌面画面的共享纹理捕获插件通过系统 API 拿到这个纹理的访问权再在 Unity 中把它转成 GPU 端的 RenderTexture。整条链路不经过 CPU 读像素所以才能做到低延迟、不掉帧。底层UwcLib.cs做的核心事情就是把这套系统接口桥接进 Unity 的纹理体系。通常它要做三件事申请共享纹理的访问句柄、把帧数据绑定为 Unity 的Texture2D或RenderTexture、在每帧刷新时替换纹理内容。这些代码一般不需要你动但了解它有一个实际价值排查问题的时候能判断“黑屏”到底发生在系统层还是 Unity 层。着色器层面的UwcCommon.cginc负责的是纹理显示前的最后一道加工。这个文件里通常定义了 UV 翻转、裁剪、颜色空间转换等辅助函数。这里有一个常见坑Windows 桌面纹理的 UV 坐标系和 Unity 的原始 UV 坐标系不完全一致直接贴到材质上可能出现上下颠倒。解决办法是在材质 Shader 里对 UV 做一次1 - uv.y翻转。下面是一段典型的 UV 处理逻辑// UwcCommon.cginc 中典型的 UV 修正逻辑 float2 DesktopUV(float2 uv, float2 cropMin, float2 cropMax) { uv.y 1.0 - uv.y; return lerp(cropMin, cropMax, uv); }这段代码的作用是第一行翻转 Y 轴解决桌面纹理倒转问题第二行用cropMin和cropMax做区域裁剪实现只显示窗口的某个局部区域。如果插件自带 UI 界面可以直接调裁剪框shader 里的逻辑通常是 Inspector 菜单在背后驱动的。遇到画面颠倒时检查的重点就在这个 UwcCommon.cginc 上而不是急着改 C# 脚本。4. 避坑黑屏、掉帧、DPI 拉伸五个高频问题排查4.1 黑屏但鼠标光标能看见现象RawImage 上几乎全黑但偶尔能看到鼠标光标在动窗口内容完全不可见。原因Unity 进程与目标窗口不在同一个权限上下文里。最常见的是 Unity Editor 以管理员身份运行而业务窗口是普通权限启动Windows 的捕获接口会直接拒绝跨会话抓取内容。另一种少见的情况是目标机器启用了远程桌面并且当前会话处于断开状态系统不再向该会话推送桌面绘制。解决先关掉 Unity 的管理员权限运行方式再确认目标窗口在同一个登录会话中。远程桌面场景下让 Unity 和被捕获窗口在同一会话内实时操作不要切到别的桌面再去远程查看。如果一定要跨会话得换下层实现方案这不是配置能解决的。4.2 帧率上不去画面一卡一顿现象捕获帧率设了 30但实际画面明显不到 30用 Profiler 看 CPU 和 GPU 都偶发尖刺。原因桌面捕获管线不是“要一帧给一帧”它有自己的调度节奏。当桌面内容长时间不变化时部分系统实现会主动降低捕获频率这是省电策略不是 bug。另一个常见原因是在业务代码里对捕获纹理调用了ReadPixels或GetPixels这一步会把 GPU 数据拷回 CPU每一帧都做就非常伤。解决先把捕获帧率降到 15 左右再用 Profiler 看看是不是有 CPU 回读。如果业务上必须读取像素比如做图像识别那就降低采样频率每秒最多做两次而且不要和捕获输出共用一个纹理。4.3 窗口最小化后画面变成空白现象窗口最小化或完全被遮挡后纹理更新停止画面停在最后一帧或者变白。原因这是 Windows 桌面捕获的固有行为。最小化的窗口不会参与桌面合成器的绘制系统拿不到新的帧数据。遮挡状态则要看捕获 API 的具体实现有的版本返回最后一帧有的版本直接返回空纹理。解决设计交互逻辑时提前规避。比如在窗口最小化时自动切换到桌面模式或者在 UI 上显示“窗口已最小化”的占位提示而不是让用户看到一块空白画面。这里没有完美的系统级解法只能从产品逻辑上做兜底。4.4 多显示器DPI 缩放后画面拉伸变形现象win 10 或 win 11 上开了 150% 缩放捕获的桌面内容在 Unity 里显示时被拉伸文字边缘发糊。原因Unity 进程默认不是 DPI AwareWindows 会给它一个伪装的逻辑分辨率导致获取到的窗口坐标和实际像素坐标对不上。捕获区间的宽高比和纹理宽高比不一致再经过 RawImage 的 UV 拉伸画面就变形了。解决在项目入口加系统级 DPI 感知声明常见做法是调用SetProcessDpiAwarenessContext让进程感知 Per-Monitor DPI。这个调用要在创建任何窗口之前执行所以在 Unity 里放到早期加载的脚本里[DllImport(user32.dll)] static extern bool SetProcessDpiAwarenessContext(long dpiAwareness); [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSplashScreen)] static void SetDpiAware() { // 参数 -1 表示 per-monitor v2 感知 SetProcessDpiAwarenessContext(-1); }说明-1对应DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2是目前最推荐的模式。加了这段之后Windows 会按物理像素给 Unity 上报窗口坐标捕获内容不再被系统缩放。注意这个方法在 Windows 10 1809 之后稳定可用旧版本系统会无效返回。4.5 asmdef 编译报错项目直接进不了运行态现象导入后 Console 报Assembly with the same name UwcWindowTexture has already been imported或Cannot compile相关错误。原因多数是版本兼容问题也可能是项目里已存在同名程序集。Unity 老版本2018.2 之前对 asmdef 的支持不完整特别是 Editor 程序集和 Runtime 程序集互相引用时编译规则差异很大。解决先检查是否和现有文件重名再考虑升级 Unity 小版本。我遇到过同一份插件在 2019.4 上编译通过、换到 2020.3 也没问题但在 2018.4 上死活报错的情况。如果项目版本确实太老换插件比改源码成本低得多。清理Library/Bee或整个Library目录后重新导入也是有效手段。5. 多窗口桌面布局与性能验证用自带 Layouter 做数字孪生大屏5.1 用 UwcDesktopLayouter 铺开多窗口做数字孪生大屏时需求通常是“同时显示多个业务系统的画面”而不是只捕获一个窗口。如果手动创建多个 UwcWindowTexture 再逐个摆位置窗口一多就会变得不可维护。插件自带的UwcDesktopLayouter.cs解决的就是这个问题它把一个或多个窗口纹理按预设的网格布局自动排布类似把桌面“摊开”到三维场景里。我常用的接入方式是把 Layouter 挂在一个根节点上然后通过代码指定窗口列表using UnityEngine; public class LayoutWindows : MonoBehaviour { public UwcDesktopLayouter layouter; void Start() { layouter.rows 2; layouter.columns 3; layouter.BuildLayout(); } }这段代码做了两件事设置 2 行 3 列的网格密度然后调用BuildLayout()按当前的分辨率自动创建/排列子节点。如果多个窗口画面都配置好了Layouter 会统一调整它们的尺寸和位置避免手动拖动对齐时出现的像素级误差。需要注意布局前先设好每个窗口源的 Max Texture Size否则纹理分辨率差距很大时网格看起来会很乱。5.2 性能验证用帧间隔统计替代肉眼看流畅度多窗口捕获最容易出现的问题是“感觉有点卡但说不清哪里卡”。肉眼判断不靠谱关键是看帧间隔分布。下面这个脚本可以用来量化流畅度using UnityEngine; public class CaptureFrameRateMonitor : MonoBehaviour { public UwcWindowTexture target; float lastMark; float worstGap; float smoothFps; void Update() { float now Time.realtimeSinceStartup; float gap now - lastMark; lastMark now; if (gap worstGap) worstGap gap; smoothFps Mathf.Lerp(smoothFps, 1f / Mathf.Max(gap, 0.0001f), 0.1f); if (Time.frameCount % 30 0) { Debug.Log($smooth: {smoothFps:F1} FPS, worst gap: {worstGap * 1000:F1} ms); worstGap 0; } } }关注点是worstGap而不是平均帧率。平均 30 帧没问题但如果每秒钟都出现一次 200ms 的峰值用户体验就是卡顿。看到这个数值偏高时优先调低捕获帧率再检查是不是有别的逻辑在抢占主线程。经过几轮调整我一般把目标定为整段运行中没有任何一次帧间隔超过 100ms。操作系统的后台更新、杀毒软件扫描、驱动层重传都可能产生这种尖峰这类问题不是插件本身能完全规避的。我从那以后每次给客户部署这类桌面捕获项目都会强制把所有演示机的系统更新、锁屏、休眠策略先关一遍确认跑满 30 分钟没有任何一次大峰值才交付省得现场出问题还要远程处理。希望帮到你。本文还有配套的精品资源点击获取