自托管查看器
Viewer 开源,可从编辑器直接导出,替代或补充平台发布。现代浏览器可运行,含易用相机控制,在支持 WebXR 的设备上可 AR/VR 查看。
导出 HTML 查看器
步骤:
- File > Export。
- 选择 Viewer App…。
- Location 选目录,Filename 填名称,配置后点击 Export。目录会记住;不支持 File System Access API 的浏览器改为下载。
导出过程在 GPU 压缩 SOG,大场景需稍候。
导出选项
可配置:

| 选项 | 说明 |
|---|---|
| Export Type | HTML:SOG 压缩后 Base64 嵌入单文件,可通过 file:// 双击运行,便于分享。但编码令体积比 ZIP 约大 30%,浏览器大小限制各异,32MB 以下通常可加载,更大可能有问题。 ZIP Package:包含 index.html、index.js、index.css、settings.json 与 index.sog。更小、加载更快,但需 http://,可使用 Node serve 或 Python http.server(python -m http.server)。 |
| Animation | 包含并自动播放时间轴动画,仅有关键帧时可用且默认启用。 |
| Loop Mode | None 播一次;Repeat 循环;Ping Pong 往返。按时间轴 Loop 初始化,开启为 Repeat,否则 None。 |
| Background | 默认编辑器 Appearance 的背景色。 |
| Field of View | 垂直视野角,度,默认当前相机值。 |
| SH Bands | 导出包含的球谐阶数。 |
初始相机是导出时当前视口姿态,因此先取好视角。
Web 托管
可将导出文件托管,简单选项为 GitHub Pages:
-
在 GitHub 新建仓库。
-
添加 HTML,或 ZIP 解压后的 index.html、index.sog、index.js、index.css、settings.json。
-
Settings → Pages,将 Source 设为 Deploy from a branch,Branch 选 main,点击 Save。
-
稍候发布,URL 为:
https://<github-username>.github.io/<repository-name>/<html-filename>