可采用五种方式嵌入3D模型:一、Three.js加载glTF;二、model-viewer声明式嵌入;三、Babylon.js实现物理交互;四、USDZ配合Safari AR Quick Look;五、iframe嵌入Sketchfab等第三方服务。

如果您希望在HTML5页面中嵌入3D模型并实现基本交互,可借助WebGL渲染引擎与标准化3D格式支持能力。以下是具体实操步骤:
一、使用Three.js加载glTF格式模型
Three.js是基于WebGL的主流JavaScript 3D库,对glTF(GL Transmission Format)有原生支持,该格式由Khronos Group制定,具备轻量、高效、包含材质与动画等优势。
1、在HTML文件的
中引入Three.js CDN链接:https://cdn.jsdelivr.net/npm/three@0.160.1/examples/jsm/loaders/GLTFLoader.js及核心库:https://cdn.jsdelivr.net/npm/three@0.160.1/build/three.min.js。2、在
中创建一个具有固定id的立即学习“前端免费学习笔记(深入)”;
3、编写JavaScript代码:初始化场景、相机、渲染器,并调用GLTFLoader.load()方法加载本地或远程glTF文件(如model.gltf)。
4、将加载成功的模型对象添加至场景,并在渲染循环中更新旋转或响应鼠标拖拽事件以实现基础交互。
二、通过Model-Viewer组件嵌入3D模型
model-viewer是Google推出的Web组件,无需编写底层WebGL代码,直接以HTML标签方式声明式嵌入3D内容,兼容AR查看与触摸操作。
1、在
中引入model-viewer库:https://unpkg.com/@google/model-viewer@latest/dist/model-viewer.min.js。2、在
中插入model-viewer标签,设置src属性指向glTF或USDZ文件路径,例如:3、添加属性控制交互行为:启用camera-controls支持缩放/旋转/平移;设置auto-rotate实现自动缓慢旋转;配置ar和对应ar-modes以支持AR启动。
4、为提升首屏加载体验,可添加loading属性值为“eager”,或配合
三、利用Babylon.js实现高级交互与物理效果
Babylon.js是功能完备的开源3D引擎,内置物理系统、粒子系统与PBR材质支持,适合需要碰撞检测、重力模拟或自定义着色器的场景。
1、通过CDN引入Babylon.js核心库:https://cdn.babylonjs.com/babylon.min.js及GLTF扩展:https://cdn.babylonjs.com/loaders/babylonjs.loaders.min.js。
2、在页面中创建canvas元素作为渲染目标,并获取其WebGL上下文引用。
3、使用BABYLON.SceneLoader.ImportMesh()方法加载glTF模型,传入网格名称、路径、场景对象及回调函数。
4、启用默认物理引擎(如Cannon.js集成版),为模型网格设置physicsImpostor属性为BABYLON.PhysicsImpostor.MeshImpostor,并配置mass、friction等参数以触发真实感交互。
四、直接嵌入USDZ模型用于Safari AR场景
USDZ是Apple主导的零依赖3D归档格式,专为iOS/iPadOS Safari优化,支持无需插件的AR Quick Look预览。
1、确保服务器已正确配置MIME类型:为.usdz文件返回model/vnd.usd+zip响应头。
2、在HTML中使用标签包裹usdz文件链接,并添加rel="ar"属性,例如:View in AR。
3、添加apple-app-site-association验证文件至网站根目录,确保Quick Look功能可在非HTTPS本地开发环境外稳定启用。
4、在iOS设备上点击该链接,系统将自动调起Quick Look界面,支持手势缩放、旋转、放置于现实平面及分享导出。
五、通过iframe嵌入第三方3D托管服务
部分云平台(如Sketchfab、Vectary、Clara.io)提供公开模型的嵌入代码,适用于快速部署且无需维护3D管线的轻量级需求。
1、访问目标模型在Sketchfab上的公开页面,点击“Share”按钮,复制提供的
2、核对iframe的src属性是否包含?autostart=1&controls=1&ui_controls=1等参数,确保播放、控制与UI可见性开启。
3、将iframe粘贴至HTML文档指定位置,设置width与height为具体像素值或百分比,例如:width="100%" height="500"。
4、若需响应式适配,可在外层包裹










