第3章
WebXR开发基础
3.1一行代码让网站支持3D和VR
本章为大家讲解Babylon.js的开发基础，让读者从头熟悉如何在Web页面中创建一个虚拟的三维世界。创建一个虚拟世界，需要一个场景(Scene)并在场景中添加模型(Model)，模型有可能是一个简单的立方体块，也可能是一个复杂的角色，无论是简单的模型还是复杂的模型，大都是由Mesh网格组成，如图3.1所示。
图3.1基于Mesh网格的三维模型
除此之外，还需一个相机(Camera)去观察虚拟世界，一个灯光(Light)去照亮场景，等等。拥有上述内容后，才能够在Web页面观察到一个虚拟的世界，接下来将逐步为大家描述如何实现上述内容。
基于Web的XR应用（例如3D、全景、AR、VR等，或上述四者互相结合的应用）都属于WebXR的范畴，相较于基于C/S架构的独立应用，WebXR应用有其不可替代的优势，也存在目前难以消除的缺陷。
WebXR最大的优势在于，无须额外下载独立应用，通过浏览器(或扫码或单击)即可进行体验，用完即走，不留痕迹。省去用户下载App的麻烦之后，对于开发者而言，将面临一个严峻的考验，那就是XR应用中有大量的3D资源，如何使之轻量化，减少用户等待加载的时间，给用户一个流畅的体验感受？面对这个问题，无论是程序开发者，还是内容生产者，无疑都要花费更多时间在资源和程序的优化上，不过资源的优化工作不在本节讨论范围内，因此不再赘述。
W3C标准化组织发布的WebXR Device API(网址请参考本书配套资源)目前可支持一些主流的XR设备，并已被集成至一些常见的JavaScript游戏引擎或3D图形框架中，例如AFrame、Three.js、Babylon.js等，开发者可以基于这些工具来实现自己的应用。不过目前并非所有的浏览器都已支持WebXR，浏览器兼容情况如图3.2所示，完全支持的浏览器备注了所需的最低版本。
图3.2主流浏览器对WebXR的兼容情况
可以使用上面提到的3D框架来实现部分我们想要的XR应用。今天给大家展示的是使用Babylon.js来实现网站中展示3D模型的案例，案例效果如图3.3所示。
图3.3一行代码让你的网站支持3D和VR
上述案例中的3D展示功能，其核心代码只有下面一行。
1.
其中，标签表示将Babylon.js中的Viewer组件嵌入到页面中，Viewer是Babylon.js内部封装的一个3D模型展示组件，model属性指向了一个.gltf格式(或.glb)的3D模型的URL，用户可以自定义，完整的页面代码如下所示。
1.
2.
3.
4.
5.3D Viewer Example
6.
7.
8.
9.
48.
49.
50.
53.
54.
55.
56.
57.青椒为植物界，双子叶植物纲，合瓣花亚纲，茄科。和红色辣椒统称为辣椒。果实为浆果。别名很多，大椒、灯笼椒、柿子椒都是它的名字，因能结甜味浆果，又叫甜椒、菜椒。一年生或多年生草本植物，特点是果实较大，辣味较淡甚至根本不辣，作蔬菜食用而不作为调味料。由于它翠绿鲜艳，新培育出来的品种还有红、黄、紫等多种颜色，因此不但能自成一菜，还被广泛用于配菜。青椒由原产中南美洲热带地区的辣椒在北美演化而来，长期栽培驯化和人工选择，使果实发生体积增大、果肉变厚、辣味消失等性状变化。中国于100多年前引入，现全国各地普遍栽培，青椒含有丰富的维生素C。
58.
59.
60.
61.
62.
63.
64.国内甜椒种子较多，表现突出的为进口品种荷椒13。在山西、山东、内蒙古、吉林、黑龙江等地均有大面积种植，是出口选型的优良品种。
65.该品种是国际甜椒种子中优秀品种， 一代杂交种，中早熟，大果形品种，果实方灯笼形。连续坐果率高，四心室率高。果实整齐度高，味甜，果肉厚0.8cm左右，果横径10～11cm、纵径12～13cm。果色较深绿，熟果转红色，果面光亮，单果重300～400g，最大可达600g。高产品种，抗各种病害，适应性强。在国内大部分地区都有种植。果形大，产量高。果形方正，是市场或加工的理想品种。
66.
67.
68.
69.
70.
71.
72.
73.
74.
75.
76.
77.
79.温度要求:适应温度范围为15～35℃ ，适宜的温度范围为25～28℃ ，发芽温度为28～30℃。
80.水分条件:喜湿润，怕旱涝，要求土壤湿润而不积水。
81.光照条件:对光照要求不严，光照强度要求中等，每天光照10～12h，有利于开花结果。青椒的生长发育需要充足的营养条件，每生产1000kg青椒，需氮2kg、磷1kg、钾1. 45kg，同时还需要适量的钙肥。对土壤的要求，以潮湿易渗水的沙壤土为好，土壤的酸碱度以中性为宜，微酸性也可。
82.
83.
84.
3.2场景创建
场景(Scene)表示一个虚拟的场地，一般由环境、房间、道具、角色等共同组成一个虚拟的场景，在有些游戏引擎或3D框架中也叫作舞台(Stage)。总之，从3D的角度来说，场景就是将一些网格(Mesh)放在一起供用户观看，并且会在其中加入相机(Camera)和灯光(Light)让用户能够看到。当然，除了上述提到的之外，场景可能还会包含一些别的元素，例如GUI用户界面，让用户能够与场景产生交互，下面正式开始场景的学习。
3.2.1快速创建场景
首先，需要打开Babylon.js在线开发工具Playground。可以进入Babylon.js官方网站，在首页菜单选项卡中选择TOOLS→PLAYGROUND即可进入Playground，如图3.4所示。
图3.4进入Babylon.js的在线开发工具Playground
Playground是Babylon.js提供的在线编码工具，使得开发者可以直接在网页上实现代码的编写、调试、下载等功能，如图3.5所示。
图3.5使用在线开发工具编辑代码
Playground的开发界面分为顶部、左半部分和右半部分，顶部的主要的功能如下。
1. 语言切换
Babylon.js支持TypeScript(简称TS)和JavaScript(简称JS)两种语言开发模式的切换，默认情况下选择的是JavaScript。如果大家喜欢采用TS开发，则可以切换至TS选项下进行代码的编写工作。如无特殊说明，本书所有的案例代码实现都是采用JS编写。如果要进行编程语言的切换，只需要单击TS按钮即可，如图3.6所示。
图3.6编程语言切换
2. 运行
单击运行按钮，则开始执行当前场景中的脚本，并在画面右半部分显示运行结果，如图3.7所示。
图3.7运行按钮
3. 保存
由于Playground是基于Web的，因此单击保存按钮并不会将当前的工程保存至本地，而是会保存至官方服务器，如图3.8所示。
图3.8保存按钮
开发者单击保存按钮后，会弹出对话框提示用户输入一些与项目相关的信息，如图3.9所示。
图3.9输入项目工程信息
输入完成后单击OK按钮，则会在服务器端生成一个代表当前工程的唯一ID，用户只需要记录页面的ID即可随时进入工程继续编写，如图3.10所示。
图3.10基于用户ID的项目工程识别机制
图3.10中的#R48MTP#3代表当前工程的ID，第一个#后面为项目ID，第二个#后面为版本号，也就是说，用户对网页进行修改之后，再次单击保存按钮或按下Ctrl+S快捷键，则会保存一个新的版本。
4. Inspector（信息监视）面板
如图3.11所示，单击最上方工具栏中的Inspector按钮，可以打开Inspector面板。
图3.11工具栏中的Inspector按钮
打开该面板后，首先可以看出主窗体分为了3部分： 最左侧是代码区，中间是场景区，最右侧才是打开的Inspector面板区。在Inspector面板区域中可以看到场景的节点信息、材质信息、动画信息等，这些信息有助于开发者进行调试。该功能在场景中有较多元素时比较有用。在图3.12中可以看到屏幕右侧的INSPECTOR面板中列出了Nodes（节点）列表、Materials（材质）列表、Textures（纹理）列表等。
图3.12Inspector组件面板
例如，单击Scene下的Nodes节点前面的“+”进行节点的展开，可以看到当前场景中的所有物体对象，可以看到，在默认情况下，场景中存在一个相机camera1、一个平面ground、一个灯光light和一个球体sphere，如图3.13所示。
图3.13在Inspector面板中查看详细的物体对象
5. 下载
单击下载按钮，如图3.14所示，可以将当前的代码打包下载至本地，因为开发的Web应用在大部分情况下都需要进行独立的部署或交付，因此需要将页面下载至本地，Babylon会将整个HTML页面进行下载。
图3.14项目下载按钮
6. 新建
单击新建按钮即可新建一个项目，如图3.15所示。
图3.15新建按钮
7. 清除
单击清除代码按钮，如图3.16所示，即可清除当前页面上的代码。
图3.16清除代码按钮
8. 设置
单击设置按钮，如图3.17所示，即可对项目进行设置，包括页面的主题、字体大小、全屏设置等。
图3.17设置按钮
熟悉了Playground开发环境后，接下来开始编写代码来快速创建场景，在场景中添加一个Box立方体。
1.var createScene = function() {
2.var scene = new BABYLON.Scene(engine);
3.var box = BABYLON.MeshBuilder.CreateBox("box", {});
4.scene.createDefaultCameraOrLight(true, true, true);
5.scene.createDefaultEnvironment();
6.return scene;
7.};
上述代码的执行结果如图3.18所示。
图3.18案例执行效果
3.2.2场景创建API说明
通过上述操作，我们发现右侧Scene场景创建了一个立方体，同时用户可以使用鼠标拖动让立方体进行旋转，按住鼠标右键可以移动立方体。下面介绍通过上述代码创建一个基础场景的步骤。
1. 创建场景
在HTML中调用createScene()函数，并对场景进行渲染。该函数是Playground预留的需要开发者自己进行实现的一个函数。开发者不需要对函数的名字、返回值等进行修改，只需要在函数体中添加对应的代码即可。
2. 初始化空场景
使用下述代码初始化一个空场景：
var scene = new BABYLON.Scene(engine);
3. 创建默认的摄像头和灯光
使用函数createDefaultCameraOrLight()创建默认的摄像头和灯光。当创建了scene对象后，就可以调用scene中的接口函数对场景进行一系列的操作。对于函数createDefaultCameraOrLight()来说，从函数的名称可知这个函数完成了两件事情，即创建相机和创建灯光，说明该函数并不是一个功能单一的函数，而是一个合并后为了用户方便使用的一个复合函数，可以通过其API文档来查看该函数都有哪些参数，这些参数的作用是什么，如图3.19所示。
图3.19查看函数的API文档
由图3.19可以看到该函数包含3个参数，均为boolean类型，依次为：
（1） 是否创建ArcRotateCamera(该相机会在后面专门介绍)；
（2） 是否替换当前场景中的camera或light；
（3） 是否允许控制相机。
从上述代码中可以看到本次传递的参数都是true。
4. 创建物体对象
通过MeshBuilder.createBox()方法创建一个立方体，并添加至场景中。
5. 创建默认环境
createDefaultEnvironment()函数用来创建默认环境，Babylon.js默认的环境包含了一个圆形的地面，用户对于环境的设置可以通过传入配置参数来实现。后续章节将进一步讲解环境的设置。
要查看函数的API文档，可以在Babylon.js官网首页选择TOOLS→DOCUMENTATION，然后选择左侧的API选项，在右侧的窗口中就可以看到要查询的命名空间、类、变量、接口、函数等，也可以在左侧单击Search选项进行指定的搜索，如图3.20所示。
图3.20访问API文档
3.3场景灯光
图3.21场景灯光照射效果
3.2节介绍了场景的快速创建方法，其中调用了场景中提供的一个接口来创建相机和灯光，实际上可以由开发者自己来控制创建灯光的数量，以及创建何种灯光。灯光在场景中非常重要，会直接影响到场景中创建的Mesh的显示效果，包括照明和颜色等。在Babylon.js中，场景默认允许创建的灯光数量为4个，但是也可以根据开发者的需求增加。图3.21展示了一个球体在受到多个灯光照射后的显示效果。
3.3.1灯光的类型
在Babylon.js中提供了4种类型的灯光，每种灯光都有自己的特点和适用的场景，接下来逐一进行介绍。
1. 点光源(Point Light)
点光源是能够模拟在三维空间中由一个点向四周散射的一种光源，类似于生活中的电灯泡，光会从各个方向进行传播。创建点光源的示例代码如下：
1.var light = new BABYLON.PointLight("pointLight", new BABYLON.Vector3(1, 10, 1), scene);
2. 方向光(Directional Light)
方向光是指光从指定的一个方向发射而来，并且具有无限的范围，也就是说，方向光会沿着某个方向照亮场景中的所有区域，可以想象方向光类似于太阳光，但是太阳光是有固定方向的，比如地球上的太阳光，自然是从太阳发射出来的那个方向的光。方向光的创建方式如下：
1. var light = new BABYLON.DirectionalLight("DirectionalLight", new BABYLON.Vector3(0, -1, 0), scene);
3. 聚光灯(Spot Light)
聚光灯是由位置、方向、角度和指数定义的光源类型，表示一个从某位置朝着某方向发射的一束光锥，类似于生活中使用的手电筒，其中有两个参数值得特别说明： 一个是角度，聚光灯的角度表示光锥的大小，其单位是以弧度表示；另一个是指数，指数定义了光随着距离传播时衰减的速度。这里与方向光不同，方向光并不会随着距离衰减，而聚光灯可以定义衰减的指数。聚光灯的创建方式如下：
1. var light = new BABYLON.SpotLight("spotLight", new BABYLON.Vector3(0, 30, -10), new BABYLON.Vector3(0, -1, 0), Math.PI / 3, 2, scene);
4. 半球光(Hemispheric Light)
半球光是一个模拟环境灯光的简单方法，半球光定义一个方向，通常向上朝向天空，通过设置颜色等属性才能实现完整的效果。
1.var light = new BABYLON.HemisphericLight("HemiLight", new BABYLON.Vector3(0, 1, 0), scene);
上述介绍的4种类型的灯光，其颜色属性都包括自发光、漫反射和镜面反射。重叠的灯光会与我们期望的那样相互作用，例如，红、绿、蓝3种颜色的光重叠会产生白光，每一盏灯都可以打开、关闭，每个灯光的强度也可以设置为0～1的值。
3.3.2灯光颜色的设置
灯光的3个属性会影响颜色，首先是ground color(地面颜色)，仅适用于半球光； 另外两种颜色的属性分别为：
（1） diffuse color——漫反射颜色，漫反射为对象提供基本的颜色；
图3.22添加多种灯光后的球体
（2） specular color——高光，高光使对象上产生高光斑点或亮斑。
上述两种颜色属性运用于所有4种类型的灯光。
如图3.22展示了一个方向光照亮一个球体，方向光的漫反射颜色为红色，高光颜色为绿色，最终可以看到在右侧三维场景中一个红色的球体，以及绿色的亮斑。
实现该效果的相关代码如下：
1.var createScene = function () {
2.var scene = new BABYLON.Scene(engine);
3.var camera = new BABYLON.ArcRotateCamera("Camera", -Math.PI / 2,Math.PI / 2, 5, BABYLON.Vector3.Zero(), scene);
4.camera.attachControl(canvas, true);
5.var light = new BABYLON.DirectionalLight("DirectionLight",new BABYLON.Vector3(0,-1,0),scene);
6.light.diffuse = new BABYLON.Color3(1,0,0);
7.light.specular=new BABYLON.Color3(0,1,0);
8.var sphere = BABYLON.MeshBuilder.CreateSphere("sphere",{},scene);
9.return scene;
10.};
图3.23两个聚光灯的照射效果
如图3.23所示，展示两个聚光灯的照射效果，其中一个聚光灯的漫反射颜色和高光颜色均为绿色，因此无法明显地看到其亮斑在什么位置； 另一个聚光灯打出的漫反射颜色为红色，高光颜色为绿色，可以看到左下角明显的亮斑，而且亮斑的颜色为红色与绿色经过叠加之后的颜色，即黄色，这也验证了前面提到的多个颜色混合的效果。
下面通过另一段代码展示光的颜色之间的混合以及混合的结果。
1.var createScene = function () {
2.var scene = new BABYLON.Scene(engine);
3.var camera = new BABYLON.ArcRotateCamera("Camera", -Math.PI / 2,Math.PI / 4, 5, BABYLON.Vector3.Zero(), scene);
4.camera.attachControl(canvas, true);
5.
6.//红色光
7.var light = new BABYLON.SpotLight("spotLight", new BABYLON.Vector3(-Math.cos(Math.PI/6), 1 , -Math.sin(Math.PI/6)), new BABYLON.Vector3(0, -1, 0), Math.PI / 2, 1.5, scene);
8.light.diffuse = new BABYLON.Color3(1, 0, 0);
9.
10.//绿色光
11.var light1 = new BABYLON.SpotLight("spotLight1", new BABYLON.Vector3(0, 1, 1 - Math.sin(Math.PI / 6)), new BABYLON.Vector3(0, -1, 0), Math.PI / 2, 1.5, scene);
12.light1.diffuse = new BABYLON.Color3(0, 1, 0);
13.
14.//蓝色光
15.var light2 = new BABYLON.SpotLight("spotLight2", newBABYLON.Vector3(Math.cos(Math.PI/6), 1, -Math.sin(Math.PI/6)), new BABYLON.Vector3(0, -1, 0), Math.PI / 2, 1.5, scene);
16.light2.diffuse = new BABYLON.Color3(0, 0, 1);
17.
18.var ground = BABYLON.MeshBuilder.CreateGround("ground", {width: 4, height: 4}, scene);
19.
20.return scene;
21.
22.};
图3.243束光两两相交的效果
上述代码创建了一个地面的Mesh，同时创建了3个聚光灯来照射地面，这3个聚光灯的漫反射颜色分别为红、绿、蓝(对光学有基本认识的读者一定知道这3个颜色代表什么)，这3束光通过位置的设置而两两相交，最终得到如图3.24所示的效果。
3.3.3灯光开关和调光器
1. 灯光的开关
每一种灯光都可以通过代码打开或者关闭，具体打开或者关闭的实现方式如下：
1.light.setEnabled(false);
给上述代码传入true表示打开灯光，传入false表示关闭灯光。
2. 灯光的强度
当想要调亮或者调暗灯光的时候，可以设置灯光的indensity属性，赋值越大，灯光越强； 反之亦然。默认情况下，该属性的取值为1。
1.light0.intensity = 0.5;
2.light1.intensity = 2.4;
3. 灯光的范围
对于点光源和聚光灯，可以设置range属性来限制灯光能够到达的距离。
3.4场景阴影
在开始介绍本节具体内容之前，先看一下图3.25。图3.25中的场景包含一个类似于丘陵的地面地形、一个运动的圆环和地形上方的两盏灯。最后圆环在运动的过程中，会实时、动态地在地面上投射出阴影效果。
图3.25场景阴影效果
图3.25中的阴影效果如何实现，就是本节要介绍的内容。
3.4.1阴影生成
在Babylon.js中使用阴影生成器(Shadow Generator)很容易生成阴影。 阴影生成器是一个能够从灯光的角度来生成阴影纹理的工具。阴影生成器有两个参数，分别为阴影纹理的大小以及用于阴影纹理计算的光源。下面给出创建阴影的示例代码。
1.var shadowGenerator = new BABYLON.ShadowGenerator(1024, light);
然后必须要定义渲染的阴影，比如想要渲染圆环的阴影，那就可以向阴影纹理的渲染列表中添加圆环，代码如下：
1.shadowGenerator.getShadowMap().renderList.push(torus);
最后，必须要定义阴影显示的位置，将其接收阴影的属性设置为true。
1.ground.receiveShadows = true;
满足上述3个条件后，就可以在场景中看到阴影了。要想让阴影看起来效果更好，可以激活阴影过滤功能，通过去除阴影的硬边来获得一个更好看的阴影。
Babylon.js提供了3种过滤器，可以选择任何一种进行尝试。
1. 泊松采样过滤
1.shadowGenerator.usePoissonSampling = true;
2. 指数阴影纹理
1.shadowGenerator.useExponentialShadowMap = true;
3. 模糊指数阴影纹理
1.shadowGenerator.useBlurExponentialShadowMap = true;
通过上述方式能够实现软阴影的效果，当然这种阴影的效果会更加消耗渲染资源，软阴影的效果如图3.26所示。
3.4.2透明物体和阴影
要让透明的物体投射阴影，必须在阴影生成器上打开transparentShadow属性，如图3.27所示为透明物体投射阴影的效果。
图3.26软阴影效果
图3.27透明物体投射阴影效果
3.4.3灯光与阴影的关系
灯光与阴影可以说是既互相独立又紧密联系的，没有灯光就无法生成阴影，但是在生成阴影的过程中，有一些规则和需要特别注意的地方。
（1） 只有点光源（Point Light）、方向光（Directional Light）、聚光灯（Spot Light）可以投射阴影，其他的光源是无法投射阴影的。
（2） 一个阴影生成器只能供一个灯光使用，如果多个灯光都会投射阴影，则需要分别为每个灯光创建一个阴影生成器。
（3） 点光源使用立方体纹理Cubemaps来渲染，因此在使用点光源的时候需要注意性能问题。
（4） 聚光灯使用透视投影来计算阴影纹理。
（5） 定向灯使用正交投影。自动评估灯光的位置，以获得最佳的阴影纹理，可以通过关闭light.autoUpdateExtends来控制此行为。
3.4.4体积光散射后处理
BABYLON.VolumetricLightScatteringPostProcess是一个后处理功能，它将根据光源网格计算光散射，具体的使用方法如下：
1.var vls = new BABYLON.VolumetricLightScatteringPostProcess('vls', 1.0, camera, lightSourceMesh, samplesNum, BABYLON.Texture.BILINEAR_SAMPLINGMODE, engine, false);
上述接口中每一个参数的含义如下：
(1) name {string}——后处理名称。
(2) ratio {any}——后处理和/或内部通道的大小(0.5意味着后处理将具有宽度=canvas.width×0.5和高度=canvas.height×0.5)。
(3) camera {BABYLON.Camera}——后处理将附加到的相机。
(4) lightSourceMesh{BABYLON.Mesh}——用作光源的网格，以创建光散射效果(例如，具有模拟太阳纹理的广告牌)。
(5) samplesNum{number}——后处理质量，默认值为100。
(6) samplingMode{number}——后处理过滤模式。
(7) engine{BABYLON.Engine}——巴比伦引擎。
(8) reusable{boolean}——如果在后处理中需要重用，那么就将其值设置为true。
(9) 场景{BABYLON.Scene}——如果相机参数为空(在渲染管道中添加后处理)，则需要场景来配置内部通道。
通过体积光散射后处理，可以实现如图3.28所示的光照效果。
图3.28体积光散射后处理效果
3.5场景交互
3.5.1如何在场景中进行交互
交互在软件中必不可少，尤其在三维场景中的交互则显得更加重要。目前，在很多XR设备中出现了新型的、更加自然化的交互，例如手柄的交互、触摸、眼球跟踪、收拾识别、动作识别等，交互的类型多样，交互的方式也发生了翻天覆地的变化。本节还是围绕三维场景中主要的两种交互——键盘和鼠标的交互来展开。当然，场景交互还支持GUI、游戏手柄、触摸屏等其他形式。
3.5.2键盘的交互
下面的代码展示了在场景中如何监听键盘输入的事件。
1.scene.onKeyboardObservable.add((kbInfo) => {
2.switch (kbInfo.type) {
3.case BABYLON.KeyboardEventTypes.KEYDOWN:
4.console.log("KEY DOWN: ", kbInfo.event.key);
5.break;
6.case BABYLON.KeyboardEventTypes.KEYUP:
7.console.log("KEY UP: ", kbInfo.event.code);
8.break;
9.}
10.});
键盘输入的枚举类型包含KEYDOWN和KEYUP两种事件，用于监听按键按下和按键抬起，实际上在很多引擎中还会额外提供控制按键按住时间的属性，当然在这里可以自己实现按住事件的逻辑。
3.5.3鼠标的交互
下面的代码展示了如何在场景中监听鼠标事件。
1.scene.onPointerObservable.add((pointerInfo) => {
2.switch (pointerInfo.type) {
3.case BABYLON.PointerEventTypes.POINTERDOWN:
4.console.log("POINTER DOWN");
5.break;
6.case BABYLON.PointerEventTypes.POINTERUP:
7.console.log("POINTER UP");
8.break;
9.case BABYLON.PointerEventTypes.POINTERMOVE:
10.console.log("POINTER MOVE");
11.break;
12.case BABYLON.PointerEventTypes.POINTERWHEEL:
13.console.log("POINTER WHEEL");
14.break;
15.case BABYLON.PointerEventTypes.POINTERPICK:
16.console.log("POINTER PICK");
17.break;
18.case BABYLON.PointerEventTypes.POINTERTAP:
19.console.log("POINTER TAP");
20.break;
21.case BABYLON.PointerEventTypes.POINTERDOUBLETAP:
22.console.log("POINTER DOUBLE-TAP");
23.break;
24.}
25.});
上述鼠标事件包含鼠标按下、鼠标抬起、鼠标移动、鼠标滚轮、鼠标选取、鼠标单击以及鼠标双击事件，鼠标事件与键盘事件有所不同，因为键盘没有位置信息，每个键盘包含了一个键盘码，而鼠标还包含位置信息。因此，在监听给定事件的时候，还可以得到pointerInfo这样一个数据结构，然后在这个数据结构中获取想要的事件信息。
3.6相机
在Babylon.js的众多相机中，最为常用的应该是用于第一人称运动的通用相机UniversalCamera和轨道相机ArcRotateCamera，以及用于虚拟现实体验的WebXRCamera。
3.6.1通用相机
通用相机是在Babylon.js 2.3引入的，用于由键盘、鼠标、触摸屏、游戏控制器等进行控制，具体取决于用户到底在使用哪种输入设备。通用相机的支持将会取代FreeCamera、TouchCamera以及GamepadCamera，因为通用相机对这几类相机进行了集成，但上述几种相机依然是可以使用的。
目前通用相机是Babylon.js的默认相机，如果要在场景中使用类似于FPS的控制功能，则可以使用该相机，Babylon.js官网演示的案例大多使用该相机。如果将XBox控制器插入PC，则可以使用大部分该相机的演示功能。
通用相机的默认操作是：
(1) 键盘——通过左右方向键进行左右移动相机，通过上下方向键前后移动相机。
(2) 鼠标——以相机为原点围绕轴旋转相机。
(3) 触摸——左右滑动可左右移动相机，上下滑动可前后移动相机。
(4) 鼠标滚轮——鼠标上的滚轮或触摸板上的滚动动作。
那么如何去构建一个通用相机呢？下面就是一个创建和使用通用相机的例子，请读者自行执行并观察效果。
1.var createScene = function () {
2.//创建基本的Babylon场景对象
3.var scene = new BABYLON.Scene(engine);
4.
5.//创建并定位一个通用相机
6.var camera = new BABYLON.UniversalCamera("UniversalCamera", new BABYLON.Vector3(0, 5, -10), scene);
7.
8.//启用鼠标滚轮的输入
9.camera.inputs.addMouseWheel();
10.
11.//通过鼠标滚轮Y轴的输入来控制相机在场景中的高度(根据实际情况启用或者禁用)
12.//camera.inputs.attached［"mousewheel"］.wheelYMoveRelative = BABYLON.Coordinate.Y;
13.
14.//反转鼠标Y轴的朝向
15.// camera.inputs.attached［"mousewheel"］.wheelPrecisionY = -1;
16.
17.//定位相机在场景中的初始位置(坐标原点)
18.camera.setTarget(BABYLON.Vector3.Zero());
19.
20.//将相机附加到画布
21.camera.attachControl(true);
22.
23.//创建一个半球光，坐标为(0,1,0)，添加至场景中
24.var light = new BABYLON.HemisphericLight("light", new BABYLON.Vector3(0, 1, 0), scene);
25.
26.//默认灯光强度为1，让我们把灯光调暗一点
27.light.intensity = 0.7;
28.
29.//创建一个球体
30.var sphere = BABYLON.MeshBuilder.CreateSphere("sphere",{diameter: 2, segments: 32}, scene);
31.
32.//将球体向上移动其高度的1/2
33.sphere.position.y = 1;
34.
35.//场景中添加一个ground地面(宽度和高度均为6)
36.var ground = BABYLON.MeshBuilder.CreateGround("ground", {width: 6, height: 6}, scene);
37.
38.return scene;
39.
40.};
图3.29轨道相机工作原理
3.6.2轨道相机
轨道相机始终会朝着给定的目标位置运动，并且可以以目标为中心旋转。开发者可以使用光标和鼠标来控制相机，也可以使用触摸事件来控制。可以将这个相机想象成是一个围绕着地球运行的卫星(这是为何被叫作轨道相机的原因)，它相对于“地球”的位置可以通过3个参数来进行设置。
(1) alpha： 纵向旋转，以弧度为单位。
(2) beta： 维度旋转，以弧度为单位。
(3) radius： 半径，指相机到目标的距离。
图3.29展示了轨道相机的工作原理。
由于一些技术原因，将beta的值设置为0或PI可能会导致一些问题，因此在这种情况下，beta会偏移0.1弧度。其中beta的值为顺时针增加，而alpha的值为逆时针方向增加。
当然也可以通过向量Vector来设置相机的位置，该值会自动覆盖alpha、beta以及radius的值，这种方式比计算所需角度容易很多。在用户交互时，无论是使用键盘、鼠标还是滑动，左右方向的操作都会改变alpha的值，而上下方向的操作为改变beta的值。下面的例子具体展示了如何构造和使用一个轨道相机。
1.var createScene = function () {
2.
3.//创建一个基本的Babylon场景对象
4.var scene = new BABYLON.Scene(engine);
5.
6./**********轨道相机案例 **************************/
7.
8.//创建轨道相机添加至场景中
9.var camera = new BABYLON.ArcRotateCamera("Camera", 0, 0, 10, new BABYLON.Vector3(0, 0, 0), scene);
10.
11.//设置相机的位置
12.camera.setPosition(new BABYLON.Vector3(0, 0, -10));
13.
14.//将相机附加至画布中
15.camera.attachControl(canvas, true);
16.
17./**************************************************************/
18.
19.//创建一个半球光，坐标为(0,1,0)，添加至场景中
20.var light = new BABYLON.HemisphericLight("light", new BABYLON.Vector3(0, 1, 0), scene);
21.
22.//材质的设置
23.var redMat = new BABYLON.StandardMaterial("red", scene);
24.redMat.diffuseColor = new BABYLON.Color3(1, 0, 0);
25.redMat.emissiveColor = new BABYLON.Color3(1, 0, 0);
26.redMat.specularColor = new BABYLON.Color3(1, 0, 0);
27.
28.var greenMat = new BABYLON.StandardMaterial("green", scene);
29.greenMat.diffuseColor = new BABYLON.Color3(0, 1, 0);
30.greenMat.emissiveColor = new BABYLON.Color3(0, 1, 0);
31.greenMat.specularColor = new BABYLON.Color3(0, 1, 0);
32.
33.var blueMat = new BABYLON.StandardMaterial("blue", scene);
34.blueMat.diffuseColor = new BABYLON.Color3(0, 0, 1);
35.blueMat.emissiveColor = new BABYLON.Color3(0, 0, 1);
36.blueMat.specularColor = new BABYLON.Color3(0, 0, 1);
37.
38.//添加一个平面对象，并附加材质
39.var plane1 = BABYLON.MeshBuilder.CreatePlane("plane1", {size: 3, sideOrientation: BABYLON.Mesh.DOUBLESIDE}, scene);
40.plane1.position.x = -3;
41.plane1.position.z = 0;
42.plane1.material = redMat;
43.
44.var plane2 = BABYLON.MeshBuilder.CreatePlane("plane2", {size: 3, sideOrientation: BABYLON.Mesh.DOUBLESIDE});
45.plane2.position.x = 3;
46.plane2.position.z = -1.5;
47.plane2.material = greenMat;
48.
49.var plane3 = BABYLON.MeshBuilder.CreatePlane("plane3", {size: 3, sideOrientation: BABYLON.Mesh.DOUBLESIDE});
50.plane3.position.x = 3;
51.plane3.position.z = 1.5;
52.plane3.material = blueMat;
53.
54.var ground = BABYLON.MeshBuilder.CreateGround("ground1", {width: 10, height: 10, subdivisions: 2}, scene);
55.
56.return scene;
57.
58.};
上述案例的执行结果如图3.30所示。
图3.30案例实现效果
3.6.3跟随相机
顾名思义，跟随相机(Follow Camera)需要一个目标网格，相机的位置将会跟随网格的位置移动至目标的相对位置，当目标物体移动时，相机也会跟随移动。相机主要受以下3个参数的控制。
(1) radius： 半径，指相机与目标物体(模型)的距离。
(2) heightOffset： 相对于目标上方的高度。
(3) rotationOffset： 在XOY平面上，目标旋转的角度。
可通过设置加速度将相机移动到目标的速度设置为最大。下面的代码示例展示了如何使用跟随相机。
1.var createScene = function () {
2.
3.//创建一个基本的Babylon场景
4.var scene = new BABYLON.Scene(engine);
5.
6./********** 跟随相机举例 **************************/
7.
8.//创建一个跟随相机，并且定位初始位置
9.var camera = new BABYLON.FollowCamera("FollowCam", new BABYLON.Vector3(0, 10, -10), scene);
10.
11.//相机与目标模型的距离
12.camera.radius = 30;
13.
14.//相机高度与目标模型的高度差
15.camera.heightOffset = 10;
16.
17.//相机在xoy平面内围绕目标的局部原点旋转值
18.camera.rotationOffset = 0;
19.
20.//相机从当前位置移动到目标位置的加速度
21.camera.cameraAcceleration = 0.005
22.
23.//最大加速值
24.camera.maxCameraSpeed = 10
25.
26.//在此处设置相机的目标网格(启用或者禁用)
27.//camera.target = targetMesh;
28.//将相机附加到画布中
29.camera.attachControl(canvas, true);
30.
31./**************************************************************/
32.
33.//创建一个半球光，坐标为(0,1,0)，添加至场景中
34.var light = new BABYLON.HemisphericLight("light", new BABYLON.Vector3(0, 1, 0), scene);
35.
36.//材质(准备精灵图像所需的图片)
37.var mat = new BABYLON.StandardMaterial("mat1", scene);
38.mat.alpha = 1.0;
39.mat.diffuseColor = new BABYLON.Color3(0.5, 0.5, 1.0);
40.var texture = new BABYLON.Texture("https://i.imgur.com/vxH5bCg.jpg", scene);
41.mat.diffuseTexture = texture;
42.
43.//立方体的每一侧都有不同的面，以显示相机旋转
44.var hSpriteNb =3;// 精灵图像水平3列
45.var vSpriteNb =2;// 精灵图像垂直2行
46.
47.var faceUV = new Array(6);
48.
49.for (var i = 0; i < 6; i++) {
50.faceUV［i］ = new BABYLON.Vector4(i/hSpriteNb, 0, (i+1)/hSpriteNb, 1 / vSpriteNb);
51.}
52.
53.//通过上述的精灵图像创建立方体并赋予材质
54.var box = BABYLON.MeshBuilder.CreateBox("box", {size: 2, faceUV: faceUV }, scene);
55.box.position = new BABYLON.Vector3(20, 0, 10);
56.box.material = mat;
57.
58.//创建固体粒子系统，以显示立方体和相机的运动
59.var boxesSPS = new BABYLON.SolidParticleSystem("boxes", scene, {updatable: false});
60.
61.//设置立方体粒子位置函数
62.var set_boxes = function(particle, i, s) {
63.particle.position = new BABYLON.Vector3(-50 + Math.random()*100, -50 + Math.random()*100, -50 + Math.random()*100);
64.}
65.
66.//添加400个立方体
67.boxesSPS.addShape(box, 400, {positionFunction:set_boxes});
68.var boxes = boxesSPS.buildMesh(); // 立方体的mesh
69.
70./*****************为相机设置目标************************/
71.camera.lockedTarget = box;
72./**************************************************************/
73.
74.
75.//立方体移动变量
76.var alpha = 0;
77.var orbit_radius = 20
78.
79.
80.//移动立方体让相机跟随它
81.scene.registerBeforeRender(function () {
82. alpha +=0.01;
83. box.position.x = orbit_radius*Math.cos(alpha);
84. box.position.y = orbit_radius*Math.sin(alpha);
85. box.position.z = 10*Math.sin(2*alpha);
86.
87.//随着相机跟随立方体改变相机的视角
88. camera.rotationOffset = (18*alpha)%360;
89.});
90.
91.return scene;
92.
93.};
上述代码的执行结果如图3.31所示。相机将会跟随图中红色方框内的物体进行运动。
图3.31跟随相机实现效果
3.7动画
无论开发者制作的是一款游戏，还是一款AR/VR/MR的应用，动画都是举足轻重的部分。一个3D场景，因为有了动画，才会有栩栩如生的效果，从而更加吸引用户在场景中漫游或互动。本节将为大家讲解在Babylon.js中动画的使用。
如图3.32所示的序列图像很好地展示了一段动画的原理。顺序播放每一个单帧图像，就会在画面中产生马儿跑动的动画效果。每秒切换的图像越多，这段动画就会越流畅，随之而来的感觉就是我们觉得马儿跑得更快。
图3.32动画序列原理
3.7.1设计动画
假设想要实现一个box（一个立方体）在屏幕上左右移动，第一秒时box会从初始位置运动到屏幕右侧，第二秒会返回到屏幕左侧，如此循环往复就形成了一段动画。这里要提出一个概念，那就是AnimationClip(动画剪辑)。box往复运动一个循环的这段动画，叫作一个动画剪辑，也即一个AnimationClip，一个AnimationClip不断循环播放就能达到开发者的目的——并非需要10s的动画，就做一个10s的AnimationClip。在Babylon.js中，创建一个动画的示例代码如下：
1.const frameRate = 10;
2.const xSlide = new BABYLON.Animation("xSlide", "position.x", frameRate, BABYLON.Animation.ANIMATIONTYPE_FLOAT,BABYLON.Animation.ANIMATIONLOOPMODE_CYCLE);
在上述代码中，frameRate代表帧速率，帧速率即每秒画面刷新的次数，这里设置的值为10。接下来还需要设置3个关键帧，分别是起始点、box改变方向时的点和终点。确定了3个关键帧，然后让box沿着关键帧和帧速率做插值运算，就可以形成一段完整的动画。在Babylon.js中设置动画关键帧的代码如下：
1.const keyFrames = ［］;
2.
3.keyFrames.push({
4.frame: 0,
5.value: 2
6.});
7.
8.keyFrames.push({
9.frame: frameRate,
10.value: -2
11.});
12.
13.keyFrames.push({
14.frame: 2 * frameRate,
15.value: 2
16.});
17.
18.xSlide.setKeys(keyFrames);
最后将动画添加到box上，并且播放动画，就可以实现预想的效果。本案例完整的代码如下：
1.const createScene = () => {
2.const scene = new BABYLON.Scene(engine);
3.
4.const camera = new BABYLON.ArcRotateCamera("Camera", - Math.PI / 2, Math.PI / 4, 10, BABYLON.Vector3.Zero());
5.camera.attachControl(canvas, true);
6.
7.const light1 = new BABYLON.DirectionalLight("DirectionalLight", new BABYLON.Vector3(0, -1, 1));
8.const light2 = new BABYLON.HemisphericLight("HemiLight", new BABYLON.Vector3(0, 1, 0));
9.light1.intensity =0.75;
10.light2.intensity =0.5;
11.
12.const box = BABYLON.MeshBuilder.CreateBox("box", {});
13.box.position.x = 2;
14.
15.const frameRate = 10;
16.
17.const xSlide = new BABYLON.Animation("xSlide", "position.x", frameRate, BABYLON.Animation.ANIMATIONTYPE_FLOAT, BABYLON.Animation.ANIMATIONLOOPMODE_CYCLE);
18.
19.const keyFrames = ［］;
20.
21.keyFrames.push({
22.frame: 0,
23.value: 2
24.});
25.
26.keyFrames.push({
27.frame: frameRate,
28.value: -2
29.});
30.
31.keyFrames.push({
32.frame: 2 * frameRate,
33.value: 2
34.});
35.
36.xSlide.setKeys(keyFrames);
37.
38.box.animations.push(xSlide);
39.
40.scene.beginAnimation(box, 0, 2 * frameRate, true);
41.
42.return scene;
43.};
最终运行的效果如图3.33所示。
图3.33动画播放效果
上述通过代码来实现动画播放的方法当然可行，但是当动画的需求变得复杂之后，通过代码来实现动画效果显然会变得极其复杂。这时候，有一个良好的动画设计工具就显得尤为重要了，所幸Babylon.js也为开发者提供了动画曲线编辑器(Animation Curve Editor)，帮助开发者更快速地设计动画，该编辑器界面如图3.34所示。可以看出这里的动画曲线编辑器与Unity中的动画曲线编辑器能够实现的功能是非常类似的。
图3.34动画曲线编辑器
3.7.2序列动画
在大部分动画需求中，一个动画剪辑是无法实现我们想要的结果的，通常会将多个动画剪辑进行组合搭配顺序播放，这样为每个动画剪辑来指定播放的时间，就可以构成一整套动画片段。
例如，想要制作一段这样的动画： 相机显示一栋带门的建筑，然后相机靠近门并停了下来，门打开，相机进入房间，房间灯亮了，门关闭，相机扫过房间。这一段文字描述的动画涉及多个物体、多个画面，因此属于一组序列动画，其中涉及如下几种动画物体。
(1) Camera（相机），相机位移而导致画面运动。
(2) Door（门），开门/关门的动画。
(3) Light（灯光）。
可通过一个时间表来描述这段动画，如图3.35所示。
图3.35动画时间表
描述清楚动画之间的时间关系后，可按照下列步骤来实现想要的效果。
1. 相机向前移动的动画
通过push()方法为动画添加相机向前移动的关键帧。
1.var movein = new BABYLON.Animation("movein", "position", frameRate, BABYLON.Animation.ANIMATIONTYPE_VECTOR3,BABYLON.Animation.ANIMATIONLOOPMODE_CONSTANT);
2.
3.var movein_keys = ［］;
4.
5.movein_keys.push({
6.frame: 0,
7.value: new BABYLON.Vector3(0, 5, -30)
8.});
9.
10.movein_keys.push({
11.frame: 3 * frameRate,
12.value: new BABYLON.Vector3(0, 2, -10)
13.});
14.
15.movein_keys.push({
16.frame: 5 * frameRate,
17.value: new BABYLON.Vector3(0, 2, -10)
18.});
19.
20.movein_keys.push({
21.frame: 8 * frameRate,
22.value: new BABYLON.Vector3(-2, 2, 3)
23.});
24.
25.movein.setKeys(movein_keys);
2. 相机扫过的动画
通过push()方法为动画添加相机向前扫过的关键帧。
1.var rotate = new BABYLON.Animation("rotate", "rotation.y", frameRate, BABYLON.Animation.ANIMATIONTYPE_FLOAT,BABYLON.Animation.ANIMATIONLOOPMODE_CONSTANT);
2.
3.var rotate_keys = ［］;
4.
5.rotate_keys.push({
6.frame: 0,
7.value: 0
8.});
9.
10.rotate_keys.push({
11.frame: 9 * frameRate,
12.value: 0
13.});
14.
15.rotate_keys.push({
16.frame: 14 * frameRate,
17.value: Math. PI
18.});
19.
20.rotate.setKeys(rotate_keys);
3. 门打开和关闭的动画
通过push()方法为动画添加门打开和关闭的关键帧。
1.var sweep = new BABYLON.Animation("sweep", "rotation.y", frameRate, BABYLON.Animation.ANIMATIONTYPE_FLOAT,BABYLON.Animation.ANIMATIONLOOPMODE_CONSTANT);
2.
3.var sweep_keys = ［］;
4.
5.sweep_keys.push({
6.frame: 0,
7.value: 0
8.});
9.
10.sweep_keys.push({
11.frame: 3 * frameRate,
12.value: 0
13.});
14.
15.sweep_keys.push({
16.frame: 5 * frameRate,
17.value: Math.PI/3
18.});
19.
20.sweep_keys.push({
21.frame: 13 * frameRate,
22.value: Math.PI/3
23.});
24.
25.sweep_keys.push({
26.frame: 15 * frameRate,
27.value: 0
28.});
29.
30.sweep.setKeys(sweep_keys);
4. 灯光变亮和变暗的动画
通过push()方法为动画添加调整灯光明暗的关键帧。
1.var lightDimmer = new BABYLON.Animation("dimmer", "intensity", frameRate, BABYLON.Animation.ANIMATIONTYPE_FLOAT,BABYLON.Animation.ANIMATIONLOOPMODE_CONSTANT);
2.
3.var light_keys = ［］;
4.
5.light_keys.push({
6.frame: 0,
7.value: 0
8.});
9.
10.light_keys.push({
11.frame: 7 * frameRate,
12.value: 0
13.});
14.
15.light_keys.push({
16.frame: 10 * frameRate,
17.value: 1
18.});
19.
20.light_keys.push({
21.frame: 14 * frameRate,
22.value: 1
23.});
24.
25.light_keys.push({
26.frame: 15 * frameRate,
27.value: 0
28.});
29.
30.lightDimmer.setKeys(light_keys);
5. 运行所有动画剪辑
最后调用上述所有的动画剪辑。
1.scene.beginDirectAnimation(camera, ［movein, rotate］, 0, 25 * frameRate, false);
2.scene.beginDirectAnimation(hinge, ［sweep］, 0, 25 * frameRate, false);
3.scene.beginDirectAnimation(spotLights［0］, ［lightDimmer］, 0, 25 * frameRate, false);
4.scene.beginDirectAnimation(spotLights［1］, ［lightDimmer.clone()］, 0, 25 * frameRate, false);
6. 创建场景中的物体
然后添加上述动画场景中的物体对象，包括场地、门等。
1.var ground = BABYLON.MeshBuilder.CreateGround("ground", {width:50, height:50}, scene);
2.
3.var wall1 = BABYLON.MeshBuilder.CreateBox("door", {width:8, height:6, depth:0.1}, scene);
4.wall1.position.x = -6;
5.wall1.position.y = 3;
6.
7.var wall2 = BABYLON.MeshBuilder.CreateBox("door", {width:4, height:6, depth:0.1}, scene);
8.wall2.position.x = 2;
9.wall2.position.y = 3;
10.
11.var wall3 = BABYLON.MeshBuilder.CreateBox("door", {width:2, height:2, depth:0.1}, scene);
12.wall3.position.x = -1;
13.wall3.position.y = 5;
14.
15.var wall4 = BABYLON.MeshBuilder.CreateBox("door", {width:14, height:6, depth:0.1}, scene);
16.wall4.position.x = -3;
17.wall4.position.y = 3;
18.wall4.position.z = 7;
19.
20.var wall5 = BABYLON.MeshBuilder.CreateBox("door", {width:7, height:6, depth:0.1}, scene);
21.wall5.rotation.y = Math.PI/2;
22.wall5.position.x = -10;
23.wall5.position.y = 3;
24.wall5.position.z = 3.5;
25.
26.var wall6 = BABYLON.MeshBuilder.CreateBox("door", {width:7, height:6, depth:0.1}, scene);
27.wall6.rotation.y = Math.PI/2;
28.wall6.position.x = 4;
29.wall6.position.y = 3;
30.wall6.position.z = 3.5;
31.
32.var roof = BABYLON.MeshBuilder.CreateBox("door", {width:14, height:7, depth:0.1}, scene);
33.roof.rotation.x = Math.PI/2;
34.roof.position.x = -3;
35.roof.position.y = 6;
36.roof.position.z = 3.5;
37.
38.}
3.8音频
Babylon.js的音频是基于Web Audio规范的，因此当开发者需要使用声音时，运行WebXR的浏览器需要兼容Web Audio规范。假设在不支持Web Audio规范的浏览器上使用，并不会影响引擎其他功能的使用，只是无法播放音频而已。声音引擎支持环境音、空间音和定向音，可以通过代码或加载.babylon文件来创建，一般开发过程中使用的音频文件扩展名为.mp3或.wav。
3.8.1创建音频文件
创建音频文件的代码如下：
1.var createScene = function () {
2.var scene = new BABYLON.Scene(engine);
3.
4.var camera = new BABYLON.FreeCamera("FreeCamera", new BABYLON.Vector3(0, 0, 0), scene);
5.
6.//载入音频文件，一旦准备好开始自动循环播放
7.var music = new BABYLON.Sound("Violons", "sounds/violons11.wav", scene, null, { loop: true, autoplay: true });
8.
9.return scene;
10.};
下面列举Sound()函数中各个参数的作用。
第一个参数： 声音的名称。
第二个参数： 要加载的声音的 URL，即音频文件所在的路径。
第三个参数： 附加声音的场景。
第四个参数： 一旦声音准备好播放，函数就会被回调。
第五个参数： 一个 JSON 对象。
也可以监听音乐处于可播放状态时回调函数的状态，表示当音频文件从本地加载并解析完成，或者从Web服务器加载或解析完成，接下来会自动播放音乐，代码如下：
1.var createScene = function () {
2.var scene = new BABYLON.Scene(engine);
3.
4.var camera = new BABYLON.FreeCamera("FreeCamera", new BABYLON.Vector3(0, 0, 0), scene);
5.
6.var music = new BABYLON.Sound("Violons", "sounds/violons11.wav", scene,
7.function() {
8.// Sound has been downloaded & decoded
9.music.play();
10.}
11.);
12.
13.return scene;
14.};
此代码从 Web 服务器加载 music.wav 文件，对其进行解码并使用 play()函数在回调函数中播放一次。如果没有传递参数，那么play()函数会立即播放声音，当然也可以提供 number 类型的参数,设定在x秒后再开始播放声音，具体视需求而定。
3.8.2通过事件触发音频播放
在一些情况下，需要通过键盘或者鼠标事件来触发音乐的播放或停止，接下来实现音乐与事件的绑定。代码中的window.addEventListener()函数分别监听鼠标左键和键盘空格键的Click事件，当这些动作触发之后，就播放gunshot.wav这个游戏中枪械开火的音效，从而实现通过事件的触发来控制音频播放的功能。
1.var createScene = function () {
2.var scene = new BABYLON.Scene(engine);
3.
4.var camera = new BABYLON.FreeCamera("FreeCamera", new BABYLON.Vector3(0, 0, 0), scene);
5.
6.var gunshot = new BABYLON.Sound("gunshot", "sounds/gunshot.wav", scene);
7.
8.window.addEventListener("mousedown", function(evt) {
9.//单击鼠标左键开火
10.if (evt.button === 0) {
11.gunshot.play();
12.}
13.});
14.
15.window.addEventListener("keydown", function (evt) {
16.//按下空格键开火
17.if (evt.keyCode === 32) {
18.gunshot.play();
19.}
20.});
21.
22.return scene;
23.};
3.8.3音乐属性
可以通过选项对象或setVolume()函数设置声音的音量，也可以以相同的方式设置播放速率。如果将开发者自己注册到 onended 事件中，还可以在声音播放完毕时收到通知。下面是一个混合所有这些功能的简单示例代码。
1.var volume = 0.1;
2.var playbackRate = 0.5;
3.var gunshot = new BABYLON.Sound("Gunshot", "./gunshot-1.wav", scene, null, {
4.playbackRate: playbackRate,
5.volume: volume
6.});
7.
8.gunshot.onended = function() {
9.if (volume < 1) {
10.volume += 0.1;
11.gunshot.setVolume(volume);
12.}
13.playbackRate += 0.1;
14.gunshot.setPlaybackRate(playbackRate);
15.};
3.8.4通过ArrayBuffer来加载音频文件
如果开发者使用自己提供的 ArrayBuffer 调用构造函数，则可以绕过第一阶段的请求(即嵌入式 XHR 请求)，下面是一段示例代码。
1.var createScene = function () {
2.var scene = new BABYLON.Scene(engine);
3.
4.var camera = new BABYLON.FreeCamera("FreeCamera", new BABYLON.Vector3(0, 0, 0), scene);
5.
6.var gunshotFromAB;
7.loadArrayBufferFromURL("sounds/gunshot.wav");
8.
9.function loadArrayBufferFromURL(urlToSound) {
10.var request = new XMLHttpRequest();
11.request.open('GET', urlToSound, true);
12.request.responseType = "arraybuffer";
13.request.onreadystatechange = function() {
14.if (request.readyState == 4) {
15.if (request.status == 200) {
16.gunshotFromAB = new BABYLON.Sound("FromArrayBuffer", request.response, scene, soundReadyToBePlayed);
17.}
18.}
19.};
20.request.send(null);
21.}
22.
23.function soundReadyToBePlayed() {
24.gunshotFromAB.play();
25.}
26.
27.return scene;
28.};
3.8.5通过资源管理器加载音频文件
资源管理器在WebXR开发过程中非常有用。通过资源管理器加载音频文件，就可以实现加载进度的展示，而不用让应用处于等待状态。
1.var createScene = function () {
2.var scene = new BABYLON.Scene(engine);
3.
4.var camera = new BABYLON.FreeCamera("FreeCamera", new BABYLON.Vector3(0, 0, 0), scene);
5.
6.var music1, music2, music3;
7.//通过AssetsManager资源管理器加载音频
8.var assetsManager = new BABYLON.AssetsManager(scene);
9.
10.var binaryTask = assetsManager.addBinaryFileTask("Violons18 task", "sounds/violons18.wav");
11.binaryTask.onSuccess = function (task) {
12.music1 = new BABYLON.Sound("Violons18", task.data, scene, soundReady, { loop: true });
13.}
14.
15.var binaryTask2 = assetsManager.addBinaryFileTask("Violons11 task", "sounds/violons11.wav");
16.binaryTask2.onSuccess = function (task) {
17.music2 = new BABYLON.Sound("Violons11", task.data, scene, soundReady, { loop: true });
18.}
19.
20.var binaryTask3 = assetsManager.addBinaryFileTask("Cello task", "sounds/cellolong.wav");
21.binaryTask3.onSuccess = function (task) {
22.music3 = new BABYLON.Sound("Cello", task.data, scene, soundReady, { loop: true });
23.}
24.
25.var soundsReady = 0;
26.
27.function soundReady() {
28.soundsReady++;
29.if (soundsReady === 3) {
30.music1.play();
31.music2.play();
32.music3.play();
33.}
34.}
35.
36.assetsManager.load();
37.
38.return scene;
39.};
3.9相机和网格
3.9.1相机的行为
1. 弹跳行为（Bouncing Behaviour）
在轨道相机ArcRotateCamera中，当相机的半径达到最小值或最大值时，会产生一个小的弹跳效果，可以通过下面的属性来配置此行为。
(1) transitionDuration： 定义动画的持续时间，以毫秒为单位，默认值为 450ms。
(2) lowerRadiusTransitionRange： 定义到达下半径时过渡动画的距离长度，默认值为 2。
(3) upperRadiusTransitionRange： 定义到达上半径时过渡动画的距离长度，默认值为-2。
(4) autoTransitionRange： 定义一个值，指示是否自动定义了 lowerRadiusTransitionRange 和upperRadiusTransitionRange。过渡范围将设置为世界空间中边界框对角线的5%。
要在ArcRotateCamera上启用弹跳行为，可执行下面的一行代码：
camera.useBouncingBehaviour = true;
2. 自动旋转行为（AutoRotation Behaviour）
一般针对一个三维物体进行展示时，当用户没有对场景中的模型进行交互时，可以让相机围绕目标缓慢旋转，以便于用户观察。该行为可以使用下列属性进行配置。
(1) idleRotationSpeed： 相机围绕网格旋转的速度。
(2) idleRotationWaitTime： 用户交互后相机开始旋转前等待的时间(以毫秒为单位)。
(3) idleRotationSpinupTime： 旋转到完全停止所需的时间(以毫秒为单位)。
(4) zoomStopsAnimation： 指示用户缩放是否应停止动画的标志。
要在轨道相机上启用自动旋转行为，可执行下面的一行代码：
camera.useAutoRotationBehaviour = true;
3. 框架行为（Framing Behaviour）
框架行为BABYLON.FramingBehaviour旨在在轨道相机的目标设置为网格时自动定位它。如果想防止相机进入虚拟水平面，那么该框架行为也很有用。可以使用以下属性配置该行为：
(1)BABYLON.FramingBehaviour.IgnoreBoundsSizeMode——相机可以一直向网格移动。
(2) BABYLON.FramingBehaviour.FitFrustumSidesMode——不允许相机比被调整的边界球体所接触的平截头体侧面的点更接近网格。参数有两个，分别为：
定义应用于半径的比例，默认为 1。
设置要在 Y 轴上应用的比例以定位相机焦点，默认为 0.5(表示边界框的中心)。
(3) defaultElevation——定义水平面上方/下方的角度，以便在触发默认高程空闲行为时返回，以弧度为单位，默认为 0.3。
(4) elevationReturnTime——定义返回到默认 beta 位置(默认为 1500)所需的时间，以毫秒为单位，负值表示相机不应返回默认值。
(5) depthReturnWaitTime——定义相机返回到默认 beta 位置之前的延迟，以毫秒为单位，默认为 1000。
(6) zoomStopsAnimation——定义用户缩放场景时是否应该停止动画。
(7) framingTime——构建网格框架时的过渡时间，以毫秒为单位，默认为 1500。
要在轨道相机上启用框架行为，可执行以下的一行代码：
camera.useFramingBehaviour = true;
3.9.2网格的行为
1. PointerDragBehaviour
该行为用于使用鼠标或 VR 控制器围绕平面或轴拖动网格，它可以在 3 种不同的模式下初始化。
(1) dragAxis： 将沿着提供的轴进行拖动。
(2) dragPlaneNormal： 将沿着法线定义的平面进行拖动。
(3) None： 将沿着面向相机的平面进行拖动。
默认情况下，拖动平面/轴将根据对象的方向进行修改。要将指定的轴/平面固定在世界坐标系中，应将 useObjectOrientationForDragging 设置为 false。下面实现一个完整的案例，代码如下：
1.var createScene = function () {
2.//创建基本场景
3.var scene = new BABYLON.Scene(engine);
4.var camera = new BABYLON.FreeCamera("camera1", new BABYLON.Vector3(1, 5, -10), scene);
5.camera.setTarget(BABYLON.Vector3.Zero());
6.var light = new BABYLON.HemisphericLight("light1", new BABYLON.Vector3(0, 1, 0), scene);
7.light.intensity = 0.7;
8.var sphere = BABYLON.Mesh.CreateSphere("sphere1", 16, 2, scene);
9.sphere.rotation.x = Math.PI/2
10.sphere.position.y = 1;
11.var ground = BABYLON.Mesh.CreateGround("ground1", 6, 6, 2, scene);
12.
13.//定义pointerDragBehaviour网格行为
14.//var pointerDragBehaviour = new BABYLON.PointerDragBehaviour({});
15.//var pointerDragBehaviour = new BABYLON.PointerDragBehaviour({dragPlaneNormal: new BABYLON.Vector3(0,1,0)});
16.var pointerDragBehaviour = new BABYLON.PointerDragBehaviour({dragAxis: new BABYLON.Vector3(1,0,0)});
17.
18.//将指定的轴/平面固定在世界坐标系中
19.pointerDragBehaviour.useObjectOrientationForDragging = false;
20.
21.//监听拖动事件
22.pointerDragBehaviour.onDragStartObservable.add((event)=>{
23.console.log("dragStart");
24.console.log(event);
25.})
26.pointerDragBehaviour.onDragObservable.add((event)=>{
27.console.log("drag");
28.console.log(event);
29.})
30.pointerDragBehaviour.onDragEndObservable.add((event)=>{
31.console.log("dragEnd");
32.console.log(event);
33.})
34.
35.//如果需要手动处理拖动事件(在不移动附加网格的情况下使用拖动行为)，则将moveAttached设置为false
36.// pointerDragBehaviour.moveAttached = false;
37.
38.sphere.addBehaviour(pointerDragBehaviour);
39.
40.return scene;
41.
42.};
2. SixDofDragBehaviour
基于指针的原点(例如，相机或 VR 控制器位置)，将Mesh网格在3D空间中进行拖动，默认情况下，通过将网格缓慢移动到指针指向的位置来平滑指针抖动。 要删除或修改此行为，可以修改以下字段。
sixDofDragBehaviour.dragDeltaRatio = 0.2;
默认情况下，（将对象拖离/拖向用户的操作将被放大来确保更容易将物体移动到更远的距离。为了规避或者修改这种情况，可以使用以下内容：
sixDofDragBehaviour.zDragFactor = 0.2;
需要注意的一点是，为避免在使用具有复杂几何形状的模型时对性能造成较大影响，应将对象包裹在边界框网格中。
3.10资源管理
在Babylon.js引擎中，默认内置的能够加载的资源格式为.babylon格式，其他的资源格式都需要加载对应的插件来实现，例如，glTF、GLB、OBJ、STL等格式的模型资源。如果要快速添加所有的加载插件，可以在页面中添加以下脚本：
在使用NPM进行安装时，可以使用下面的命令：
npm install --save babylonjs babylonjs-loaders
如果开发时采用TypeScript语言，则需要在tsconfig.json文件中添加如下代码：
...
"types": ［
"babylonjs",
"babylonjs-loaders",
""
］,
...
在完成上述设置工作后，就可以在代码中引用对应的类型了。当使用Webpack打包项目时，将使用最小的minifield文件。
import * as BABYLON from 'babylonjs';
import 'babylonjs-loaders';
3.10.1SceneLoader.Append
所有资源类型都可以用SceneLoader.Append接口来进行加载，具体使用方法如下：
1.BABYLON.SceneLoader.Append("./", "duck.gltf", scene, function (scene) {
2.//场景中将要执行的动作
3.});
通过字符串加载Babylon的资源并添加到场景中。使用的格式是“data： ”关键字加表示资源的字符串。
1.BABYLON.SceneLoader.Append("", "data:" + gltfString, scene, function (scene) {
2.//场景中将要执行的动作
3.});
还可以通过一个基于Base64编码的.glb二进制文件进行加载。
1.var base64_model_content = "data:;base64,BASE 64 ENCODED DATA...";
2.BABYLON.SceneLoader.Append("", base64_model_content, scene, function (scene) {
3.//场景中将要执行的动作
4.});
3.10.2SceneLoader.Load
该方法将加载所有Babylon资源并且创建一个新的场景。
1.BABYLON.SceneLoader.Load("/assets/", "batman.obj", engine, function (scene) {
2.//场景中将要执行的动作
3.});
3.10.3SceneLoader.ImportMesh
该方法用来向场景中加载网格Mesh和骨骼Skeletons，默认第一个参数为null，表示加载文件中的所有Mesh和Skeletons。
1.BABYLON.SceneLoader.ImportMesh(［"myMesh1", "myMesh2"］, "./", "duck.gltf", scene, function (meshes, particleSystems, skeletons) {
2./场景中使用mesh和skeletons将要执行的动作
3.//对于glTF资源，粒子系统通常为null
4.});
在上述回调函数中，对于glTF格式的文件，particleSystems始终为null，也就是说，glTF文件是无法支持Babylon引擎中的粒子系统的。
3.10.4SceneLoader.ImportMeshAsync
该函数为ImportMesh的异步版本，可以通过调用返回的promise或使用await关键字来获得结果。注意，要在createScene()函数中使用await关键字，必须在其定义中将其标记为async。
1. 使用promise
1.const importPromise = BABYLON.SceneLoader.ImportMeshAsync(［"myMesh1", "myMesh2"］, "./", "duck.gltf", scene);
2.importPromise.then((result) => {
3.//结果包含网格、粒子系统、骨架、动画组和变换节点
4.})
2. 使用await关键字
1.const result = await BABYLON.SceneLoader.ImportMeshAsync(［"myMesh1", "myMesh2"］, "./", "duck.gltf", scene);
3.10.5SceneLoader.LoadAssetContainer
Container意为容器。顾名思义，该函数将加载资源，但并不会立即将资源添加至场景中，而是会先放在一个容器中。
1.BABYLON.SceneLoader.LoadAssetContainer("./", "duck.gltf", scene, function (container) {
2.var meshes = container.meshes;
3.var materials = container.materials;
4....
5.// 最后再将所有元素添加至场景中
6.container.addAllToScene();
7.});
3.10.6SceneLoader.ImportAnimations
该函数将加载动画文件并合并至场景中。
1.BABYLON.SceneLoader.ImportAnimations("./", "Elf_run.gltf", scene);
3.10.7SceneLoader.AppendAsync
该函数为SceneLoader.Append函数的异步版本。
1.BABYLON.SceneLoader.AppendAsync("./", "duck.gltf", scene).then(function (scene) {
2.//场景中将要执行的动作
3.});
3.10.8AssetsManager
在项目中，大部分情况下都会加载多个资源，Babylon.js从1.14版本开始引入了资源管理类。该类可以用于将网格导入到场景中，或加载文本、二进制文件等。下面学习如何使用AssetsManager类来加载资源。
1. 初始化并创建任务
在使用AssetsManager之前，首先需要通过当前场景创建一个资源管理器。
1.var assetsManager = new BABYLON.AssetsManager(scene);
接下来，通过assetsManager.addMeshTask函数可以向assetsManager添加一个任务，代码如下：
1.var meshTask = assetsManager.addMeshTask("skull task", "", "scenes/", "skull.babylon");
每一个任务都可以通过监听成功和失败的回调函数来做进一步的处理。
（1) 当加载成功时，加载Mesh并初始化坐标。
1.meshTask.onSuccess = function (task) {
2.task.loadedMeshes［0］.position = BABYLON.Vector3.Zero();
3.}
（2) 当加载失败时，控制台给出异常日志。
1.meshTask.onError = function (task, message, exception) {
2.console.log(message, exception);
3.}
2. 任务的类型
AssetsManager类主要有如下的8种任务类型，下面依次说明。
(1) TextFileTask： 文本文件任务。
(2) MeshAssetTask： 网格资源任务。
(3) TextureAssetTask： 纹理资源任务。
(4) CubeTextureAssetTask： 立方体纹理资源任务。
(5) ContainerAssetTask： 容器资源任务。
(6) BinaryFileAssetTask： 二进制文件资源任务。
(7) ImageAssetTask： 图像资源任务。
(8) HDRCubeTextureTask： HDR立方体纹理任务。
3. 运行AssetsManager
调用下列代码运行所有的任务：
assetsManager.load();
4. AssetsManager的回调和观察者
AssetsManager提供了4个回调来帮助开发者更好地监测资源加载信息，它们分别是：
(1) onFinish——所有任务加载完成。
(2) onProgress——加载进度。
(3) onTaskSuccess——任务加载成功。
(4) onTaskError——加载任务报错。
下列代码举例说明AssetsManager的具体使用方法，给出了通过onProgress方式加载UI文本的过程。
1.assetsManager.onProgress = function(remainingCount, totalCount, lastFinishedTask) {
2. engine.loadingUIText = 'We are loading the scene. ' + remainingCount + ' out of ' +totalCount + ' items still need to be loaded.';
3.};
4.
5.assetsManager.onFinish = function(tasks) {
6.engine.runRenderLoop(function() {
7.scene.render();
8.});
9.};
3.10.9使用加载进度
默认情况下，在进行资源的加载时，AssetsManager会显示一个加载界面，如图3.36所示。
图3.36显示加载界面
要想禁用上述加载界面，可使用下面的代码：
assetsManager.useDefaultLoadingScreen = false;
如果使用的是SceneLoader来加载资源，那么当SceneLoader中的ShowLoadingScreen设置为true时，也会显示上面的加载界面。该属性默认情况下为true。如果要禁用加载界面，则需使用下列方式：
BABYLON.SceneLoader.ShowLoadingScreen = false;
也可以通过手动调用以下的函数来打开或者关闭加载UI，当然，在大部分情况下，都是需要加载界面的。
engine.displayLoadingUI();
engine.hideLoadingUI();
还可以设置加载UI上的文字内容和加载界面的背景颜色。
engine.loadingUIText = "text";
engine.loadingUIBackgroundColor = "red";
3.11材质
材质使得场景中的网格物体拥有了颜色和纹理，一个物体的材质如何显示，取决于场景中的灯光，以及材质如何对灯光进行计算并反映到画面中。材质对光有如下4种可能的反应方式。
(1) 漫反射(Diffuse)： 漫反射表示在灯光照射下物体的基本颜色或质地。
(2) 高光(Specular)： 灯光使得材质产生高光。
(3) 自发光(Emissive)： 材质的颜色或质地仿佛会自发光。
(4) 环境(Ambient)： 由背景灯光或环境光照射的材质颜色或纹理。
漫反射和高光需要开发者创建光源，环境光需要设置场景的环境色或给予场景背景光照。设置场景环境色的代码如下：
scene.ambientColor = new BABYLON.Color3(1, 1, 1);
3.11.1材质的创建
通过代码来创建材质(Material)的方式如下：
var myMaterial = new BABYLON.StandardMaterial("myMaterial", scene);
当材质创建完成后，可以设置上面提到的4种颜色中的一个或多个，但是大家要记得，ambientColor只有在设置了场景的ambientColor后才会生效。
1.myMaterial.diffuseColor = new BABYLON.Color3(1, 0, 1);
2.myMaterial.specularColor = new BABYLON.Color3(0.5, 0.6, 0.87);
3.myMaterial.emissiveColor = new BABYLON.Color3(1, 1, 1);
4.myMaterial.ambientColor = new BABYLON.Color3(0.23, 0.98, 0.53);
5.mesh.material = myMaterial;
3.11.2漫反射
为了了解diffuseColor如何对灯光做出反应，下面展示不同颜色的材质对白色、红色、绿色和蓝色的漫反射聚光灯做出反应的过程。完整的案例代码如下：
1.var createScene = function () {
2.var scene = new BABYLON.Scene(engine);
3.var camera = new BABYLON.ArcRotateCamera("Camera", -Math.PI / 2, Math.PI / 3, 10, BABYLON.Vector3.Zero(), scene);
4.camera.attachControl(canvas, true);
5.
6.var mats = ［
7.new BABYLON.Color3(1, 1, 0),
8.new BABYLON.Color3(1, 0, 1),
9.new BABYLON.Color3(0, 1, 1),
10.new BABYLON.Color3(1, 1, 1)
11.］
12.
13.var redMat = new BABYLON.StandardMaterial("redMat", scene);
14.redMat.emissiveColor = new BABYLON.Color3(1, 0, 0);
15.
16.var greenMat = new BABYLON.StandardMaterial("greenMat", scene);
17.greenMat.emissiveColor = new BABYLON.Color3(0, 1, 0);
18.
19.var blueMat = new BABYLON.StandardMaterial("blueMat", scene);
20.blueMat.emissiveColor = new BABYLON.Color3(0, 0, 1);
21.
22.var whiteMat = new BABYLON.StandardMaterial("whiteMat", scene);
23.whiteMat.emissiveColor = new BABYLON.Color3(1, 1, 1);
24.
25.
26.//红光
27.var lightRed = new BABYLON.SpotLight("spotLight", new BABYLON.Vector3(-0.9, 1 , -1.8), new BABYLON.Vector3(0, -1, 0), Math.PI / 2, 1.5, scene);
28.lightRed.diffuse = new BABYLON.Color3(1, 0, 0);
29.lightRed.specular = new BABYLON.Color3(0, 0, 0);
30.
31.//绿光
32.var lightGreen = new BABYLON.SpotLight("spotLight1", new BABYLON.Vector3(0, 1, -0.5), new BABYLON.Vector3(0, -1, 0), Math.PI / 2, 1.5, scene);
33.lightGreen.diffuse = new BABYLON.Color3(0, 1, 0);
34.lightGreen.specular = new BABYLON.Color3(0, 0, 0);
35.
36.//蓝光
37.var lightBlue = new BABYLON.SpotLight("spotLight2", new BABYLON.Vector3(0.9, 1, -1.8), new BABYLON.Vector3(0, -1, 0), Math.PI / 2, 1.5, scene);
38.lightBlue.diffuse = new BABYLON.Color3(0, 0, 1);
39.lightBlue.specular = new BABYLON.Color3(0, 0, 0);
40.
41.//白光
42.var lightWhite = new BABYLON.SpotLight("spotLight3", new BABYLON.Vector3(0, 1, 1), new BABYLON.Vector3(0, -1, 0), Math.PI / 2, 1.5, scene);
43.lightWhite.diffuse = new BABYLON.Color3(1, 1, 1);
44.lightWhite.specular = new BABYLON.Color3(0, 0, 0);
45.
46.var redSphere = BABYLON.MeshBuilder.CreateSphere("sphere", {diameter: 0.25}, scene);
47.redSphere.material = redMat;
48.redSphere.position = lightRed.position;
49.
50.var greenSphere = BABYLON.MeshBuilder.CreateSphere("sphere", {diameter: 0.25}, scene);
51.greenSphere.material = greenMat;
52.greenSphere.position = lightGreen.position;
53.
54.var blueSphere = BABYLON.MeshBuilder.CreateSphere("sphere", {diameter: 0.25}, scene);
55.blueSphere.material = blueMat;
56.blueSphere.position = lightBlue.position;
57.
58.var whiteSphere = BABYLON.MeshBuilder.CreateSphere("sphere", {diameter: 0.25}, scene);
59.whiteSphere.material = whiteMat;
60.whiteSphere.position = lightWhite.position;
61.
62.var groundMat = new BABYLON.StandardMaterial("groundMat", scene);
63.groundMat.diffuseColor = mats［0］;
64.
65.var ground = BABYLON.MeshBuilder.CreateGround("ground", {width: 4, height: 6}, scene);
66.ground.material = groundMat;
67.
68./*******************GUI***********************/
69.var makeYellow = function() {
70.groundMat.diffuseColor = mats［0］;
71.}
72.
73.var makePurple = function() {
74.groundMat.diffuseColor = mats［1］;
75.}
76.
77.var makeCyan = function() {
78.groundMat.diffuseColor = mats［2］;
79.}
80.
81.var makeWhite = function() {
82.groundMat.diffuseColor = mats［3］;
83.}
84.
85.var matGroup = new BABYLON.GUI.RadioGroup("Material Color", "radio");
86.matGroup.addRadio("Yellow", makeYellow, true);
87.matGroup.addRadio("Purple", makePurple);
88.matGroup.addRadio("Cyan", makeCyan);
89.matGroup.addRadio("White", makeWhite);
90.
91.var advancedTexture = BABYLON.GUI.AdvancedDynamicTexture.CreateFullscreenUI("UI");
92.
93.var selectBox = new BABYLON.GUI.SelectionPanel("sp", ［matGroup］);
94.selectBox.width = 0.25;
95.selectBox.height = "50%";
96.selectBox.top = "4px";
97.selectBox.left = "4px";
98.selectBox.background = "white";
99.selectBox.horizontalAlignment = BABYLON.GUI.Control.HORIZONTAL_ALIGNMENT_LEFT;
100.selectBox.verticalAlignment = BABYLON.GUI.Control.VERTICAL_ALIGNMENT_TOP;
101.
102.advancedTexture.addControl(selectBox);
103.
104.return scene;
105.
106.};
代码运行后，可以看到画面效果如图3.37所示。
图3.37支持多种颜色的漫反射聚光效果
在本案例中，创建了4盏聚光灯，它们的漫反射颜色分别为白光、绿光、红光和蓝光。为了便于观察，在这4盏灯的位置上创建了4个小球，并设置其漫反射颜色。接下来需要观察这4盏灯照射到地面(图3.37中黑色的Plane)后，地面呈现出的效果。
尝试将地面的漫反射颜色依次设置为黄色(Yellow)、紫色(Purple)、青色(Cyan)和白色(White)，然后分别观察在不同的漫反射颜色下的聚光灯效果。
第一种情况： 地面的漫反射颜色为黄色时，对灯光的反应效果如图3.38所示。
第二种情况： 地面的漫反射颜色为紫色时，对灯光的反应效果如图3.39所示。注意观察白光照射后的地面颜色。
图3.38漫反射颜色为黄色时的聚光效果
图3.39漫反射颜色为紫色时的聚光效果
第三种情况： 地面的漫反射颜色为青色时，对灯光的反应效果如图3.40所示。同样注意白光的照射区域。
第四种情况： 地面的漫反射颜色为白色时，对灯光的反应效果如图3.41所示。
图3.40漫反射颜色为青色时的聚光效果
图3.41漫反射颜色为白色时的聚光效果
3.11.3环境光颜色
接下来探索环境光颜色的作用，首先创建如下示例代码。
1.var createScene = function () {
2.var scene = new BABYLON.Scene(engine);
3.var camera = new BABYLON.ArcRotateCamera("Camera", -Math.PI / 2,Math.PI / 4, 5, BABYLON.Vector3.Zero(), scene);
4.camera.attachControl(canvas, true);
5.
6.scene.ambientColor = new BABYLON.Color3(1, 1, 1);
7.
8.var redMat = new BABYLON.StandardMaterial("redMat", scene);
9.redMat.ambientColor = new BABYLON.Color3(1, 0, 0);
10.
11.var greenMat = new BABYLON.StandardMaterial("redMat", scene);
12.greenMat.ambientColor = new BABYLON.Color3(0, 1, 0);
13.
14.//无环境光
15.var sphere0 = BABYLON.MeshBuilder.CreateSphere("sphere0", {}, scene);
16.sphere0.position.x = -1.5;
17.
18.//红色环境光
19.var sphere1 = BABYLON.MeshBuilder.CreateSphere("sphere1", {}, scene);
20.sphere1.material = redMat;
21.
22.//绿色环境光
23.var sphere2 = BABYLON.MeshBuilder.CreateSphere("sphere2", {}, scene);
24.sphere2.material = greenMat;
25.sphere2.position.x = 1.5;
26.
27.return scene;
28.
29.};
上述代码创建了3个球体，它们的位置分别为左、中、右。左边的球体没有环境光颜色，中间的球体采用红色的环境光颜色，右边的球体采用绿色的环境光颜色。首先将上面代码中的场景环境光颜色注释掉，运行后只会得到如图3.42所示的效果。
图3.42无场景环境光下的材质效果
通过运行可以看到，如果不设置场景的环境光，那么即使右边两个球体都设置了环境光颜色，也依然得到的是黑色的球体，这就验证了前面提到的，环境光有效的前提是必须设置场景的ambientColor。接下来打开设置场景环境光的代码，重新运行场景后会得到如图3.43所示的效果。
图3.43有场景环境光下的材质效果
由于左侧的小球没有设置ambientColor，因此无法呈现出物体的颜色，而右侧两个小球都呈现出了环境光颜色。但还可以继续做个测试，因为当下的背景的环境光颜色为白色，因此右侧两个小球都呈现出的是自己的本色。如果改变背景环境光颜色，结果又会如何？将代码修改如下：
scene.ambientColor = new BABYLON.Color3(1, 1, 0);
上述代码会将场景的环境光颜色设置为黄色，黄色是由红色和绿色混合而成，那么背景的环境光颜色是否会影响小球的环境光颜色呢？运行效果如图3.44所示。
图3.44场景环境光与物体环境光颜色不冲突情况下的效果
可以观察到右边两个小球的颜色基本没有变化，接下来再将环境光颜色设置为(0，1，0)，即绿色，然后再运行代码，效果如图3.45所示。
图3.45场景的环境光设置为绿色情况下的效果
可以看到背景的绿色并没有与物体的环境颜色进行混合，继续测试将背景的环境光颜色改为(0.5，1，0)，得到如图3.46所示的效果。
图3.46调整场景环境光改变物体亮度的效果
可以看出红色小球的亮度减半，而绿色小球的亮度不变，因此通过观察上述现象可知，背景的环境光颜色并不是与物体的环境光颜色进行混合，而只是对物体环境光的亮度进行了设置。接下来，向场景中添加如下代码：
1.var light = new BABYLON.HemisphericLight("hemiLight", new BABYLON.Vector3(-1, 1, 0), scene);
2.light.diffuse = new BABYLON.Color3(1, 0, 0);
上述代码向场景中添加了一个半球光，这个光从左上角对场景进行照射，其diffuseColor为红色，运行代码后，得到如图3.47所示的效果。
图3.47添加场景半球光后的效果
可以看到，红色的半球光照亮了3个小球，让最左侧的小球也呈现出红色。接下来，为灯光添加高光颜色。
light.specular = new BABYLON.Color3(0, 1, 0);
将灯光的高光颜色设置为绿色后，再运行场景，可以看到如图3.48所示的效果。
图3.48继续为场景半球光添加高光
此时已经可以看到高光对小球产生的效果了，那么接下来进入这个案例最重要的环节，即环境光的效果，继续添加代码。
light.groundColor = new BABYLON.Color3(0, 1, 0);
将灯光的背景色设置为绿色后，继续运行场景，可以看到如图3.49所示的效果。
图3.49将灯光的背景色更改为绿色
左侧小球的右下角部分呈现绿色，说明灯光的背景色对物体产生了效果，这里可以推测，当不设置材质的环境光颜色时，应该默认为白色，中间的小球本色为红色。受到灯光的背景色影响后，右下角部分呈现黄色，这是红色和绿色混合后呈现的效果，最右侧的小球右下角呈现绿色，这是因为绿色与绿色混合依然为绿色。
3.11.4透明颜色
材质的透明度设置可以直接设置材质的alpha值，0为全透明，1为不透明，介于0和1之间则为不同程度的半透明效果。
myMaterial.alpha = 0.5;
下面通过一个案例来说明透明材质的使用，代码如下：
1.var createScene = function () {
2.var scene = new BABYLON.Scene(engine);
3.var camera = new BABYLON.ArcRotateCamera("Camera", -Math.PI / 2, 3 * Math.PI / 8, 5, BABYLON.Vector3.Zero(), scene);
4.camera.attachControl(canvas, true);
5.
6.
7.//半球光从左上角照射
8.var light = new BABYLON.HemisphericLight("hemiLight", new BABYLON.Vector3(-1, 1, 0), scene);
9.light.diffuse = new BABYLON.Color3(1, 0, 0);
10.light.specular = new BABYLON.Color3(0, 1, 0);
11.light.groundColor = new BABYLON.Color3(0, 1, 0);
12.
13.var redMat = new BABYLON.StandardMaterial("redMat", scene);
14.redMat.diffuseColor = new BABYLON.Color3(1, 0, 0);
15.
16.var greenMat = new BABYLON.StandardMaterial("greenMat", scene);
17.greenMat.diffuseColor = new BABYLON.Color3(0, 1, 0);
18.greenMat.alpha = 0.5;
19.
20.//添加一个红色不透明球体
21.var sphere1 = BABYLON.MeshBuilder.CreateSphere("sphere1", {}, scene);
22.sphere1.material = redMat;
23.sphere1.position.z = 1.5;
24.
25.//添加一个绿色透明球体
26.var sphere2 = BABYLON.MeshBuilder.CreateSphere("sphere2", {}, scene);
27.sphere2.material = greenMat;
28.
29.return scene;
30.
31.};
图3.50材质的透明度对比
在场景中创建了两个球体： 一个红色球体为不透明材质，一个绿色球体为透明材质，最终实现的效果如图3.50所示。可以看到，透明材质在两个物体重叠部分可以实现透明的效果。
3.11.5纹理
纹理(Texture)有时候又被称为贴图，两者意思相同。在计算机图形学中，通过一张图片(Image)来作为模型的纹理，与材质的颜色接近。当材质创建完成后，可以设置材质的diffuseTexture、SpecularTexture、emmissiveTexture或者embientTexture。这里同样需要注意如果没有设置场景的环境色，那么embientTexture的设置也是无效的。具体设置的方法如下（在实际使用过程中，将纹理路径替换为真实的路径即可）：
1.var myMaterial = new BABYLON.StandardMaterial("myMaterial", scene);
2.myMaterial.diffuseTexture = new BABYLON.Texture("PATH TO IMAGE", scene);
3.myMaterial.specularTexture = new BABYLON.Texture("PATH TO IMAGE", scene);
4.myMaterial.emissiveTexture = new BABYLON.Texture("PATH TO IMAGE", scene);
5.myMaterial.ambientTexture = new BABYLON.Texture("PATH TO IMAGE", scene);
6.mesh.material = myMaterial;
当创建的材质为StandardMaterial时，如果没有指定法线，那么Babylon.js会自动计算法线。下面通过一个案例来说明材质的不同纹理是如何呈现的，以及针对光照有哪些反应。本案例选择使用一张草地的纹理来赋予材质，纹理样式如图3.51所示。
图3.51材质纹理样例
本案例的完整代码如下所示。
1.var createScene = function () {
2.var scene = new BABYLON.Scene(engine);
3.var camera = new BABYLON.ArcRotateCamera("Camera", -Math.PI / 2,Math.PI / 4, 5, BABYLON.Vector3.Zero(), scene);
4.camera.attachControl(canvas, true);
5.
6.//半球光从左上角进行照射
7.var light = new BABYLON.HemisphericLight("hemiLight", new BABYLON.Vector3(-1, 1, 0), scene);
8.light.diffuse = new BABYLON.Color3(1, 0, 0);
9.light.specular = new BABYLON.Color3(0, 1, 0);
10.light.groundColor = new BABYLON.Color3(0, 1, 0);
11.
12.var grass0 = new BABYLON.StandardMaterial("grass0", scene);
13.grass0.diffuseTexture = new BABYLON.Texture("textures/grass.png", scene);
14.
15.var grass1 = new BABYLON.StandardMaterial("grass1", scene);
16.grass1.emissiveTexture = new BABYLON.Texture("textures/grass.png", scene);
17.
18.var grass2 = new BABYLON.StandardMaterial("grass2", scene);
19.grass2.ambientTexture = new BABYLON.Texture("textures/grass.png", scene);
20.grass2.diffuseColor = new BABYLON.Color3(1, 0, 0);
21.
22.//漫反射纹理
23.var sphere0 = BABYLON.MeshBuilder.CreateSphere("sphere0", {}, scene);
24.sphere0.position.x = -1.5;
25.sphere0.material = grass0;
26.
27.//自发光纹理
28.var sphere1 = BABYLON.MeshBuilder.CreateSphere("sphere1", {}, scene);
29.sphere1.material = grass1;
30.
31.//环境光纹理和漫反射颜色
32.var sphere2 = BABYLON.MeshBuilder.CreateSphere("sphere2", {}, scene);
33.sphere2.material = grass2;
34.sphere2.position.x = 1.5;
35.
36.return scene;
37.
38.};
上述代码创建了3个球体，3个球体分别设置了3种不同的材质，最左边的球体采用的材质为漫反射纹理，中间的球体采用的材质为自发光纹理，右边的球体采用的材质为环境纹理，并将材质的环境色设置为红色，3种材质采用的纹理都为相同的草地纹理。
场景中只有一盏灯，即一个半球光来模拟环境光照，灯光的diffuseColor为红色，specularColor为绿色，groundColor为绿色。运行场景后，得到如图3.52所示的效果。
图3.52在物体具有半球光的前提下继续添加材质
3.11.6透明纹理
前面已经提到过，可以设置材质的透明度，实现代码如下：
myMaterial.alpha = 0.5;
这种设置透明的方法针对的是整个材质的颜色透明度，而对于纹理来说，图像可能会存在一部分区域为透明区域，是没有颜色信息的，而另一部分为图案，拥有颜色，如图3.53所示的图像中就拥有透明区域。
图3.53拥有透明区域的纹理
很容易就可以观察到图3.53中的图像哪部分为透明区域，但这样的透明纹理具体如何实现，依然通过一个案例来说明，完整的代码如下：
1.var createScene = function() {
2.var scene = new BABYLON.Scene(engine);
3.var camera = new BABYLON.ArcRotateCamera("Camera", 3 * Math.PI / 2, Math.PI / 2, 5, BABYLON.Vector3.Zero(), scene);
4.camera.attachControl(canvas, false);
5.
6.var light = new BABYLON.HemisphericLight("light1", new BABYLON.Vector3(0, 1, 0), scene);
7.light.intensity = 0.7;
8.
9.var pl = new BABYLON.PointLight("pl", BABYLON.Vector3.Zero(), scene);
10.pl.diffuse = new BABYLON.Color3(1, 1, 1);
11.pl.specular = new BABYLON.Color3(1, 1, 1);
12.pl.intensity = 0.8;
13.
14.var mat = new BABYLON.StandardMaterial("dog", scene);
15.mat.diffuseTexture = new BABYLON.Texture("https://upload.wikimedia.org/wikipedia/commons/8/87/Alaskan_Malamute%2BBlank.png", scene);
16.mat.diffuseTexture.hasAlpha = true;
17.mat.backFaceCulling = false;
18.var box = BABYLON.MeshBuilder.CreateBox("box", {}, scene);
19.box.material = mat;
20.
21.return scene;
22.};
上述代码中创建了一个立方体，并将上面的透明纹理赋予立方体，最终运行场景会得到如图3.54所示的效果。
3.11.7显示模型线框
打开网格(mesh)的线框显示方法非常简单，只需将材质的wireframe属性开关打开即可，代码如下：
materialSphere1.wireframe = true;
线框模型的显示效果如图3.55所示。
图3.54材质的立方体效果
图3.55材质的线框模型