.. _3 开发注意事项:

3 开发注意事项
===============================

3.1	进入设备的开发者模式
---------------------------------

具体步骤详见链接： `进入开发者模式`_

.. _进入开发者模式: https://sdk.picovr.com/docs/FAQ/chapter_one.html



3.2	Android Manifest文件
---------------------------------

- 添加必要的配置，默认已添加，若使用自定义AM文件需确保添加以下配置。
<meta-data android:name="pvr.app.type" android:value="vr" />

3.3	SDK推荐配置
---------------------------------

- 多线程渲染，详见 `Unity官方文档`_
.. _Unity官方文档: https://docs.unity3d.com/ScriptReference/SystemInfo-graphicsMultiThreaded.html

- 需要检查垂直同步设置，具体步骤如下：进入Edit>Project Settings>Quality，勾选Levels下的Medium，并确保Other下的V Sync Count项为 Don't Sync（必选项）：

.. image:: _static/3.1.png

图3.1 检查垂直同步设置

3.4	已知问题
---------------------------------

- Unity Stencil Buffer和Linear Space 同时使用，在Neo3 设备上存在黑屏问题，为已知问题。

- 使用快速预览工具时，如遇到编译器报错BeginLayoutGroup must be called first，为已知问题，不影响正常使用。

- PassThrough 在Vulkan下暂不支持。

- RT scale 设置>1.5时，应用启动时会有概率性闪黑，闪白或闪现场景。

- RT scale 设置>1.5且使用Vulkan时，应用内触发安全区后会有卡住的现象。

- 在Unity2021.2.3上同时使用URP、Linear、Multiview打包会出现黑屏现象。

- 在Unity2020.3.13之后版本使用Vulkan+Multipass，打包出的apk，连续亮灭屏操作会出现闪退现象。

- 使用Vulkan时，MRC功能与Linear Color Space不能同时使用。