龙之谷手游WebVR技术分享

时间：2021-05-07 07:10:38

主要面向Web前端工程师，需要一定Javascript及three.js基础；
本文主要分享内容为基于three.js开发WebVR思路及碰到的问题；
有兴趣的同学，欢迎跟帖讨论。

目录：
一、项目体验
1.1、项目简介
1.2、功能介绍
1.3、游戏体验
二、技术方案
2.1、为什么使用WebVR
2.2、常用的WebVR解决方案
2.2.1、Mozilla的A-Frame方案
2.2.2、three.js及webvr-polyfill方案
三、技术实现
3.1、知识储备
3.2、实现步骤
3.3、工作原理
四、技术难点
4.1、程序与用户共同控制摄像头
4.2、多重蒙板贴图
4.3、镜头移动
4.4、3d自适应长度文字提示
4.5、unity3d地形导出
4.6、3dmax动画导出问题
五、完整的源代码及相应组件

一、项目体验
1.1、项目简介：
1.1.1、名称：
“重历阿尔特里亚”——龙之谷手游手首发ChinaJoy2016预热VR小游戏
龙之谷手游WebVR技术分享

1.1.2、开发背景：
基于龙之谷手游具备的3D属性，全景视角体验，以及ChinaJoy首发的线下场景，我们和品牌讨论除了基于VR的线下体验项目。由于基于Web技术较好的兼容性、开发的高效性，我们采用了WebVR技术来实现整个体验。

1.1.3、使用WebVR优势：
1.1.3.1、普通web前端工程师可以参与VR应用开发，降低了开发门槛；
1.1.3.2、跨设备终端、跨操作系统、跨APP载体；
1.1.3.3、开发快速、维护方便、随时调整、传播便捷；
1.1.3.4、浏览器即可体验，无需安装。

1.2、功能介绍
基于游戏内3D场景、人物和道具模型，通过WebGL框架three.js开发的VR小游戏，在ChinaJoy龙之谷手游展台给玩家提供线下VR互动体验，并在后续应用于线上营销传播。不具备VR眼镜设备的用户可选择普通模式进行互动体验。

1.3、游戏体验
如果你身边正好有VR眼镜，请选择VR模式体验；如果没有，请选择普通模式。
需要说明的是，由于本次应用针对线下场景，而合作方三星提供了最新的S7手机和GearVR设备，所以项目只针对S7做了体验优化，所以可能部分手机会有卡顿或者3D模型错乱的情况。

你可以扫描如下二维码或打开http://dn.qq.com/act/vr/进行体验：
龙之谷手游WebVR技术分享

二、技术方案
2.1、为什么是时候尝试WebVR了？
2.1.1、时机慢慢成熟，我们通过几件事件即可感知：
2015年初，Mozilla在firefox nightly增加了对WebVR的支持；
2015年底，MozVR团队推出开源框架A-Frame，能过HTML标签，即可创建VR网页；
2015年底，Egret3D发布，开发团队称将在以后版本中实现WebVR的支持；
2016年初，Google与Mozilla联合创建WebVR标准；
2016年6月，Google计划将整个Chrome浏览器搬进VR世界中。
2.1.2、WebVR开发成本更低。
2015年VR硬件迅速发展，但时至今日，VR内容还是稍显单薄。原因在于，VR开发成本过高，而WebVR依托于WebGL及类似threeJS等框架，大大降低开发者进入VR领域的门槛。
2.1.3、Web自身的优势
上文中已有提及，依托也Web，具有不需安装、便于传播、便于快速迭代等特点。

2.2、目前阶段，常用的WebVR解决方案：
2.2.1、A-frame
介绍：Mozilla的开源框架，通过定制HTML元素即可构建WebVR方案的框架，适用于没有webGL与threeJS基础的初学者。
优点：基于threeJS的封装，通过特定的标签就能够快速创建VR网页；
缺点：所提供的组件有限，难以完成较复杂的项目。
实例：
2.2.1.1、创建一个简单的场景。

<!DOCTYPE html>

<html>

<head>

<meta charset="utf-8">

<meta name="description" content="Composite — A-Frame">

<script src="../aframe.js"></script>

</head>

<body>

	<a-scene>

		<!-- 环境光. -->

		<a-entity light="type: ambient; color: #888"></a-entity>

		<a-entity position="0 2.2 4">

		<!-- 添加相机 -->

		<a-entity camera look-controls wasd-controls>

			<!-- 添加圆环 -->

			<a-entity cursor

			geometry="primitive: ring; radiusOuter: 0.015; radiusInner: 0.01; segmentsTheta: 32" material="color: #283644; shader: flat" raycaster="far: 30" position="0 0 -0.75"></a-entity>

		</a-entity>

		</a-entity>

	</a-scene>

</body>

</html>

源码讲解：
如上简单的几个标签，即可构建一个包含灯光、相机、跟随相机的物体的场景，其余事情，都将由A-frame进行解析，具体标签与属性不多作讲解，可以参考 A-frame DOC。

2.2.1.1、加载一个由软件（比如3dmax）导出的模型。

<!DOCTYPE html>

<html>

<head>

<meta charset="utf-8">

<meta name="description" content="Composite — A-Frame">

<script src="../aframe.js"></script>

<script>

	AFRAME.registerComponent('json-model', {

		schema: {

			type: 'src'

		},

		init: function () {

			this.loader = new THREE.JSONLoader();

		},

		update: function () {

			var mesh = this.el.getOrCreateObject3D('mesh', THREE.Mesh);

			this.loader.load(this.data, function (geometry) {

			mesh.geometry = geometry;

			});

		}

	});

</script>

</head>

<body>

<a-scene>

	<a-assets>

		<a-asset-item id="sculpture" src="data/building-ground.js"></a-asset-item>

	</a-assets>

	<a-entity id="car" json-model="#sculpture"  position="0 0 0" scale="5 5 5" rotation="0 45 0" material="src: url(cross-domain/skin/xianxiasq_zhujianqiangmian_001.png)"></a-entity>

</a-scene>

</body>

</html>

源码讲解：
这个例子主要演示，A-Frame如何添加组件，对，因为A-Frame现阶段组件太少，加载自定义模式需要自己扩展组件。而组件添加需要three.js基础。
so，A-Frame出发点是非常美好的，学习几个简单的标签及属性，即可以搭建3d/webvr场景，但是现实却是目前它还并不成熟，并且伴随着A-Frame主设计师跳槽到Google，所以我很早就放弃这个方案了。

2、基于threeJS与webVR组件，事实上，A-frame就是基于这两者的封装。
优点：可以完成复杂项目，可以结合原生的webGL；
缺点：需要掌握threeJS，需要了解webGL，学习成本较高。

在本项目中，选用的就是这个方案，在下章节中，将会进行详细介绍。

三、技术实现
3.1、知识储备：
three.js（掌握）、webGL（了解）、javascript
对three.js没有基础的同学，可以移步至 Three.js实例教程

3.2、实现步骤：
简单来说，完成一个WebVR应用，需要以下三个步骤：
3.2.1、搭建场景
龙之谷手游WebVR技术分享

如上图与示：
首先我们需要载入我们的资源，这些资源包括地形、角色、动画、及辅助元素；
然后创建我们需要的元素，比如灯光、相机、天空等；
然后完成主业务逻辑。

3.2.2、交互
即用户的动作输入，这些动作包括：
位置移动、旋转、视线焦点、声音、甚至全身所有关节动作。
当然，当前我们可利用的硬件设备有限，手机自身可利用的如陀螺仪、罗盘、听筒。其余辅助设备常用如Leap Motion、Kinect等。
更多的额外设备意识着更高的使用成本，在本案例中使用的到的动作输入信息：
用户当前方向，由VRControls.js与webvr-polyfill.js实现完成；
用户视角焦点，完成按钮点击、攻击等动作，通过跟随相机的物体检测碰撞来完成。

3.2.3、分屏
龙之谷手游WebVR技术分享

如上图所示，为让用户更具沉侵感，通常会根据用户瞳距将屏幕分割成具有一定视差的两部分，勿需担心，这部分工作由VREffect.js来完成。

3.3、工作原理
上节中提到了webvr相关组件，本来我们可以简单利用它提供的接口就可以完成，但肯定还是有同学会好奇，它的工作原理是怎样的呢。
龙之谷手游WebVR技术分享

这得从Mozilla与Google 2016年初联手推出的WebVR API提案开始，WebVR Specification，该提案给VR硬件定义了专门定制的接口，让开发者能够构建出沉浸感强，舒适度高的VR体验。但由于该标准还处于草案阶段，所以我们开发需要WebVR Polyfill，这个组件不需要特定浏览器，就可以使用WebVR API中的接口。
所以我们只需要在项目中，引入webvr-polyfill.js及VRControls、VREffect两个类，并调用即可。

vrEffect = new THREE.VREffect(renderer);

vrControls = new THREE.VRControls(camera);

webvr-polyfill基于普通浏览器实现了WebVR API 1.0功能；
VRControls更新摄像头信息，让用户以第一人称置于场景中；
VREffect负责分屏。

四、技术难点

4.1、程序与用户共同控制摄像头
当程序在自动移动镜头的过程中，允许用户四处观察，这时候需要一个辅助容器共同控制镜头旋转与移动。

// 添加摄像机

camera = new THREE.PerspectiveCamera(60, size.w / size.h, 1, 10000);

camera.position.set(0, 0, 0);

camera.lookAt(new THREE.Vector3(0,0,0));

// 辅助镜头移动

dolly  = dolly = new THREE.Group();

dolly.position.set(10, 40, 40);

dolly.rotation.y = Math.PI/10;

dolly.add(camera);

scene.add(dolly);

4.2、多重蒙板贴图
龙之谷手游WebVR技术分享

如上图所示，该地形由三种贴图通过蒙板共同合成，这时候我们需要使用自定义Shader来实现，由rbg三个通道控制显示。
核心代码（片元着色器）：

fragmentShader: [

	'uniform sampler2D texture1;',

	'uniform sampler2D texture2;',

	'uniform sampler2D texture3;',

	'uniform sampler2D mask;',

	'void main() {',

		'vec4 colorTexture1 = texture2D(texture1, vUv* 40.0);',

		'vec4 colorTexture2 = texture2D(texture2, vUv* 60.0);',

		'vec4 colorTexture3 = texture2D(texture3, vUv* 20.0);',

		'vec4 colorMask = texture2D(mask, vUv);',

		'vec3  outgoingLight = vec3( colorTexture1.rgb*colorMask.r + colorTexture2.rgb *colorMask.g + colorTexture3.rgb *colorMask.b ) * 0.6;',

		'gl_FragColor =  vec4(outgoingLight, 1.0);',

	'}'

].join("\n")

完整代码（添加three.js灯光，雾化）：

// 合成材质

var map1 = texLoader.load('cross-domain/skins/foor_stone02.png' );

var map2 = texLoader.load('cross-domain/skins/green_wet09.png');

var map3 = texLoader.load('cross-domain/skins/stone_dry02.png');

// 自定义复合蒙板shader

THREE.FogShader = {

	uniforms: lib.extend( [

		THREE.UniformsLib[ "fog" ],

		THREE.UniformsLib[ "lights" ],

		THREE.UniformsLib[ "shadowmap" ],

		{

			'texture1': { type: "t", value: map1},

			'texture2': { type: "t", value: map2},

			'texture3': { type: "t", value: map3},

			'mask': { type: "t", value: texLoader.load('cross-domain/skins/mask.png')}

		}

	] ),

	vertexShader: [

		"varying vec2 vUv;",

		"varying vec3 vNormal;",

		"varying vec3 vViewPosition;",

		THREE.ShaderChunk[ "skinning_pars_vertex" ],

		THREE.ShaderChunk[ "shadowmap_pars_vertex" ],

		THREE.ShaderChunk[ "logdepthbuf_pars_vertex" ],

		"void main() {",

			THREE.ShaderChunk[ "skinbase_vertex" ],

			THREE.ShaderChunk[ "skinnormal_vertex" ],

			"vec4 mvPosition = modelViewMatrix * vec4( position, 1.0 );",

			"vUv = uv;",

			"vNormal = normalize( normalMatrix * normal );",

			"vViewPosition = -mvPosition.xyz;",

			"gl_Position = projectionMatrix * modelViewMatrix * vec4( position, 1.0 );",

			THREE.ShaderChunk[ "logdepthbuf_vertex" ],

		"}"

	].join('\n'),

	fragmentShader: [

		'uniform sampler2D texture1;',

		'uniform sampler2D texture2;',

		'uniform sampler2D texture3;',

		'uniform sampler2D mask;',

		'varying vec2 vUv;',

		'varying vec3 vNormal;',

		'varying vec3 vViewPosition;',

		// "vec3 outgoingLight = vec3( 0.0 );",

		THREE.ShaderChunk[ "common" ],

		THREE.ShaderChunk[ "shadowmap_pars_fragment" ],

		THREE.ShaderChunk[ "fog_pars_fragment" ],

		THREE.ShaderChunk[ "logdepthbuf_pars_fragment" ],

		'void main() {',

			THREE.ShaderChunk[ "logdepthbuf_fragment" ],

			THREE.ShaderChunk[ "alphatest_fragment" ],

			'vec4 colorTexture1 = texture2D(texture1, vUv* 40.0);',

			'vec4 colorTexture2 = texture2D(texture2, vUv* 60.0);',

			'vec4 colorTexture3 = texture2D(texture3, vUv* 20.0);',

			'vec4 colorMask = texture2D(mask, vUv);',

			'vec3 normal = normalize( vNormal );',

			'vec3 lightDir = normalize( vViewPosition );',

			'float dotProduct = max( dot( normal, lightDir ), 0.0 ) + 0.2;',

			'vec3  outgoingLight = vec3( colorTexture1.rgb*colorMask.r + colorTexture2.rgb *colorMask.g + colorTexture3.rgb *colorMask.b ) * 0.6;',

			THREE.ShaderChunk[ "shadowmap_fragment" ],

			THREE.ShaderChunk[ "linear_to_gamma_fragment" ],

			THREE.ShaderChunk[ "fog_fragment" ],

			// 'gl_FragColor = vec4( colorTexture1.rgb*colorMask.r + colorTexture2.rgb *colorMask.g + colorTexture3.rgb *colorMask.b, 1.0 )  + vec4(outgoingLight, 1.0);',

			// 'gl_FragColor = outgoingLight;',

			'gl_FragColor =  vec4(outgoingLight, 1.0);',

		'}'

	].join("\n")

};

THREE.FogShader.uniforms.texture1.value.wrapS = THREE.FogShader.uniforms.texture1.value.wrapT = THREE.RepeatWrapping;

THREE.FogShader.uniforms.texture2.value.wrapS = THREE.FogShader.uniforms.texture2.value.wrapT = THREE.RepeatWrapping;

THREE.FogShader.uniforms.texture3.value.wrapS = THREE.FogShader.uniforms.texture3.value.wrapT = THREE.RepeatWrapping;

var material = new THREE.ShaderMaterial({

	uniforms        : THREE.FogShader.uniforms,

	vertexShader    : THREE.FogShader.vertexShader,

	fragmentShader  : THREE.FogShader.fragmentShader,

	fog: true

});

3、 镜头移动（依赖Tween类）
功能函数：

cameraTracker: function(paths){

	var tweens = [];

	for(var i = 0; i < paths.length; i++) {

		(function(i){

			var tween = new TWEEN.Tween({pos: 0}).to({pos: 1}, paths[i].duration || 5000);

			tween.easing(paths[i].easing || TWEEN.Easing.Linear.None);

			tween.onStart(function(){

				var oriPos =  dolly.position;

				var oriRotation = dolly.rotation;

				this.oriPos = {x: oriPos.x, y: oriPos.y, z: oriPos.z};

				this.oriRotation = {x: oriRotation.x, y: oriRotation.y, z: oriRotation.z};

			});

			tween.onUpdate(paths[i].onupdate || function(){

				if(paths[i].pos) {

				  	dolly.position.x = this.oriPos.x + this.pos * (paths[i].pos.x -  this.oriPos.x);

				  	dolly.position.y = this.oriPos.y + this.pos * (paths[i].pos.y -  this.oriPos.y);

				  	dolly.position.z = this.oriPos.z + this.pos * (paths[i].pos.z -  this.oriPos.z);

				}

				if(paths[i].rotation) {

				  	dolly.rotation.x = this.oriRotation.x + this.pos * (paths[i].rotation.x -  this.oriRotation.x);

				  	dolly.rotation.y = this.oriRotation.y + this.pos * (paths[i].rotation.y -  this.oriRotation.y);

				  	dolly.rotation.z = this.oriRotation.z + this.pos * (paths[i].rotation.z -  this.oriRotation.z);

				}

			});

			tween.onComplete(function(){

				paths[i].fn && paths[i].fn();

				var fn = tweens.shift();

				fn && fn.start();

			});

			tweens.push(tween);

		})(i);

	}

	tweens.shift().start();

}

调用：

lib.cameraTracker([

	{'pos': { x: -45,y: 5, z: -38},'rotation': {x: 0, y: -1.8, z: 0},  'easing': TWEEN.Easing.Cubic.Out,'duration':4000}

]);

4、自适应长度文字提示
根据文字长度生成canvas作为贴图到Sprite对象。

hint = function(text, type, posY, fadeTime){

	var chinense = text.replace(/[u4E00-u9FA5]/g, '');

	var dbc = chinense.length;

	var sbc = text.length - dbc;

	var length = dbc * 2 + sbc;

	var fontsize = 40;

	var textWidth = fontsize* length / 2;

	posY = posY || 0.3;

	type = type || 1;

	fadeTime = fadeTime === window.undefined ? 500 : fadeTime;

	if(text == 'sucess' || text == 'fail') {

		text = ' ';

	}

	var canvas = document.createElement("canvas");

	var width = 1024, height = 512;

	canvas.width = width;

	canvas.height = height;

	var context = canvas.getContext('2d');

	var imageObj = document.querySelector('#img-hint-' + type);

	context.drawImage(imageObj, width/2 - imageObj.width/2, height/2 - imageObj.height/2);

	context.font = 'Bold '+ fontsize +'px simhei';

	context.fillStyle = "rgba(255,255,255,1)";

	context.fillText(text, width/2-textWidth/2, height/2+15);			

	var texture = new THREE.Texture(canvas);

	texture.needsUpdate = true;

	var mesh;

	var material = new THREE.SpriteMaterial({

		map: texture,

		transparent: true,

		opacity: 0

	});

	mesh = new THREE.Sprite(material);

	mesh.scale.set(width/400, height/400, 1);

	mesh.position.set(0, posY, -3);

	camera.add(mesh);	

	var tweenIn = new TWEEN.Tween({pos: 0}).to({pos: 1}, fadeTime);

	tweenIn.onUpdate(function(){

		material.opacity = this.pos;

	});

	if(fadeTime === 0) {

		material.opacity = 1;

	} else {

		tweenIn.start();

	}

	var tweenOut = new TWEEN.Tween({pos: 1}).to({pos: 0}, fadeTime);

	tweenOut.onUpdate(function(){

		material.opacity = this.pos;

	});

	tweenOut.onComplete(function(){

		camera.remove(mesh);

	});

	tweenOut.fadeOut = tweenOut.start;

	tweenOut.remove = function(){

		camera.remove(mesh);

	}

	return tweenOut;

};

5、unity地形导出
5.1、首先将unity地形导出为obj
龙之谷手游WebVR技术分享

5.2、然后导入3dmax，使用ThreeJSExporter.ms导出为js格式。

6、3dmax动画导出问题
6.1、动画导出错误
通常是对象为可编辑多边形，需要转换成网格对象。
龙之谷手游WebVR技术分享

操作步骤：
6.1.1、选择对象，右键转换为可编辑网络；
6.1.2、选择蒙皮修改器，重新蒙皮；
6.1.3、点击蒙皮修改器下的骨骼 > 添加，添加原有的骨骼。
6.2、动画导出错乱
很容易让人以为是权重出问题了，但就我自己多个项目动画导出的经验来看，大部分出现在骨骼添加上。在3dmax及unity中，不添加根节点往往不影响动画执行，但导出到three.js，需要添加根节点。如果问题还存在，则仔细观察是哪个骨骼引起的，多余骨骼或缺少骨骼都可能引起动画错乱。
龙之谷手游WebVR技术分享

五、完整的源代码及相应组件
点击下载
main.js - 完整的源代码
tween.min.js - 动画类
OrbitControls.js - 视图控制器，旋转、移动、缩放场景，方便调试
audio.min.js - motion音频组件，解决自动播放音频问题
其余vr相关组件上文已有介绍

相关文章