Noitom Hi5 VR手套

作者：追风剑情发布于：2019-6-11 10:41 分类：Unity3d

官网 https://www.noitom.com.cn/
SDK下载 https://hi5vrglove.com/downloads

一、开发环境安装

1、通过Unity Asset Store找到SteamVR plugin并导入到工程。
2、从官网下载Hi5_Unity_SDK_1_0_0_655_16.unitypackage、Hi5_Unity_Interaction_SDK_1.1.0.35.unitypackage并导入到工程。

新建层 Edit->Project Setting->Tags and Layers

Hi5OtherFingerTail
Hi5OtherFingerOther
Hi5Palm
Hi5ObjectGrasp
Hi5Plane
Hi5ObjectTrigger
Hi5IndexFingerTail

设置物理碰撞 Edit->Project Setting->Physics

阅读SDK中的两个文档
《Hi5_Unity_Interaction_SDK_UserGuide_1.1.0.35.pdf》
《Hi5_Unity_Interaction_SDK_API_1.1.0.35.pdf》

二、校准手套
使用数据手套前需要先校准手套与定位器。
运行校准场景

三、脚本功能

建议使用随SDK提供的模型。

包含的手势功能：
抓(grabbing)、捏(pinching)、松(releasing)、扔(throwing)、举(lifting)、戳(poking)、手按压(hand pressing)和交换物体(exchanging objects)。
4个基本手势: (由Hi5_Glove_Gesture_Recognition脚本在Update方法中进行实时判断)
OKay，平掌(Flat Palm)，拳头(Fist)、指(Pointing(index finger))

通过调用Hi5_Hand_Visible_Hand对象的.GetHand().GetRecognitionState();可获得基本手势状态Hi5_Glove_Gesture_Recognition_State。参见Hi5_Interface_Hand

Hi5_Interaction_Object_Manager
管理所有挂了Hi5_Glove_Interaction_Item的子节点。

EStatic: 物体静止
EMove: 物体移动
EPinch: 物体被抓在手上
EClap: 物体被手拍打
EFlyLift: 物体被举起
EPoke: 物体被戳(食指)
注意：作为按钮的几何体一般同时监听EClap和EPoke两个事件。

ENone: 没移动
EThrowMove: 在空中掉落
EPlaneMove: 在平面上移动(或滚动)
EFree: X、Y、Z轴都不受旋转约束

Hi5_MessageKey
消息类型常量类。
//监听消息
Hi5_Glove_Interaction_Message message = Hi5InteractionManager.Instance.GetMessage();
message.RegisterMessage(ResetFun, Hi5_MessageKey.messageObjectReset);
//监听对象事件(手与物体发生交互时触发),参见EEventObjectType、Hi5_Glove_Interaction_Object_Event_Data
message.RegisterMessage(MessageFun, Hi5_Glove_Interaction_Message.Hi5_MessageMessageKey.messageObjectEvent);
//监听手势事件(手势动作发生变化时触发),参见EEventHandType、Hi5_Glove_Interaction_Hand_Event_Data
message.RegisterMessage(MessageFun, Hi5_Glove_Interaction_Message.Hi5_MessageMessageKey.messageHandEvent);

namespace Hi5_Interaction_Core
{
	//消息类型常量
	public class Hi5_MessageKey
	{
		public static readonly string messagePinchObject = "messagePinchObject";
		public static readonly string messageUnPinchObject = "messageUnPinchObject";
		public static readonly string messageGetObjecById = "messageGetObjecById";
		public static readonly string messageObjectReset = "messageObjectReset";
		public static readonly string messagePinchObject2 = "messagePinchObject2";
		public static readonly string messageUnPinchObject2 = "messageUnPinchObject2";
		public static readonly string messageFlyPinchObject = "messageFlyPinchObject";
		public static readonly string messageLiftObject = "messageLiftObject";
		public static readonly string messagePinchOtherHandRelease = "messagePinchOtherHandRelease";
	}
}

Hi5_Glove_Interaction_Finger
单个手指的手势判断。
IsFingerFist()//判断握拳
IsFingerPlane()//判断手掌平摊
IsLift()//判断托举
IsClap()//判断拍打
IsFlyRunPinch()//判断轻握

//判断手指弯曲度,这是手指手势判断的关键原理。
float GetAngle(Transform leftTransform, Transform midTransform, Transform rightTransform)
{
	Vector3 left = leftTransform.position;
	Vector3 middle = midTransform.position;
	Vector3 right = rightTransform.position; // finger tip
	Vector3 vLeft = left - middle;
	Vector3 vRight = right - middle;
	float angle = Vector3.Angle(vLeft, vRight);
	return angle;
}

Hi5_Object_JudgeMent
负责对单只手的手势判断。

Hi5_Glove_Interaction_Hand
管理单只手的各手指及关节。

Hi5_Glove_Gesture_Recognition
在Update中进行实时手势状态判断。

namespace Hi5_Interaction_Core
{
	手势状态枚举
	public enum Hi5_Glove_Gesture_Recognition_State
	{
		ENone = 0,
		EOk,
		EFist, //握拳
		EIndexPoint, //用食指指的动作(中指、无名指、小指弯曲)。
		EHandPlane //手掌摊平
	}
}

Hi5_Interface_Button
按钮基类，可以继承它，并重写MessageFun()方法。在MessageFun()方法中可监听不同的触发事件，然后调用ObjectItem.ChangeColor(Color.red);来改变几何体颜色。参见Hi5_Reset_Button、EObject_Type

手套振动
HI5_Manager.EnableLeftVibration (200);//左手振动0.2秒
HI5_Manager.EnableRightVibration (200);//右手振动0.2秒

Hi5_Interaction_Item_Collider
处理碰撞
//当处于以下设置的物体与手指发生碰撞时会触发E_Object_State.EPoke事件(物体为按钮的情况,相当于OnMouseDown事件)
itemObject.mObjectType=EObject_Type.EButton
itemObject.state=E_Object_State.EStatic

Hi5_Object_Property
附加属性设置

Hi5_Interaction_Const
交互参数

HI5_VIVEInstance
负责实时跟踪手势动作，通过监听SteamVR的NewPosesAction事件实现。