.. _3 	Development notes:

3 	Development notes
===============================

3.1 	Enable device USB Debugging on device
------------------------------------------------------

Please check details from this FAQ link on how to enable developer https://sdk.picovr.com/docs/FAQ/chapter_one.html

3.2 	Android Manifest Document
---------------------------------------

- Special meta-data needs to be added; otherwise, an exception will be displayed:：

.. code-block:: xml

    <meta-data android:name=" pvr.app.type " android:value="vr"/>
    <meta-data android:name=" pvr.display.orientation " android:value="180"/>

- All activity that needs to be displayed needs to inherited from

.. code-block:: java
    
    com.unity3d.player.UnityPlayerNativeActivityPico    

- Add the necessary permissions

.. code-block:: xml

    <!--The following permissions are required-->
    <!--For SDK basic APIs-->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />	
	
    <!--The following permissions are optional-->
    <!--Required by Globin series controller APIs, optional if the app targeting Neo 2 and Neo 3 series-->
    <uses-permission android:name="android.permission.BLUETOOTH" /> 
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" /> 
    <uses-permission android:name="android.permission.INJECT_EVENTS" /> 
	
    <!--Payment-->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
	
    <!--Vibrate-->
    <uses-permission android:name="android.permission.VIBRATE"/>
		
    <!--Set screen brightness -->
    <uses-permission android:name="android.permission.WRITE_SETTINGS" />
	
    <!--Change language-->
    <uses-permission android:name="android.permission.CHANGE_CONFIGURATION" />
	

3.3 	Recommended SDK Configuration
------------------------------------------------------------

- For Color Space, Gamma and Linear are both supported.

If Linear is selected, then Blit Type needs to be set as “Never”, otherwise Unity will create a buffer unrelated to the display, which will cause some display errors when the build is run.

If Gamma is selected , you can select Never or Always in Blit Type.

.. image:: _static/3.1.PNG

Figure 3.1 Setting of Blit Type

- Graphics APIs do not support Vulkan for the time being. For OpenGLES2 and OpenGLES3, the developers need to choose according to their needs.

- Multi-thread rendering is supported, Refer to the Unity official document for details: (https://docs.unity3d.com/ScriptReference/SystemInfo-graphicsMultiThreaded.html)

.. image:: _static/3.2.PNG

Figure 3.2 Setting of rendering

- In Default Orientation under Unity Player Setting, select Landscape Left (Required)

.. image:: _static/3.3.PNG

Figure 3.3 Setting of Default Orientation

- Check the setting of V Sync Count, and the specific steps are as follows: Enter Edit>Project Settings>Quality,Medium and apply settings pictured below under Levels, and ensure that V Sync Count under Other is Don’t Sync (Required):

.. image:: _static/3.4.PNG

Figure 3.4 Set V Sync Count to Don’t Sync

- Requirements for setting API level:

  Minimum API Level： 23 - 27

  Target API Level: 27 is recommended. See chapter 2.2 for details.

.. image:: _static/3.4.1.PNG

Figure 3.5 Setting API Level