.. _5 各硬件产品开发指南: 5 各硬件产品开发指南 =============================== 本章将介绍SDK在Pico各硬件产品上的使用方法，开发者根据需要选择相应的内容即可。 5.1 Pico硬件通用说明 ---------------------------------- 5.1.1 基本使用教程 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 关于XR Interaction Toolkit的教程可参考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.3.png 图5.1 Controller预制体放置位置 2、使用自定义手柄模型 如果您使用了自定义的手柄模型（比如手枪、弹弓、魔杖、剑等道具），请勾选此选项。 .. image:: _static/5.3.1.png 图5.2 自定义手柄模型选项 3、模型角度调整 Pico Neo3手柄硬件结构与Pico Neo2不同，Pico Neo3手柄握持与水平方向有一个34度的夹角，如下图。 .. image:: _static/5.3.2.png 图5.3 Pico手柄角度示意图 新版本SDK为了支持Pico Neo3应用在Pico Neo2上的兼容，对手柄模型增加了角度的调整，以保证Neo3上开发的应用可以在Neo2上正常使用；如果您需要使用新SDK在Neo2上开发应用，则需要对模型角度作调整，您需要在X轴方向上向上抬高34度. 5.2 Pico G2 4K输入说明 -------------------------------- 使用单手柄的按键与触摸板，需要调用接口API，详见第七章。这里仅介绍接口API的参数与物理手柄按键的对应关系： ============================== ================================================ 按键 输入事件 ============================== ================================================ .. image:: _static/5.1.6.png CommonUsages.menuButton .. image:: _static/5.1.7.png CommonUsages.triggerButton .. image:: _static/5.1.8.png CommonUsages.primary2DAxisClick ============================== ================================================ 触摸板的示意图如下： .. image:: _static/5.1.9.png 图5.4 触摸板示意图 5.3 Pico Neo 2 输入说明 -------------------------------- 使用双手柄的按键与摇杆，需要在调用接口API，详见第七章。这里仅介绍接口API的参数与物理手柄按键的对应关系： Pico Neo 2: ============================== ================================================ 按键 输入事件 ============================== ================================================ .. image:: _static/5.1_1.png CommonUsages.menuButton .. image:: _static/5.1_2.png CommonUsages.triggerButton .. image:: _static/5.1_3.png CommonUsages.gripButton .. image:: _static/5.1_5.png CommonUsages.primary2DAxisClick .. image:: _static/5.1_6.png CommonUsages.primaryButton .. image:: _static/5.1_7.png CommonUsages.secondaryButton .. image:: _static/5.1_8.png CommonUsages.primaryButton .. image:: _static/5.1_9.png CommonUsages.secondaryButton ============================== ================================================ 5.4 Pico Neo 3 输入说明 -------------------------------- 使用双手柄的按键与摇杆，需要调用接口API，详见第七章。这里仅介绍接口API的参数与物理手柄按键的对应关系： Pico Neo 3: .. image:: _static/5.8.png 图5.5 按键映射图(前视图) .. image:: _static/5.8.1.png 图5.6 按键映射图(侧视图) ============================ ================================================ 按键 输入事件 ============================ ================================================ Menu CommonUsages.menuButton Trigger CommonUsages.triggerButton Grip CommonUsages.gripButton Joystick CommonUsages.primary2DAxisClick X/A CommonUsages.primaryButton Y/B CommonUsages.secondaryButton ============================ ================================================ 5.5 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.9.png 图5.7 新旧输入系统切换