Vue使用vue-3d-model组件预览3D三维文件、立体文件,支持旋转、自动播放

简介: Vue使用vue-3d-model组件预览3D三维文件、立体文件,支持旋转、自动播放

实现效果

Tips:先泼个冷水,这个预览3D组件有个致命的缺陷——不能设置材质、皮肤文件的目录路径,必须要和3d文件放在同一个目录,如果项目是用hash模式(url后面会有/#/这种井号),就会导致无法读取根目录的材质文件。所以推荐了解下 vue-3d-loader

安装先

npm install vue-3d-model --save

属性

prop type default example
src string - './exapmle.obj'
width number - 300
height number - 300
position object { x: 0, y: 0, z: 0 } { x: 100, y: 20, z: -10 }
rotation object { x: 0, y: 0, z: 0 } { x: Math.PI / 2, y: 0, z: - Math.PI / 4 }
cameraPosition object { x: 0, y: 0, z: 0 } { x: 1, y: 2, z: -3 }
cameraRotation object { x: 0, y: 0, z: 0 } { x: 3, y: 2, z: -1 }
scale object { x: 1, y: 1, z: 1 } { x: 2, y: 2, z: 3 }
lights array -
backgroundColor number/string 0xffffff 0xffffff/'#f00'/'rgb(255,255,255)'
backgroundAlpha number 1 0.5
controlsOptions object - see OrbitControls Propertiesopen in new window
crossOrigin string anonymous anonymous/use-credentials
requestHeader object - { 'Authorization: Bearer token' }
outputEncoding number THREE.LinearEncoding see WebGLRenderer OutputEncodingopen in new window
glOptions object { antialias: true, alpha: true } see WebGLRenderer Parametersopen in new window

事件

event
mousedown
mousemove
mouseup
click
load
progress
error

插槽

slots
progress-bar
poster
<template>
    <div class="threeDPreview">
        <!-- 3D立体文件预览 -->
        <div if="threeDComponents" class="threeD">
            <component
                :is="threeDComponents.componentName" 
                :backgroundAlpha="1" 
                :backgroundColor="'#000'"
                :rotation="ratation" 
                :src="`${encodeURIComponent(_fileURL)}`" 
                @load="onLoad" />
        </div>
    </div>
</template>
<script>
//引入3D预览插件 npm install vue-3d-model --save
import { ModelCollada, ModelFbx, ModelGltf, ModelThree, ModelObj, ModelPly, ModelStl, } from 'vue-3d-model';
export default {
    components: {
        ModelCollada, ModelFbx, ModelGltf, ModelThree, ModelObj, ModelPly, ModelStl,
    },
    data() {
        return {
            load: null,
            threeDfileTypes: [
                { label: 'dae', value: 1, iconURL: 'static/img/fileType/3D/dae.svg', componentName: 'ModelCollada' },
                { label: 'fbx', value: 2, iconURL: 'static/img/fileType/3D/fbx.svg', componentName: 'ModelFbx' },
                { label: 'gltf', value: 3, iconURL: 'static/img/fileType/3D/gltf.svg', componentName: 'ModelGltf' },
                { label: 'json', value: 4, iconURL: 'static/img/fileType/3D/json.svg', componentName: 'ModelThree' },
                { label: 'obj', value: 5, iconURL: 'static/img/fileType/3D/obj.svg', componentName: 'ModelObj' },
                { label: 'ply', value: 6, iconURL: 'static/img/fileType/3D/ply.svg', componentName: 'ModelPly' },
                { label: 'stl', value: 7, iconURL: 'static/img/fileType/3D/stl.svg', componentName: 'ModelStl' },
            ],
            ratation: {
                x: -Math.PI / 2,
                y: 0,
                z: 0,
            },
            _fileURL: '',
            _fileType: '',
        };
    },
    props: ["fileURL", "fileType"],
    watch: {
        fileURL: {
            handler(d) {
                this._fileURL = decodeURIComponent(d || this.$route.query.fileURL);
            }, deep: true, immediate: true,
        },
        fileType: {
            handler(d) {
                this._fileType = d || this._fileURL.split('.').slice(-1)[0];
                // 如果是3D文件个后缀名格式
                if (this.threeDfileTypes.find(v => v.label == this._fileType)) {
                    this.showLoad();
                }
            }, deep: true, immediate: true,
        },
    },
    computed: {
        threeDComponents() {
            return this.threeDfileTypes.find(v => v.label == this._fileType);
        },
    },
    methods: {
        showLoad() { this.load = this.$loading({ text: "加载中…" }); },
        hideLoad() { this.load && this.load.close(); },
        onLoad(d) {
            this.rotate();
            this.hideLoad();
        },
        rotate() {
            requestAnimationFrame(this.rotate);//实现自动旋转效果
            this.rotation.z += 0.01;
        },
    }
};
</script>
<style lang="scss" scoped>
.threeDPreview {
    position: relative;
    .threeD {
        width: 100%;
        height: calc(100vh - 60px);
    }
}
</style>

相关API文档来源:

image.png

可能会遇到的报错

image.png

其他可以预览3D的组件,前列腺推荐!

image.png


相关文章
|
12天前
|
存储 JavaScript 开发者
Vue 组件间通信的最佳实践
本文总结了 Vue.js 中组件间通信的多种方法,包括 props、事件、Vuex 状态管理等,帮助开发者选择最适合项目需求的通信方式,提高开发效率和代码可维护性。
|
12天前
|
存储 JavaScript
Vue 组件间如何通信
Vue组件间通信是指在Vue应用中,不同组件之间传递数据和事件的方法。常用的方式有:props、自定义事件、$emit、$attrs、$refs、provide/inject、Vuex等。掌握这些方法可以实现父子组件、兄弟组件及跨级组件间的高效通信。
|
23天前
|
缓存 JavaScript UED
Vue 中实现组件的懒加载
【10月更文挑战第23天】组件的懒加载是 Vue 应用中提高性能的重要手段之一。通过合理运用动态导入、路由配置等方式,可以实现组件的按需加载,减少资源浪费,提高应用的响应速度和用户体验。在实际应用中,需要根据具体情况选择合适的懒加载方式,并结合性能优化的其他措施,以打造更高效、更优质的 Vue 应用。
|
28天前
|
前端开发 UED
vue3知识点:Suspense组件
vue3知识点:Suspense组件
31 4
|
27天前
|
JavaScript 前端开发 测试技术
组件化开发:创建可重用的Vue组件
【10月更文挑战第21天】组件化开发:创建可重用的Vue组件
24 1
|
28天前
|
JavaScript 前端开发 Java
《vue3第五章》新的组件,包含:Fragment、Teleport、Suspense
《vue3第五章》新的组件,包含:Fragment、Teleport、Suspense
32 2
|
28天前
|
Java
vue3知识点:Teleport组件
vue3知识点:Teleport组件
27 1
|
5天前
|
缓存 JavaScript 前端开发
vue学习第四章
欢迎来到我的博客!我是瑞雨溪,一名热爱JavaScript与Vue的大一学生。本文介绍了Vue中计算属性的基本与复杂使用、setter/getter、与methods的对比及与侦听器的总结。如果你觉得有用,请关注我,将持续更新更多优质内容!🎉🎉🎉
vue学习第四章
|
5天前
|
JavaScript 前端开发
vue学习第九章(v-model)
欢迎来到我的博客,我是瑞雨溪,一名热爱JavaScript与Vue的大一学生,自学前端2年半,正向全栈进发。此篇介绍v-model在不同表单元素中的应用及修饰符的使用,希望能对你有所帮助。关注我,持续更新中!🎉🎉🎉
vue学习第九章(v-model)
|
5天前
|
JavaScript 前端开发 开发者
vue学习第十章(组件开发)
欢迎来到瑞雨溪的博客,一名热爱JavaScript与Vue的大一学生。本文深入讲解Vue组件的基本使用、全局与局部组件、父子组件通信及数据传递等内容,适合前端开发者学习参考。持续更新中,期待您的关注!🎉🎉🎉
vue学习第十章(组件开发)