【 攻城略地 】vue3 + vite + ts加载3dTiles

本文适用于从未接触过3d开发的新手,寻找解决方案的部分比较详细,文章最下方有相关包的配置文件,可跳过该部分直接使用。

安装vite

vite为前端构建工具,我们使用vite来搭建项目基础结构。

文档:

开始 {#getting-started} | Vite中文网

安装:


# 使用 NPM

$ npm init vite@latest

# 使用 Yarn

$ yarn create vite

# 使用 PNPM

$ pnpm create vite

使用vite搭建vue3 + ts项目

安装:


# npm 6.x

npm init vite@latest my-vue-app --template vue-ts

# npm 7+, 需要额外的双横线

npm init vite@latest my-vue-app -- --template vue-ts

# yarn

yarn create vite my-vue-app --template vue-ts

# pnpm

pnpm create vite my-vue-app -- --template vue-ts

如需安装其他模板可查看文档说明。

加载3dTiles文件

由于第一次接手3d开发,并不清楚哪些方案比较合适,所以在开始阶段碰到了许多问题,下面是找到解决方案的大致过程。

方案1:three.js

开发web3d,首先想到的就是用three.js,在参考《threejs加载3dtiles(倾斜摄影)数据》这篇文章时也顺利完成了数据的加载,但模型界面却显示不出来,估计与该文章下这条评论出现了一样的问题。

image

对于3d开发0经验的我来说,只能不停的搜索相关文档尝试解决,花费了几个小时,始终无法解决,但也得知了cesium这个3d框架更适合加载3dTiles。项目开发时,在有限时间里不能在一棵树上吊死,及时转换方向能节省更多的时间,最终在对比两者文档后果断放弃three。

相关资料:

threejs加载3dtiles(倾斜摄影)数据

threejs加载3dtiles(倾斜摄影)数据_Always(一直如此)的博客-CSDN博客_threejs 倾斜摄影

three-loader-3dtiles

GitHub - NASA-AMMOS/3DTilesRendererJS: Renderer for 3D Tiles in Javascript using three.js

3DTilesRendererJS

GitHub - nytimes/three-loader-3dtiles: This is a Three.js loader module for handling OGC 3D Tiles, created by Cesium. It currently supports the two main formats, Batched 3D Model (b3dm) - based on glTF Point cloud.

方案2:cesium.js

cesium天然支持3dTiles格式,加载3dTiles很简单,但需要进行额外的配置。

网上有很多vue使用cesium的配置教程,但大部分都是使用webpack进行配置,而且vue2版本居多,各种资料的内容又参差不齐,对于本项目来说造成了额外的时间成本,对新手来说非常不友好。

我在尝试配置后发现始终无效,而且对于这些配置的意思也无法理解,最终放弃直接使用cesium,继续寻找更方便的vue + cesium的解决方案。

cesium.js中文文档

Camera - Cesium Documentation

方案3:vue-cesium

在一番查找后,最终选择了vue-cesium,vue-cesium支持vue3、typescript,我把他称为3d版的element-ui,开箱即用,非常方便,免去了各种令人头疼耗时的配置过程,对新手非常友好。

文档:

VueCesium - Vue 2.x & Vue 3.x components for CesiumJS.

安装:


# NPM

$ npm install vue-cesium@next --save

# Yarn

$ yarn add vue-cesium@next

# pnpm

$ pnpm install vue-cesium@next

使用:

安装完成后,你可以选择完整引入或者按需导入,因为我只用到其中几个组件,所以我选择了按需导入,使用 VcPrimitiveTileset 这个组件就能导入3dTiles文件。

其他具体业务的实现查看文档即可,如果你使用过element-ui,那你一定会使用vue-cesium。

在使用过程中发现的问题:

1.文档VcOverlayHtml组件描述错误

image

正确引入样式文件:import 'vue-cesium/dist/index.css’

如果你打开文档时显示是正确的,那就表示文档已经更新过了。

2.build打包报错

打包时,vue-cesium源码内会有ts报错,几乎都是Cesium未找到的错误,这个需要在tsconfig.json中忽略对node_modules 中的检查,你可以配置只忽略 vue-cesium 这个包,我是全部忽略了。


// tsconfig.json

{

  "compilerOptions": {

    "skipLibCheck": true,

    ...

  },

  "exclude": [

    "node_modules",

    "./node_modules",

    "./node_modules/",

    "./node_modules/@types/node/index.d.ts",

    …

  ],

  }

注意:如果你的项目根目录没有配置tsconfig.json,需要先添加该文件,参考:tsconfig.json · TypeScript中文网 · TypeScript——JavaScript的超集

在引用vue-cesium组件的文件内ts也会Cesiu未找到的错误,可以配置ts只忽略该文件。


// ExampleComponent.vue

<script lang="ts">

// @ts-nocheck

…

</script>

如果你在使用跟我一样版本的vue-cesium时也出现上述的错误,不用慌张,我们看到VcConfigProvider这个全局配置组件是使用CDN为vue-cesium导入cesium某个版本的,而不是模块化的导入。


<vc-config-provider

:cesium-path='https://cdn.jsdelivr.net/npm/cesium@latest/Build/Cesium/Cesium.js'>

</ vc-config-provider>

由于没看过vue-cesium的源码实现,我猜测原因就是这个,因为没有影响任何功能的实现,我直接使用 // @ts-nocheck 忽略了整个文件的ts检查。

总结

项目使用的各个包及其版本号:


// package.json

"dependencies": {

  "vue": "^3.2.25",

  "vue-cesium": "^3.0.9",

  …

},

"devDependencies": {

  "@vitejs/plugin-vue": "^2.2.0",

  "typescript": "^4.5.4",

  "vite": "^2.8.3",

  "vue-tsc": "^0.29.8"

  …

}

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,222评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,455评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,720评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,568评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,696评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,879评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,028评论 3 409
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,773评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,220评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,550评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,697评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,360评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,002评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,782评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,010评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,433评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,587评论 2 350

推荐阅读更多精彩内容