Unity SDK 文档¶
HaloMiniKit_API¶
HaloMiniKit_API 说明¶
HaloMiniKit 内容包括HaloMini 相机、蓝牙手柄的设置
HaloMiniSystem¶
HaloMini系统组件
属性
是否开启遥控器3D模式
public bool bluetoothHandle3D = false;
运行时更改此参数无效 如需更改 请使用
BluetoothHandleDevice.Instance.Mode3D (bool value)
是否开启3d摄像机（分屏模式）
public bool camera3D = true;
HaloMiniCamera¶
相机控制器
属性
public Camera leftCam ;
public Camera rightCam ;
public float interPupilDistance = 0.064f; //视距
HaloMiniInput¶
蓝牙手柄姿态四元素（3d模式下可用）
public static Quaternion BluetoothHandleRotation;
蓝牙手柄姿态欧拉角（3d模式下可用）
public static Vector3 BluetoothHandleAngles;
蓝牙手柄重力向量（3d模式下可用）
public static Vector3 BluetoothHandleAcc;
蓝牙手柄链接状态
public static bool isControllerConnect = false;
蓝牙手柄连接回调
public static event ControllerConnect ControllerConnectEvent;
蓝牙手柄断开回调
public static event ControllerUnConnect ControllerUnConnectEvent;
触控板向前滑动回调
public static event TouchPadSlideBack TouchPadSlideBackEvent;
触控板向后滑动回调
public static event TouchPadSlideForward TouchPadSlideForwardEvent;
触控板向上滑动回调
public static event TouchPadSlideUp TouchPadSlideUpEvent;
触控板向下滑动回调
public static event TouchPadSlideDown TouchPadSlideDownEvent;
返回键按下回调 如果不使用此回调 按下返回键后将退出游戏
public static event EscapeDown EscapeDownEvent;
BluetoothHandleDevice¶
开启或关闭蓝牙手柄3d模式
public void Mode3D (bool value)
开启或关闭3DOF数据接收
public void enable3Dof(bool value)
开启或关闭重力数据接收
public void enableAcc(bool value)
ShadowKit_API¶
ShadowKit_API 说明¶
ShadowKit 内容包括视线焦点、基础输入设备管理、按钮、登陆系统
ShadowSystem¶
影创sdk系统组件
属性
应用获得/失去焦点代理 这里只是做了个统一处理 实际引用时也可以写在各自类中
public static event onApplicationFocus onApplicationFocusEvent;
头部（包括摄像机、焦点等）
public static GameObject Head;
主摄像机
public static Camera Camera;
应用退出方法
public static Action Quit;
登陆系统
public static LoginSystem loginSystem;
InputSystem输入设备管理器¶
属性
射线最远距离
public static OnUpdate OnUpdateEvent;
public float MaxRaycastDistance = 20.0f;
可选择物体的层 可以根据实际情况设定
public LayerMask RaycastLayerMask = Physics.DefaultRaycastLayers;
SCButton 3D按钮¶
（3D按钮必须添加BoxCollider 脚本中已绑定 并且Layer在InputSystem的RaycastLayerMask中）
属性
public Transition transition
焦点进入和移出时的状态变化
//Scale
public float scalNum = 1.1f; //Scale 变化比例
public float forwardNum = 0.05f; //Scale 变化时间
//Position
public float forwardNum = 0.05f; //Position 向前位移距离
public float forwardNum = 0.05f; //Position 变化时间
点击 可在Inspector里配置
public UnityEvent onClick;
焦点移入
public UnityEvent onEnter;
焦点移出
public UnityEvent onExit;
焦点进入时自动触发click事件的等待时间 0为不需要此功能
public float autoClickTime;
方法
public virtual void OnPointerDown(PointerEventData data)
public virtual void OnPointerUp(PointerEventData data)
public virtual void OnPointerClick(PointerEventData data)
public virtual void OnPointerEnter(PointerEventData eventData)
public virtual void OnPointerExit (PointerEventData eventData)
UIButton UI按钮¶
继承自UnityEngine.UI.Button 用法和UnityEngine.UI.Button相同 （UI按钮必须添加BoxCollider 脚本中已绑定 并且Layer在InputSystem的RaycastLayerMask中）
Unity使用教程¶
导入sdk¶
安装需求：Unity 2017.0.3或更高
首先，你需要下载影创Unity SDK，找到SDK_HaloMini.unitypackage，创建一个工程，然后将SDK导入到Unity中。
初始化HaloMini场景¶
1.新建新的场景
2.将场景中的“Main Camera”删除
3.点击工具栏 ShadowCreator->Create->HaloMini 添加HaloMini组件
4.添加完组件后会在舞台上生成3个组件 “ShadowSystem”“HaloMiniSystem”“HaloMiniCamera”,其中“ShadowSystem”“HaloMiniSystem”会持久化在舞台上，切换场景时会自行进行匹配。“HaloMiniCamera”可以跟据实际情况进行调整，会随着场景移除而销毁
开启和关闭Bluetooth手柄3D模式¶
在场景制作时 选中HalominiSystem ，在Inspactor中改变Bluetooth Handle 3D开启和关闭应用启动时蓝牙手柄3d模式
运行时请使用BluetoothHandleDevice.Instance.Mode3D (bool value)进行开启和变比蓝牙手柄3D模式
开启和关闭Camera的3D模式（分屏模式）¶
在场景中选中HalominiSystem ，在Inspactor中勾选Camera 3D开启或关闭摄像头3d（分屏）模式 此模式在应用启动后无法通过代码动态更改
Bluetooth手柄使用方法¶
开启和关闭蓝牙手柄的3D模式
BluetoothHandleDevice.Instance.Mode3D(true);
BluetoothHandleDevice.Instance.Mode3D(false);
开启和关闭蓝牙手柄的3Dof数据接收
BluetoothHandleDevice.Instance.enable3Dof(true);
BluetoothHandleDevice.Instance.enable3Dof(false);
开启和关闭蓝牙手柄的重力数据接收
BluetoothHandleDevice.Instance.enableAcc(true);
BluetoothHandleDevice.Instance.enableAcc(false);