基于three.js与React构建WebVR项目的基类封装示例
本文介绍如何基于three.js封装WebVR项目基类,结合React框架实现场景初始化。通过定义VRpage与VRcore核心模块,封装场景、相机、渲染器及控制器,并提供start与update方法重写机制,演示正方体动画在VR环境中的渲染流程。
WebVR技术背景介绍
WebVR
在深入代码之前,有必要先了解WebVR技术背景。WebVR是一项实验性的JavaScript API,旨在允许头戴式显示器(HMD)与Web应用程序连接,并能接收来自这些设备的位置和动作数据。这使得利用JavaScript开发VR应用成为现实。尽管目前已有多种接口支持JavaScript作为开发语言,但WebVR的出现仍令人振奋。目前,移动设备上的Chrome浏览器已支持WebVR,可将手机转化为简易HMD。手机屏幕可分割为左右眼视觉,并调用加速度计和陀螺仪等传感器,用户只需配合Cardboard即可体验。
本文主要探讨如何基于three.js构建可配置的Three.js对象创建流程。
项目地址
three.js基类封装
编写一个three.js的基类
此处创建了一个Three.js基类,内部封装了场景、相机、渲染器、控制器以及若干基础方法。
// VRcore.js
import * as THREE from 'three';
const OrbitControls = require('three-orbit-controls')(THREE)
let Scene, Camera, Renderer, Controls, loopID;
function createScene({domContainer = document.body, fov = 50,far = 1000}){
if (!(domContainer instanceof HTMLElement)) {
throw new Error('domContainer is not a HTMLElement!');
}
// 初始化 scene
Scene = new THREE.Scene();
// 初始化 camera
Camera = new THREE.PerspectiveCamera(fov, domContainer.clientWidth / domContainer.clientHeight, 1, far);
Camera.position.set( 200, 200, 200 );
Camera.lookAt(Scene.position);
Scene.add(Camera);
// 初始化 renderer
Renderer = new THREE.WebGLRenderer({ canvas: domContainer, antialias: true, alpha: true } );
Renderer.clear();
Renderer.setClearColor( 0xeeeeee, 1); // 更改渲染器颜色
Renderer.setSize(domContainer.clientWidth, domContainer.clientHeight);
Renderer.shadowMap.Enabled = true;
Renderer.setPixelRatio(domContainer.devicePixelRatio);
initVR();
}
function initVR() {
// 初始化控制器
Controls = new OrbitControls(Camera, Renderer.domElement);;
Controls.addEventListener('change', render);
Controls.enableZoom = true;
}
function render() {
Renderer.render(Scene, Camera);
}
function renderStart(callback) {
loopID = 0; // 记录循环几次,后面有与清除场景中的物体
if (loopID === -1) return;
let animate = function(){
loopID = requestAnimationFrame(animate);
callback();
Controls.update();
render();
}
animate();
}
// 暂停动画渲染
function renderStop() {
if (loopID !== -1) {
window.cancelAnimationFrame(loopID);
loopID = -1;
}
}
// 回收当前场景
function clearScene() {
for(let i = Scene.children.length - 1; i >= 0; i-- ) {
Scene.remove(Scene.children[i]);
}
}
// 清理页面
function cleanPage() {
renderStop();
clearScene();
}
export {
Scene,
Camera,
Renderer,
Controls,
createScene,
initVR,
renderStart,
renderStop,
clearScene,
cleanPage
}
VRpage基类创建
创建一个VRpage基类
这是一个VRpage基类的定义,所有需要创建的Three.js项目均需继承此类,进而生成具体的Three.js项目实例。
// VRpage.js
import * as THREE from 'three';
import * as VRcore from './VRcore.js';
export default class VRpage {
constructor(options) {
// 创建场景
VRcore.createScene(options);
this.start();
this.loadPage();
}
loadPage() {
VRcore.renderStart(() => this.update());
this.loaded();
}
initPage() {
this.loadPage();
this.start();
}
start() {}
loaded() {}
update() {}
}
Three.js项目生成与实现
生成一个Three.js的项目
以下文件展示了一个继承自VRpage类的子类实现。在该类中,重写了start和update方法。start方法负责向场景中添加一个正方体,而update方法则定义了该正方体的变形动画逻辑。动画效果将结合VRcore.js中的renderStart方法共同实现。
// page.js
import * as THREE from 'three';
import VRpage from '../../utils/VRpage.js';
import * as VRcore from '../../utils/VRcore.js';
export default class Page extends VRpage {
start() { // 启动渲染之前,创建场景3d模型
let geometry = new THREE.CubeGeometry(100,100,100);
let material = new THREE.MeshLambertMaterial( { color:0x0000ff} );
this.box = new THREE.Mesh(geometry,material);
this.box.position.set(3, -2, -3);
const PointLight = new THREE.PointLight(0xffffff);
PointLight.position.set(500, 500, 500);
const AmbientLight = new THREE.AmbientLight( 0x404040 ); // soft white light
VRcore.Scene.add(PointLight);
VRcore.Scene.add(AmbientLight);
VRcore.Scene.background = new THREE.Color( 0xeeeeee ); // 更改场景背景色
VRcore.Scene.add(this.box);
}
update() {
this.box.rotation.y += 0.01;
}
}
React框架集成
此处开发环境使用的是React框架。
// index.js
import React, { Component } from 'react';
import PropTypes from 'prop-types';
import Page from './Page.js';
class Oho extends Component {
constructor() {
super();
this.init = this.init.bind(this);
}
componentDidMount() {
const dom = document.querySelector('#Oho');
this.init(dom);
}
init(dom) {
const page = new Page({domContainer: dom});
}
render() {
return (
<div className="three-demo">
<canvas id="Oho" ref="camera"></canvas>
</div>
);
}
}
export default Oho;
总结
以上就是本文的全部内容,希望这些内容对您的学习或工作具有参考价值。如有任何疑问,欢迎留言交流,感谢支持。
React 18 新特性解读:并发模式与自动批处理
2026-11-05 15:19:34
UmiJS 快速上手:从零创建项目与目录结构解析
2026-11-05 09:01:18
React 开发常见报错排查:Invalid Hook Call 与 Key 警告
2026-11-03 12:42:51
Next.js 预期错误与未捕获异常的处理策略
2026-10-31 19:36:37
React实现页面状态缓存(keep-alive)的示例代码
2026-10-31 11:10:26







