Three.js 模型视频材质教程

模型视频材质 ·Video Model· ▶ 在线运行案例

• 案例合集：三维可视化功能案例（threehub.cn）
• 开源仓库github地址：https://github.com/z2586300277/three-cesium-examples
• 400个案例代码:网盘链接

你将学到什么

• OrbitControls 相机轨道交互
• glTF/Draco 模型加载与优化
• requestAnimationFrame渲染循环与resize自适应

效果说明

本案例演示模型视频材质效果：基于 WebGL 实现「模型视频材质」可视化效果，附完整可运行源码；核心用到 OrbitControls、glTF/Draco。建议先打开文首在线案例查看动态画面，再对照下方源码逐步理解。

核心概念

• Scene / Camera / WebGLRenderer构成最小渲染闭环；大场景可开logarithmicDepthBuffer缓解 Z-fighting。
• OrbitControls提供轨道旋转/缩放；开启enableDamping后需在 animate 中controls.update()。
• 阅读下方完整源码时，建议从init/load/animate三条主线入手，再深入 shader 与工具函数。

实现步骤

• 搭建 Scene、PerspectiveCamera、WebGLRenderer，挂载 canvas 并处理resize
• 异步加载模型 / 3D Tiles / GeoJSON 等资源并加入 scene 或 entities
• 创建 OrbitControls（及 Raycaster 等交互控件，若源码包含）
• 在requestAnimationFrame循环中更新状态并 render（Cesium 为viewer.render或自动渲染）

• 代码要点

  import * as THREE from 'three'
  import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js' import { GLTFLoader } from "three/examples/jsm/loaders/GLTFLoader.js";
  const box = document.getElementById('box')
  const scene = new THREE.Scene()
  const camera = new THREE.PerspectiveCamera(50, box.clientWidth / box.clientHeight, 0.1, 1000)
  camera.position.set(0, 8, 30)
  const renderer = new THREE.WebGLRenderer({ antialias: true, alpha: true, logarithmicDepthBuffer: true })
  renderer.setSize(box.clientWidth, box.clientHeight)
  box.appendChild(renderer.domElement)
  const controls = new OrbitControls(camera, renderer.domElement)
  controls.enableDamping = true
  animate()
  function animate() {
  requestAnimationFrame(animate)
  controls.update()
  renderer.render(scene, camera)
  }
  window.onresize = () => {
  renderer.setSize(box.clientWidth, box.clientHeight)
  camera.aspect = box.clientWidth / box.clientHeight
  camera.updateProjectionMatrix()
  }
  // 文件地址 const urls = [0, 1, 2, 3, 4, 5].map(k => (FILE_HOST + 'files/sky/skyBox0/' + (k + 1) + '.png'));
  const textureCube = new THREE.CubeTextureLoader().load(urls);
  scene.background = textureCube;
  const video = document.createElement('video')
  video.crossOrigin = 'anonymous' // 跨域
  video.src = 'https://z2586300277.github.io/3d-file-server/video/test.mp4'
  video.loop = true // 循环播放
  video.muted = true // 静音
  video.play()
  const texture = await new Promise(r => video.onloadeddata = () => r(new THREE.VideoTexture(video))) // 创建视频纹理
  new GLTFLoader().load(FILE_HOST + "models/glb/zhanguan.glb", (gltf) => {
  gltf.scene.traverse((child) => {
  if (child.isMesh) {
  child.material.map = texture
  child.material.envMap = textureCube
  }
  })
  scene.add(gltf.scene)
  })

  完整源码：GitHub

  小结

  • 本文提供模型视频材质完整 Three.js 源码与在线 Demo，建议先运行案例再改 uniform/参数做二次实验
  • 更多 Three.js 实战案例见 three-cesium-examples 合集 与 GitHub 开源仓库