Unity Vuforia项目导出exe方法及导出后黑屏问题排查

一、如何将Unity Vuforia项目导出为EXE文件？ #

这一步和普通Unity PC项目打包流程类似，但要注意Vuforia的特殊配置，具体步骤如下：

• 先确认Vuforia基础配置无误：打开Window > Vuforia Configuration，确保License Key已正确填写，你用到的目标数据库（Target Database）已导入，且在数据库的Inspector面板中勾选了Load On Startup。
• 切换到PC平台：点击顶部菜单栏File > Build Settings，在弹出窗口中选择PC, Mac & Linux Standalone，然后点击Switch Platform，等待Unity完成平台切换（耗时取决于项目大小）。
• 配置Player Settings：在Build Settings窗口点击Player Settings，在右侧Inspector面板完成这些关键设置：
  • 在Resolution and Presentation板块，设置合适的默认分辨率（比如1920x1080），根据需求选择Windowed或Fullscreen模式。
  • 在Other Settings里，将Scripting Backend设置为.NET Framework（Unity 2020+也可选.NET 4.x Equivalent），避免脚本运行时的兼容性问题。
  • 找到Vuforia相关设置，确认Enable Vuforia处于勾选状态，同时在Settings for PC > Input中确保WebCam权限已启用。
• 打包生成EXE：回到Build Settings窗口，点击Build，选择一个空文件夹作为输出目录，等待Unity完成编译打包。结束后，你就能在目标文件夹中找到生成的EXE文件。

二、导出EXE后运行黑屏的常见解决方法 #

黑屏问题大多和Vuforia的摄像头访问、资源加载或兼容性有关，按以下步骤排查：

• 摄像头权限未授权
  Windows系统下摄像头权限单独管控，打开设置 > 隐私和安全性 > 相机，先确保“允许应用访问相机”总开关开启，再在“选择哪些应用可以访问相机”列表中找到你的EXE程序，开启它的访问权限。如果第一次运行程序时弹出权限请求，一定要点击“允许”。
• 目标数据库未正确加载
  回到Unity项目，检查Vuforia Configuration里的目标数据库是否确实设置了Load On Startup。另外，选中数据库文件（.xml和.dat），在Inspector面板确认Include in Build处于勾选状态——如果没勾选，打包时数据库会被排除，导致Vuforia无法识别目标，进而黑屏。
• 相机设备选择错误
  运行EXE后，按下Ctrl + Shift + V可打开Vuforia的调试面板（PC端专属快捷键），切换到Camera标签页，查看当前使用的相机设备是否是你需要的（比如内置摄像头或外接USB摄像头）。如果不对，尝试切换到正确设备。也可以在Unity的Vuforia Configuration里提前设置Camera Device为指定设备。
• 分辨率/显示模式兼容性问题
  有些显卡在全屏模式下可能和Vuforia渲染不兼容。回到Unity的Player Settings，把Resolution and Presentation下的Default Screen Mode改成Windowed，并设置一个较低的分辨率（比如1280x720），重新打包测试。
• Vuforia与Unity版本不兼容
  不同版本的Unity对Vuforia的支持版本有要求，比如Unity 2022需要Vuforia 10.x及以上，Unity 2020可以用Vuforia 9.x或10.x。如果版本不匹配，会出现包括黑屏在内的各种奇怪问题。你可以在Unity Package Manager里卸载当前Vuforia包，重新搜索安装适配你Unity版本的Vuforia Engine。
• 缺失关键DLL文件
  偶尔Unity打包时会漏掉Vuforia的核心DLL。找到你Unity安装目录下的Editor\Data\PlaybackEngines\WindowsStandaloneSupport\Variations\win64_development\Managed文件夹，把里面的VuforiaUnity.dll、VuforiaWrapper.dll等相关文件复制到EXE所在目录的YourGame_Data\Managed文件夹里，然后重新运行程序。

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