项目设置工具

使用 Unity 开发玩出梦想应用时，需要修改一些项目设置（配置 Unity 设置 介绍了相关设置）。玩出梦想 Unity 项目设置工具可以自动检查项目中的常见问题，并提供一键修复、相关文档查询等功能，帮助开发者快速配置项目，提高开发和移植效率。建议开发者确认没有任何严重问题（Critical Issue）报错后，再进行打包。

导入 Unity SDK（版本 2.5.0 及以上）后，可通过菜单 > YVR > Project Setup Tool 打开面板。在项目设置修改后，检查项可能不能及时更新，可点击刷新（Refresh）按钮，手动更新当前类别下的检查项状态。反馈（Feedback）按钮可就该功能进行意见反馈。

SetupTool

同时，可以在 Unity 编辑器窗口的右下角查看当前检查状态和打开面板。

Status

任务处理

玩出梦想 Unity 项目设置工具会定期检查检查项的状态。开发者可以进行的操作：

  • 修复：对于可自动修复的问题，提供一键修复功能。
  • 转到源代码：打开 IDE，跳转到相应的代码位置。
  • 相关文档：对于无法直接修复的问题，提供相关文档的链接。
  • 忽略：忽略这个问题，不再进行检查。

检查清单

检查项分为三个主要类别： ProjectSetup, PerformanceLint, 和 Porting。

ProjectSetup

Project Setup 检查项如下：

  1. 【必要】BuildTarget if is Android
  2. 【必要】PlayerSettings.Android.minSdkVersion = AndroidSdkVersions.AndroidApiLevel25
  3. 【必要】PlayerSettings.Android.targetSdkVersion = AndroidSdkVersions.AndroidApiLevelAuto
  4. 【必要】PlayerSettings.SetScriptingBackend(buildTargetGroup, ScriptingImplementation.IL2CPP)
  5. 【必要】PlayerSettings.Android.targetArchitectures = AndroidArchitecture.ARM64
  6. 【必要】Set Graphics APIs for this build target to OpenGLES3
  7. 【必要】YVRLoader has been assigned.
  8. 【必要】PlayerSettings.Android.androidTVCompatibility = false

PerformanceLint

PerformanceLint 检查项如下：

  1. 【推荐】Physics.defaultContactOffset = 0.01f
  2. 【推荐】Physics.sleepThreshold = 0.005f
  3. 【推荐】Physics.defaultSolverIterations = 8
  4. 【推荐】QualitySettings.pixelLightCount = 1
  5. 【推荐】QualitySettings.masterTextureLimit = 0
  6. 【推荐】QualitySettings.anisotropicFiltering = AnisotropicFiltering.Enable
  7. 【推荐】EditorUserBuildSettings.androidBuildSubtarget = MobileTextureSubtarget.ETC2
  8. 【推荐】PlayerSettings.colorSpace = ColorSpace.Linear
  9. 【推荐】PlayerSettings.graphicsJobs = false
  10. 【推荐】PlayerSettings.MTRendering = true and PlayerSettings.SetMobileMTRendering(buildTargetGroup, true)
  11. 【推荐】PlayerSettings.use32BitDisplayBuffer = true
  12. 【推荐】renderingTier.renderingPath = RenderingPath.Forward
  13. 【推荐】For GPU performance, please don't use parallax-mapped materials.
  14. 【推荐】For GPU performance, please don't use specular shader on materials.
  15. 【推荐】Please use 2 or fewer passes in materials.
  16. 【推荐】For GPU performance, please use 4 or fewer CompositeLayers.
  17. 【推荐】For visual quality, please use trilinear filtering and mipmap on your VR splash screen.
  18. 【推荐】Recommend enabling useRecommendedMSAALevel in YVRManager
  19. 【推荐】Render scale above 1.5 is extremely expensive on the GPU, with little if any positive visual benefit.
  20. 【推荐】For GPU performance, please don't use Unity's built-in Skybox.
  21. 【推荐】For GPU performance, please generate mipmaps or disable trilinear filtering for textures.
  22. 【推荐】Please use less than 1GB of vertex and texture memory.
  23. 【推荐】Please use less than 100000 triangles or vertices.
  24. 【推荐】Please use less than 100 draw calls.
  25. 【推荐】All lights in scene have up to date lightmap data
  26. 【推荐】For CPU performance, consider disabling shadows on realtime lights.
  27. 【推荐】For CPU performance, please disable all but the top 16 AudioSources.
  28. 【推荐】For fast loading, please don't use decompress on load for audio clips
  29. 【推荐】For fast loading, please don't preload data for audio clips.
  30. 【推荐】Please avoid instanced materials on renderers.
  31. 【推荐】Please don't use image effects.
  32. 【推荐】For GPU performance, please don't use projectors.
  33. 【推荐】Please use 2 or fewer camera clears.
  34. 【推荐】For GPU performance, please don't enable forceIntoRenderTexture on your camera
  35. 【可选】LightmapSettings.lightmapsMode = LightmapsMode.NonDirectional
  36. 【可选】Lightmapping.realtimeGI = false
  37. 【可选】PlayerSettings.gpuSkinning = true

Porting

Porting 可以检查从 Quest/Pico 移植的项目中常见的问题：

  1. 【推荐】PXR_Manager not exist in scene
  2. 【推荐】OVRManager not exist in scene
  3. 【推荐】YVREntitledManager exist in scene