.. _1	配置HMD和手柄Home键，配置HMD确认、音量、返回键:

1	配置HMD和手柄Home键，配置HMD确认、音量、返回键
===================================================================

支持设备:

Pico G2 系列设备; PicoNeo2 系列设备; Pico Neo3 系列设备（部分按键事件和功能在Neo3系列设备不支持，详见下文）


1.1 按键定义说明
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

键值说明:

=======================     =============================================     ===============================================================================
按键                                                         按键事件                                                                                                           功能
=======================     =============================================     ===============================================================================
HMD和手柄Home键                                单击、双击、长按	                                                                                        回launcher、启动某个应用、返回、矫正正方向、清理内存、通知、禁用
HMD确认键	                               单击	                                                                                                        有效，无效
HMD音量键	                                单击	                                                                                                        有效，无效
HMD返回键                                              单击	                                                                                                        有效，无效
=======================     =============================================     ===============================================================================

1.2 手动修改方案
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

**a.** 获取配置文件 "SystemKeyConfig.prop" (获取路径：http://pan.baidu.com/s/1i5ADcUh) 

**b.** 用记事本打开配置文件 "SystemKeyConfig.prop"  

**c.** 修改按键定义 

- 修改Home键定义 

  Home键的事件有 "单击" "双击" "长按" , 如下:

  ============================     ================================================
  HMD按键                          Unity输入键
  ============================     ================================================
  action_home_single_tap                           单击功能
  action_home_double_tap                         双击功能
  action_home_long_press                          长按功能（Neo3 系列设备不支持）
  ============================     ================================================

  以上按键事件可设定的值为0/1/2/3/4/5/6/7。每个数值对应的响应事件如下：

      0: 无效, 禁用

      1: 启动指定包名类名应用 (Neo3 系列设备不支持)

      2: 回Launcher

      3: 启动Settings

      4: 返回（Neo3 系列设备不支持）

      5: 无功能, 仅发送按键通知 (Neo3 系列设备不支持)

      6: 矫正视野正方向

      7: 清理内存 (Neo3 系列设备不支持)

  根据需求更改按键事件后面的数值, 分别将每个事件赋予不同功能; 举例: 将单击Home键改为返回功能, 修改 "action_home_single_tap=4"  即可。

  设置双击时间间隔, 长按时长, 单位为毫秒, 如下: 

    time_home_double_tap        双击判断间隔
    
    time_home_long_press         长按判断间隔

  设置要启用的指定包名名类应用, 如下:

    action_home_XXX_package=YYY
    
    action_home_XXX_class=ZZZ

    XXX是指单击、双击、长按；分别对应single_tap、double_tap、long_press
    
    YYY替换要启动的应用包名
    
    ZZZ替换要启动的应用类名

- 修改HMD确认键、音量键、返回键定义

  这三个按键只能屏蔽失效或者恢复正常; 配置文件中以下几个值, 设置为0则对应的按键功能失效。设置为1, 则对应功能恢复正常。

    action_key_enter=0
    
    action_key_volumeup=0
    
    action_key_volumedown=0
    
    action_key_back=0

**d.** 打开adb，将文件拷贝到data/local/tmp目录下, 指令如下: 

adb push SystemKeyConfig.prop /data/local/tmp/

**e.** 重启设备

1.3 代码修改按键配置
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

通过调用SDK 接口的方法修改按键

https://sdk.picovr.com/docs/sdk/cn/chapter_seven.html#upvr-propertysethomekey