.. _5 硬件产品开发指南:

5 硬件产品开发指南
===============================

本章将介绍SDK在Pico硬件产品上的使用方法，开发者根据需要选择相应的内容即可。

5.1	Pico硬件通用说明
----------------------------------

5.1.1	基本使用教程
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

关于XR Interaction Toolkit的教程可参考 `Unity官方教程`_ 。

.. _Unity官方教程: https://docs.unity3d.com/Packages/com.unity.xr.interaction.toolkit@0.9/manual/index.html

5.1.2	手柄使用说明
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

1、展开PicoXR Plugin> Assets> Resources> Prefabs，分别将ControllerModel预制体放到场景中，如下图：

.. image:: _static/5.1.png

图5.1 Controller预制体放置位置

2、使用自定义手柄模型

如果您使用了自定义的手柄模型（比如手枪、弹弓、魔杖、剑等道具），请勾选此选项，或者选择不放置ControllerModel的prefab。

.. image:: _static/5.2.png

图5.2 自定义手柄模型

5.2	Pico Neo 3 输入说明
--------------------------------

使用双手柄的按键与摇杆，需要调用接口API，详见第七章。这里仅介绍接口API的参数与物理手柄按键的对应关系：

Pico Neo 3:

.. image:: _static/5.3.png

图5.3 按键映射图(前视图)

.. image:: _static/5.4.png

图5.4 按键映射图(侧视图)

============================     ================================================
按键                                       输入事件
============================     ================================================
Menu                             CommonUsages.menuButton
Trigger                           CommonUsages.TriggerButton
Grip                                CommonUsages.GripButton
Joystick                          CommonUsages.primary2DAxisClick
X/A                                CommonUsages.primaryButton
Y/B                              CommonUsages.secondaryButton
============================     ================================================

5.3	Pico 一体机按键
--------------------------------

下表是Pico一体机上的按键与Unity里的键值对应关系。

============================     ================================================
HMD按键                           Unity输入键
============================     ================================================
返回键                           KeyCode.Escape
确认键                           KeyCode.JoystickButton0
Home键                           KeyCode.Home(系统占用，默认不开放)
音量增加键                       Android标准VOLUME_UP(系统占用，默认不开放)
音量减小键                       Android标准VOLUME_DOWN(系统占用，默认不开放)
============================     ================================================

备注：KeyCode.JoystickButton0在新的Input系统获取会报错且无法识别确认键。如果仍旧想使用旧的Input系统来获取确认键，则需要在Player Settings-> Player-> Other Settings->Active Input Handling*中勾选Both或者切回Input Manager(Old)。 

.. image:: _static/5.5.png

图5.5 新旧输入系统切换