鸟语天空

WaveVR Plugin 3.x.x概述

作者：追风剑情 发布于：2019-3-26 16:58 分类：Unity3d

HTC Vive Focus(HTC的VR一体机)

VIVE Wave SDK下载
https://developer.vive.com/resources/vive-wave/download/latest/

Wave Unity SDK文档
https://hub.vive.com/zh-CN/profile/documents

Import Package到Unity工程

VIVE Wave XR插件 (需要Unity2019.4.3+版本)
VIVE Wave XR插件 - 入门

1、配置 {工程目录}\Packages\manifest.json

关于 Scoped Registries

{
  "scopedRegistries": [
    {
      "name": "VIVE",
      "url": "https://npm-registry.vive.com",
      "scopes": [
        "com.htc.upm"
      ]
    }
  ],
  "dependencies": {
    ......
  }
}

2、安装 VIVE Wave XR Plugin

安装方式二
从官网下载 com.htc.upm.wave.xrsdk-4.5.0-r.3.tgz
在Package Manager中点击+号，选择 Add package from tarball...，导入下载好的xx.tgz包，导入后可在Project面板的Packages目录下看到此包。

2、设置 XR Plug-in Manager

3、设置渲染模式

为了使 SinglePass(默认) 正常运行，您的Wave XR应用程序需要使用OpenGLES 3.2运行。

现在，您可以开始开发可以在VIVE Wave设备上运行的XR内容。

4、安装其他Wave软件包
VIVE Wave XR Plugin - Essence
VIVE Wave XR Plugin - Native
安装这些软件包以访问VIVE Wave平台专有的API和功能。有关更多信息，请检查 Wave Packages。

下载按键预设 InputManager.preset

VIVE Focus向电脑投屏
https://www.vive.com/cn/forum/3497?1
电脑需要连接第三方硬件 Miracast 才能启用无线投屏。
点击电脑下方的这个图标(笔机本win10)

如果找不到这个图标，可在设置面板里搜索“投影设置”

再点

选择

类职责说明
WaveVR_Init
负责监听所有WVR_EventType事件

WaveVR_ControllerLoader
负责加载控制器模型

WaveVR_PoseTrackerManager
负责管理WaveVR_DevicePoseTracker、WaveVR_ControllerPoseTracker

WaveVR_DevicePoseTracker
头显姿态追踪器

WaveVR_ControllerPoseTracker
控制器姿态追踪器

WaveVR_Beam
负责生成控制器的射线

WaveVR_ControllerPointer
负责生成控制器射线的端点

UniversalControllerActions
负责处理控制器显示状态

WaveVR_Camera
处理Camera的OnPreRender()、OnRenderObject()事件回调

WaveVR_Distortion
当运行在UNITY_EDITOR时，负责控制画面渲染。

监听控制器按键

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;
using wvr;

/// <summary>
/// 监听用户的控制器操作
/// </summary>
public class UserControllerListener : MonoBehaviour {

    public WVR_DeviceType deviceType = WVR_DeviceType.WVR_DeviceType_Controller_Right;

    private void Awake()
    {
        WaveVR_ControllerListener.Device device = WaveVR_ControllerListener.Instance.Input(deviceType);
        device.PressUpListenersMenu += OnPressUpListenersMenu;
    }

    private void OnPressUpListenersMenu()
    {
        //TODO:: 处理菜单按键事件
    }
}

支持的按键事件
public delegate void ButtonEventHandler();
// Listeners of press
public event ButtonEventHandler PressDownListenersMenu;
public event ButtonEventHandler PressDownListenersGrip;
public event ButtonEventHandler PressDownListenersTouchpad;
public event ButtonEventHandler PressDownListenersTrigger;
public event ButtonEventHandler PressUpListenersMenu;
public event ButtonEventHandler PressUpListenersGrip;
public event ButtonEventHandler PressUpListenersTouchpad;
public event ButtonEventHandler PressUpListenersTrigger;
// Listeners of touch
public event ButtonEventHandler TouchDownListenersTouchpad;
public event ButtonEventHandler TouchDownListenersTrigger;
public event ButtonEventHandler TouchUpListenersTouchpad;
public event ButtonEventHandler TouchUpListenersTrigger;

Wave VR Plugin 4.x.x

using UnityEngine;
using UnityEngine.Video;
using Wave.Native;
using Wave.Essence;
/// <summary>
/// 监听用户的控制器操作
/// </summary>
public class UserControllerListener : MonoBehaviour
{
    [SerializeField]
    private VideoPlayer videoPlayer;
    private bool binaryValue = false;
    private bool preMenuPress = false;

    private void Update()
    {
        //按手柄上的菜单键控制视频 "暂停/播放"
        binaryValue = WXRDevice.KeyDown(XR_Device.Dominant, XR_BinaryButton.menuButton);
        //避免重复处理KeyDown
        if (preMenuPress != binaryValue)
        {
            preMenuPress = binaryValue;
            if (preMenuPress)
            {
                if (videoPlayer.isPlaying)
                    videoPlayer.Pause();
                else
                    videoPlayer.Play();
            }
        }
    }

    private void DEBUG(string msg)
    {
        //无法打印 "Unity" tag
        Log.d("Unity360", msg, true);
    }
}

1、打印日志

使用WaveSDK中的日志类，需要引入 using WVR_Log;，才能在运行时看见日志。
Log.d(LOG_TAG, "***** message ******", true); //可以定义TAG
查看日志

2、与3D模型事件交互

using UnityEngine;
using UnityEngine.EventSystems;
using WVR_Log;
/// <summary>
/// 3D模型事件交互
/// 创建一个Sphere模型，并将此脚本挂上
/// </summary>
public class SphereEventTest : MonoBehaviour,
	IPointerEnterHandler,
	IPointerExitHandler,
	IPointerDownHandler,
	IPointerUpHandler
{
    private const string LOG_TAG = "SphereEventTest";

    public void OnPointerDown(PointerEventData eventData)
    {
        Log.d(LOG_TAG, "***** OnPointerDown", true);
        GetComponent<MeshRenderer>().material.SetColor("_Color", Color.yellow);
        StartCoroutine(DelayCheckDevicePress());
    }

    public void OnPointerUp(PointerEventData eventData)
    {
        StartCoroutine(DelayCheckDevicePress());
    }

    public void OnPointerEnter(PointerEventData eventData)
    {
        Log.d(LOG_TAG, "***** OnPointerEnter", true);
        GetComponent<MeshRenderer>().material.SetColor("_Color", Color.red);
    }

    public void OnPointerExit(PointerEventData eventData)
    {
        Log.d(LOG_TAG, "***** OnPointerExit", true);
        GetComponent<MeshRenderer>().material.SetColor("_Color", Color.green);
    }

    IEnumerator DelayCheckDevicePress()
    {
        yield return null;//延迟到下一帧，再执行下面的逻辑
        //因为GetPress()内部采用延迟检测,所以我们延迟一帧检测按键，这样才准确。
        var device = WaveVR_ControllerListener.Instance.Input(WVR_DeviceType.WVR_DeviceType_Controller_Right);
        //是否按下了扳机键
        bool isPressedTrigger = device.GetPress(WVR_InputId.WVR_InputId_Alias1_Trigger);
        //是否按下了触摸板
        bool isPressedTouchpad = device.GetPress(WVR_InputId.WVR_InputId_Alias1_Touchpad);

        if (isPressedTrigger)
        {

        }
        else if (isPressedTouchpad)
        {

        }
    }
}

3、示例：登录界面

using System.Text;
using UnityEngine;
using UnityEngine.UI;
using UnityEngine.SceneManagement;
using wvr;
/// <summary>
/// 登录界面
/// </summary>
public class LoginUI : EventBehaviour 
{
	private const string LOG_TAG = "LoginUI";
	//账号输入框
	[SerializeField]
	private InputField _accountInputField;
	//密码输入框
	[SerializeField]
	private InputField _passwordInputField;
	private string _inputPassword;
	private bool _isInputPassword = false;
	private string _inputContent = null;
	private bool _keyboardInitialized = false;
	private WaveVR_IMEManager.IMEParameter _imeParameter = null;
	private float _lastPressDownMenuTime;


	protected override void OnAwake()
	{
		var device = WaveVR_ControllerListener.Instance.Input(WVR_DeviceType.WVR_DeviceType_Controller_Right);
		device.PressDownListenersMenu += OnPressDownListenersMenu;
	}

	//按下-控制器菜单键
	private void OnPressDownListenersMenu()
	{
		//DEBUG(LOG_TAG, "****** OnPressDownListenersMenu");
		//双击控制器菜单键退出应用
		if (Time.realtimeSinceStartup - _lastPressDownMenuTime < 0.3f)
			Application.Quit();
		_lastPressDownMenuTime = Time.realtimeSinceStartup;
	}

	//初始化虚拟键盘
	private void InitializeKeyboards()
	{
		var pmInstance = WaveVR_IMEManager.instance;
		_keyboardInitialized = pmInstance.isInitialized();
		if (_keyboardInitialized)
			DEBUG(LOG_TAG, "InitializeKeyboards: done");
		else
			DEBUG(LOG_TAG, "InitializeKeyboards: failed");
		_imeParameter = InitParameter();
	}

	//初始化虚拟键盘参数
	private WaveVR_IMEManager.IMEParameter InitParameter()
	{
		int MODE_FLAG_FIX_MOTION = 0x02;
		//int MODE_FLAG_AUTO_FIT_CAMERA = 0x04;
		int id = 0;
		int type = MODE_FLAG_FIX_MOTION;
		int mode = 2;

		string exist = "";
		int cursor = 0;
		int selectStart = 0;
		int selectEnd = 0;
		double[] pos = new double[] { 0, 0, -1.05 };
		double[] rot = new double[] { 1.0, 0.0, 0.0, 0.0 };
		int width = 800;
		int height = 800;
		int shadow = 100;
		string locale = "en_US";
		string title = "IME Title";
		int extraInt = 0;
		string extraString = "";
		int buttonId = 16;//System:0 , Menu:1 , Grip:2, Touchpad:16, Trigger:17
		var parameter = new WaveVR_IMEManager.IMEParameter(id, type, mode, exist, cursor, selectStart, selectEnd, pos,
							 rot, width, height, shadow, locale, title, extraInt, extraString, buttonId);
		//IMEParameter(int id, int type, int mode, double[] pos, double[] rot, int width, int height,
		//int shadow, string locale, string title, int buttonId)
		return parameter;
	}

	//虚拟键盘输入完成回调
	public void InputDoneCallback(WaveVR_IMEManager.InputResult results)
	{
		DEBUG(LOG_TAG, "inputDoneCallback:" + results.InputContent);
		_inputContent = results.InputContent;

		//Log.i(LOG_TAG, "InputDoneCallback() state = " + getKeyboardState());
		//Note: directly update input field text will exception
		// use LastUpdate to update Input field text
		//UpdateInputField(_inputContent);
	}

	//更新InputField显示
	public void UpdateInputField(string str)
	{
		//DEBUG(LOG_TAG, "UpdateTargetText:" + str);
		if (str == null)
			str = string.Empty;

		if (_isInputPassword)
		{
			_inputPassword = str;
			if (string.IsNullOrEmpty(str))
				_passwordInputField.text = str;
			else
			{
				//显示*号
				StringBuilder sb = new StringBuilder();
				for (int i = 0; i < str.Length; i++)
					sb.Append("*");
				_passwordInputField.text = sb.ToString();
			}
		}
		else
			_accountInputField.text = str;
	}

	void LateUpdate()
	{
		UpdateInputField(_inputContent);
	}

	//点击-账号输入框
	public void OnClickAccountInputField()
	{
		_isInputPassword = false;
		_accountInputField.shouldHideMobileInput = false;
		if (!_keyboardInitialized)
			InitializeKeyboards();
		var pmInstance = WaveVR_IMEManager.instance;
		pmInstance.showKeyboard(_imeParameter, InputDoneCallback);
	}

	//点击-密码输入框
	public void OnClickPasswordInputField()
	{
		_isInputPassword = true;
		_passwordInputField.shouldHideMobileInput = false;
		if (!_keyboardInitialized)
			InitializeKeyboards();
		var pmInstance = WaveVR_IMEManager.instance;
		pmInstance.showKeyboard(_imeParameter, InputDoneCallback);
	}

	//点击-登录按钮
	public void OnClickLogin()
	{
		SceneManager.LoadSceneAsync("FOXCONN_Industrial");
	}
}

标签: WaveVR