安装
大约 1 分钟
安装
为了让三维应用开发更便捷,SDK包中提供了初始化和使用三维引擎必要且常见的资源文件,包括贴图、天空盒子、解压库等资源,主库文件目前暂未提供es6版本,SDK包均使用zip包方式提供给开发者。
获取
在交付包中的sdk目录下获取SDK脚本和依赖库,一般包括如下内容:
文件/夹 | 说明 |
---|---|
vt.min.js | 主脚本 |
style | 样式文件目录 |
resources | 资源文件目录 |
libs | 第三方脚本库目录 |
页面引用
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
{/* 引用样式文件 */}
<link rel="stylesheet" href="vt/style/vt.css">
{/* 引入依赖库 */}
<script src="vt/libs/three.min.js"></script>
{/* 引入主类 */}
<script src="vt/vt.min.js"></script>
</head>
</html>
按需加载
浏览器HTML页面中的脚本和样式文件一般是线性加载,VT
直接加载依赖库和样式文件大小约3M左右,在服务器开启gzip模式下,预计在1.5M~2M,在网络带宽允许的情况下,尤其是在内网环境下,推荐直接使用浏览器加载方式。
目前许多B/S架构的应用大部分为SPA应用,如果应用中三维程序嵌入的层级或模块较深,为了提高首页加载效率,不推荐在浏览器直接加载,而使用在组件中按需加载的方式,推荐使用脚本和样式文件第三方加载库,如popoload,使用方式如下:
popoload
npm i popoload
或
<script src="./js/popoload.min.js"></script>
在Vue组件中的Mounted中加载调用如下代码(React同理):
PL({
libs: [
'./vt/libs/three.min.js',
'./vt/vt.min.js'
],
styles: [
'./vt/style/vt.css'
],
loaded: function() {
// 加载完成,执行三维程序逻辑
console.log("loaded");
}
});