基于 HTML5 + WebGL 的 3D 风力发电场

前言

风能是一种开发中的洁净能源，它取之不尽、用之不竭。当然，建风力发电场首先应考虑气象条件和社会自然条件。近年来，我国海上和陆上风电发展迅猛。海水、陆地为我们的风力发电提供了很好地质保障。正是这些场地为我们的风力提供了用之不竭的能源。现在我们正在努力探索这些领域。

本文章实现了风力发电场的整体流程。能让大家能够看到一套完整风力发电预览体系。

需要注意的是，本次项目是使用 Hightopo 的 HT for Web 产品来搭建的。

预览地址：https://hightopo.com/demo/wind-power-station/

大致流程

下面是整个项目的流程图。我们从首页可以进入到场区分布页面和集控页面。

场区分布页面又包括两个不同的 3D 场景，分别是陆地风机场和海上风机场。点击两个 3D 风机场最终都会进入到 3D 风机场景。

预览效果

首页:

1. 世界地图效果

2. 中国地图效果

2. 城市地图效果

集控中心页面（没有动画效果）：

场区分布页面（没有动画效果）：

陆地风机场：

海上风机场：

代码实现

我们可以看到，首页的地球有三种视角状态，世界地图、中国地图、城市地图。点击每个状态相机就会转到对应的位置。在这之前我们要先预先存一下对应的 center 和 eye 。

我们最好新建一个 data.js 文件，专门用来提供数据。

相关伪代码如下：

// 记录位置
var cameraLocations = {
    earth: {
        eye: [-73, 448, 2225],
        center: [0, 0, 0]
    },

    china: {
        eye: [-91, 476, 916],
        center: [0, 0, 0]
    },

    tsankiang: {
        eye: [35, 241, 593],
        center: [0, 0, 0]
    }
}

好了，有了数据之后。我们接下来该监听事件了。我们可以点击按钮，也可以点击高亮区域（世界地图只有按钮可以点击）进入到中国地图视角。

我们可以这样先获取这两个节点，然后对它们的点击事件进行相同的处理。但是，我觉得这种方式可以进行优化，更换一种思考方式。

我们可以先将事件进行过滤，我们创建两个数组，一个保存着类似 click、onEnter 这样可以执行的事件，一个保存着所有可以触发事件的节点。这样可以有利于我们维护，也可以使结构更加清晰。

下图，我们可以看到，如果当前节点没有事件权限或者当前事件本身就没有权限的话，就会被过滤掉。如果都可以正确返回，则执行对应的事件。

相关伪代码如下：

// 权限事件
this.eventMap = {
    clickData: true,
    onEnter: true,
    onLeave: true
}

// 权限节点
this.nodeMap = {
    outline: true,
    outline2: true,
    earth: true,
    bubbles: true,
    circle: true
}

/**
  * 监听事件
  */
initMonitor() {
    var gv = this.gv
　　 var self = this
var evntFlow = function (e) {
        var event = e.kind
        var tag = e.data && e.data.getTag()

         // 检查当前事件或者节点是否能够被执行
         if (!self.eventMap[event] && !self.nodeMap[tag]) return false

         self.nodeEvent(event, tag)
    }

    gv.mi(eventFlow)
}

只要我们当前要执行的节点符合要求，我们就会把 event (当前执行的事件) 和 tag (节点标签) 传给执行函数 nodeEvent 执行。这样就不会浪费资源去处理那些无效的事件或者节点了。

我们接下来来看看 nodeEvent 怎么处理吧！

相关伪代码如下：

/**
 * 气泡事件
 * @param { string } event 当前事件
 * @param { string } propertyName 当前节点标签
 */
bubblesEvent(event, propertyName) {
    var dm = this.dm
    var account = dm.getDataByTag('account')
    var currentNode = dm.getDataByTag(propertyName)
    var self = this

    var clickData = function() {
        // 执行清除动作
        self.clearAction()
    }

    var onEnter = function() {
       // do something
    }

    var onLeave = function() {
　　　　// do something
    }

    var allEvent = { clickData, onEnter, onLeave }

    allEvent[event] && allEvent[event]()
}

可以看到，我们可以利用 propertyName(节点标签) 字符串拼接组成一个方法名。比如当前拿到的节点标签是 bubbles ， this[`${ properName }Event`] 之后，拿到就是 this['bubblesEvent'] 这个方法。当然，这个方法是我们事先定义好的。

在具体的节点方法里面，我们创建了对应的事件函数。根据传过来的 event 来判断是否拥有对应的方法。如果有的话执行，否则返回 false 。这样做的好处是：解耦、结构简洁、出现问题能够快速定位。

但是，如果我们仔细想想，我们点击世界地图和中国地图的时候，功能都差不多！如果我们可以将他们合并的话，就会方便很多了！！我们来改造一下代码。

相关伪代码如下：

/**
  * 执行节点事件
  */
nodeEvent(event, propertyName) {
    // 过滤是否有可以合并的事件
    var filterEvents = function(propertyName) {
        var isCombine = false
　　　　　var self = this

if (['earth', 'china'].includes(propertyName)) {
            self.changeCameraLocaltions(event, propertyName)
            isCombine = true
        }

        return !isCombine
    }
   var eventFun = this[`${propertyName}Event`]
   // 执行对应的节点事件
   filterEvents(propertyName)
   &&
   eventFun
　　&&
   eventFun(event, propertyName)
}

我们事先判断当前事件是否能合并，如果能的话返回 false ，不再执行下面的代码，然后执行自己的函数。

这时候，我们就可以通过对应的节点标签，从 data.js 的 cameraLocations 变量中取到对应的 center、eye 。

相关伪代码如下：

/**
 * 移动镜头动画
 * @param { object } config 坐标对象
 */
moveCameraAnim(gv, config) {
　　var eye = config.eye
　　var center = config.center
　　// 如果动画已经存在，进行清空
   if(globalAnim.moveCameraAnim) {
      globalAnim.moveCameraAnim.stop()
　　　 globalAnim.moveCameraAnim = null
   }

   var animConfig = {
   　　duration: 2e3
   }

   globalAnim.moveCameraAnim = gv.moveCamera(eye, center, animConfig)
}

// 需要改变相机位置
changeCameraLocaltions(event, properName) {
    var config = cameraLocations[properName]

    // 移动相机
    this.moveCameraAnim(this.gv, config)
}

移动镜头动画使用到了 gv 的 moveCamera 方法，该方法接受 3 个参数，eye (相机)，center (目标)，animConfig (动画配置) 。然后我们把当前动画返回给 globalAnim 的 moveCameraAnim 属性，方便我们进行清理。

接下来，就是切换页面了，这点需要非常小心谨慎。因为一旦没有把某个属性清除的话，将会导致内存泄漏等问题，性能会越来越慢。将会导致页面卡死的情况！

所以我们需要一个专门用来清除数据模型的函数 clearAction 。我们应该把所有的动画对象放到一个对象或者数组中。这样方便切换页面的时候清理掉。

相关伪代码如下：

/**
 * 清除动作
 */
clearAction(index) {
    var { dm, gv } = this
    var { g3d, d3d } = window

    allListener.mi3d && g3d.umi(allListener.mi3d)
    allListener.mi2d && gv.umi(allListener.mi2d)
    dm.removeScheduleTask(this.schedule)

    dm && dm.clear()
    d3d && d3d.clear()

    window.d3d = null
    window.dm = null

    for (var i in globalAnim) {
        globalAnim[i] && globalAnim[i].pause()
        globalAnim[i] = null
    }

    // 清除对应的 3D 图纸
    ht.Default.removeHTML(g3d)

    gv.addToDOM()
    ht.Default.xhrLoad(`displays/HT-project_2019/风电/${index}.json`, function (text) {
        let json = ht.Default.parse(text)
        gv.deserialize(json, function(json, dm2, gv2, datas) {
            if (json.title) document.title = json.title

            if (json.a['json.background']) {
                let bgJSON = json.a['json.background']
                if (bgJSON.indexOf('scenes') === 0) {
                    var bgG3d

                    if (g3d) {
                        bgG3d = g3d
                    } else {
                        bgG3d = new ht.graph3d.Graph3dView()
                    }

                    var bgG3dStyle = bgG3d.getView()
                    bgG3dStyle.className = index === 1 ? '' : index === 3 ? 'land' : 'offshore'

                    bgG3d.deserialize(bgJSON, function(json, dm3, gv3, datas) {
                        init3d(dm3, gv3)
                    })

                    bgG3d.addToDOM()
                    gv.addToDOM(bgG3dStyle)
                }
                gv.handleScroll = function () {}
            }

            init2d(dm2, gv2)
        })
    })
}

首先我们需要把 dm(数据模型) 和 gv(图纸) 清除掉。还要注意：mi(监听函数)、schedule(调度任务) 应该在 dm.clear() 之前 remove。所有的动画进行 stop() 操作，然后将其值设为 null 。这里需要注意的是，执行 stop 之后，会调用一次 finishFunc 回调函数。

当我们的 2D 图纸里面包含 3D 背景的情况下，需要判断是否已经存在了 3D 的实例，如果存在不需要再次创建。有兴趣可以了解一下 webGL 的应用内存泄漏问题。

当进入两个 3D 场景场景的时候，我们需要一个开场动画，如开头效果 gif 图一样。所以我们，需要把两个开场动画的 center 和 eye 都存到我们已经定义好的 cameraLocations 中。

// 记录位置
var cameraLocations = {
    earth: {
        eye: [-73, 448, 2225],
        center: [0, 0, 0]
    },

    china: {
        eye: [-91, 476, 916],
        center: [0, 0, 0]
    },

    tsankiang: {
        eye: [35, 241, 593],
        center: [0, 0, 0]
    },

    offshoreStart: {
        eye: [-849, 15390, -482],
        center: [0, 0, 0]

    },

    landStart: {
        eye: [61, 27169, 55],
        center: [0, 0, 0]
    },

    offshoreEnd: {
        eye: [-3912, 241, 834],
        center: [0, 0, 0]
    },

    landEnd: {
        eye: [4096, 4122, -5798],
        center: [1261, 2680, -2181]
    }
}

offshoreStart、offshoreEnd、landStart、landEnd 表示海上和陆上发电场的开始位置和结束位置。

我们需要判断当前加载的是海上发电场还是陆上发电场。我们可以在加载对应图纸的时候添加 className 。

我们在 clearAction 这个函数已经定义了 index 这个参数，如果点击的是陆地发电场传的就是数字3，如果是海上发电场的话，就是数字4。

比如我需要加载陆地发电场，那么就可以通过判断 g3d.className = index === 3 ? 'land' : 'offshore' 来添加 className 。

然后在 init 里面进行初始化的判断。

相关伪代码如下：

init() {
    var className = g3d.getView().className
    
    // 执行单独的事件
    this.selfAnimStart(className)
this.initData()

    // 监听事件
    this.monitor()
}

我们拿到对应的 className ，传入相对应的类型并且执行对应的初始化事件，通过我们已经定义好的 moveCameraAnim 函数进行相机的动画。

相关伪代码如下：

/**
  * 不同风电场的开场动画
  */
selfAnimStart(type) {
    var gv = this.gv
    var { eye, center } = cameraLocations[`${type}End`]
    var config = {
        duration: 3000,
        eye,
        center,
     }

     this.moveCameraAnim(gv, config)
}