1.1 KiB
1.1 KiB
快速开始
面向 Web 场景的三维展示与互动 SDK，提供相机、灯光、环境贴图、热点、模型热更新与材质切换等能力。
安装
npm install your-web3d-sdk
初始化 Viewer
import { createViewer } from 'your-web3d-sdk'
const sdk = await createViewer({
container: '#viewer',
assetsBase: '/assets',
background: '#0f172a',
})
// 加载初始场景或模型
await sdk.model.load({ id: 'scene', url: '/models/showroom.glb' })
基础生命周期
- 初始化 viewer：
createViewer({ container }) - 加载模型或场景：
sdk.model.load(...) - 设置环境贴图/灯光：
sdk.environment.setHDRI(...)、sdk.lights.update(...) - 渲染热点：
sdk.hotspot.render(config.hotspots) - 订阅事件：
sdk.on('hotspot:click', handler) - 按需调用相机/材质/模型热更新 API
调试建议
- 启用
sdk.debug(true)查看加载、事件、帧率等日志。 - 逐步应用配置：先确认相机与灯光，再添加环境贴图与热点，最后再做材质/模型热更新。
- 热更新前后记录 ID/实例，避免重复销毁或遗漏解绑事件。