三星SPen悬空操作适配指导 从三星GalaxyNote系列诞生起，SPen就是每一代Note系列的标配与亮点。
SPen始终坚持在硬件和软件方面优化创新，从GalaxyNote9开始SPen增加了蓝牙功能，通过单击或双击SPen上的按键实现远距控制，有效遥控距离高达10米。
比如可以使用SPen翻看相册中的照片，相册中的视频也可以使用SPen播放、暂停，还可以使用SPen远程控制相机进行拍照，轻松捕捉精彩瞬间。
图1|控制拍照在新一代GalaxyNote10上这支小小的笔有了新的设计和功能，它增加了陀螺仪和加速传感器，可以感知手部动作，通过简单的手势即可操控手机。
比如顺时针或逆时针移动SPen可调整摄像头焦距，以便拍摄近景或全景。
在相册中通过左滑右滑可切换到下一张照片，或返回到上一张照片。
通过手势向上调高音量，手势向下降低音量，无需再触碰音量键。
图2|手势 本文将介绍SPen包含按键和手势动作的悬空操作功能，以便开发者把SPen适配到更多的第三方APP中，实现支持更多的操控与应用。

一.悬空操作实现原理SPen通过BLE连接到手机，由SPenFramework管理连接，并会将BLE事件转换为KeyEvent，应用只需要回调现有的KeyEvent-Callback来处理SPen事件即可。
图3|流程图为了实现应用功能，应用必须定义RemoteActions并遵循下面的实现过程。

1.在Manifest文件中指定要映射到SPen远程事件的KeyEvent。

2.实现KeyEvent-Callback（如果需要）。

二．悬空操作实现方法
1.在需要响应的activity中添加和 必须在中指定定义RemoteActions的资源文件.xml 图4|Manifest代码举例
2.在res/xml/下创建一个.xml文件，将文件名命名为步骤2中指定的资源文件名称。
图5|目录举例在xml文件中具有的根元素，并且可以包括多个元素。
另外，每个包含id，label，priority，trigger_key等信息。
图6|xml文件举例 下面对xml文件中的元素进行介绍：1） 2） 图7|action表格 图8|preference代码示例 描述：确定要映射的默认手势，检查此操作是按下按钮还是手势动作属性： name：可设置为“gesture”，“button_only”，“motion_only”-“gesture”：设置您要设置为默认的手势类型-“button_only”：仅为与按钮相关的手势提供操作-“motion_only”：仅为与动作相关的手势提供动作 value-如果name=“gesture”，则下表中的value都可以使用。
-多个值由“|”分隔,例如:“click|swipe_down|swipe_down”。
图9|value说明 -如果name=“button_only”或者“motion_only”，则value允许设置为"true"或"false"。
-如果这个配置与“gesture”的值相矛盾，该设置将被忽略。
例如，如果将“swipe_left”设置为“gesture”的值，而“button_only”为true，则配置是矛盾的，将忽略“button_only”设置。

3.KeyEvent-Callback的实现与处理AndroidKeyEvent相同，建议在onKeyDown处理发送的KeyEvent。
示例：PageDown键：在Y方向上滚动ScrollView+500PageUp键：在Y方向上滚动ScrollView-500 图10|KeyEvent响应代码示例可参考Android开发者官网。
/reference/android/view/KeyEvent.Callback.html
三．SPen一般控制如果应用没有按照上面的悬空操作添加功能，对于相机拍照和注册了Mediasession的媒体应用将 遵循一般控制原则，SPenFramework会将按键和手势动作按下表转化为KeyEvent传送给应用，应用只需要对下面的KeyEvent进行处理就可以响应SPen。

四．SPenRemoteSDKSPen的新功能可识别手势动作，通过SPenFramework可以轻松识别向上，向下，向左，向右，顺时针和逆时针响应方向动作，可以根据需要将这些按钮和动作功能添加到应用程序功能中。
但是，如果应用需要获得SPen运动的原始数据，实现更强大的应用功能，必须使用SPenRemoteSDK。
SPenRemoteSDK提供识别运动坐标和按键功能，应用可以利用原始动作数据，设计自定义的手势轨迹，或者利用相对位置来完成用户交互，增强游戏和应用的用户体验。
关于SPenRemoteSDK后续将会详细介绍，请大家持续关注。
图11|原始坐标手势图
五．联系我们 如果您对SPen悬空操作有任何问题，可以发邮件到下面的邮箱与我们联系。
邮箱地址：rdtpservice@邮件主题：三星SPen+APP名