This commit is contained in:
wgf
2026-03-27 09:02:29 +08:00
parent d9531fc042
commit f777b162c2
13 changed files with 1522 additions and 1414 deletions

101
OOOMAP_RESOURCES.md Normal file
View File

@@ -0,0 +1,101 @@
# ooomap 资源文件说明
## 所需资源文件
本项目使用 ooomap 3D地图库需要以下资源文件才能正常运行
### 1. ooomap 主库文件
- **位置**: `public/lib/ooomap.min.js`
- **说明**: ooomap 核心库文件
- **获取方式**:
- 从 ooomap 官方网站下载: https://www.ooomap.com
- 或从您的 ooomap 项目中复制
### 2. ooomap 日志文件
- **位置**: `public/js/ooomapLog.js`
- **说明**: ooomap 日志记录脚本
- **获取方式**:
- 从 ooomap 官方网站下载
- 或从您的 ooomap 项目中复制
### 3. 医院模型文件
- **位置**: `public/models/hospital/glb/`
- **说明**: 医院建筑的3D模型文件GLB格式
- **获取方式**:
- 从 ooomap 编辑器导出
- 或从您的 ooomap 项目中复制
### 4. 模型数据配置文件
- **位置**: `public/models/hospital/modelsData.json`
- **说明**: 模型数据的配置文件
- **获取方式**:
- 从 ooomap 编辑器导出
- 或从您的 ooomap 项目中复制
## 目录结构
```
public/
├── lib/
│ └── ooomap.min.js # ooomap 核心库
├── js/
│ └── ooomapLog.js # ooomap 日志脚本
├── models/
│ └── hospital/
│ ├── glb/ # 3D模型文件目录
│ │ ├── floor1.glb
│ │ ├── floor2.glb
│ │ └── ...
│ └── modelsData.json # 模型数据配置
├── favicon.ico
├── index.html
└── zhenggui.png
```
## 如何获取资源文件
### 方法1: 从 ooomap 官方获取
1. 访问 ooomap 官方网站: https://www.ooomap.com
2. 注册并登录账户
3. 创建或打开一个项目
4. 导出所需的资源文件
### 方法2: 从现有项目复制
如果您已经有使用 ooomap 的项目,可以直接从该项目中复制所需的资源文件。
### 方法3: 使用 CDN如果可用
某些 ooomap 资源可能通过 CDN 提供,您可以修改组件代码使用 CDN 链接。
## 注意事项
1. **文件路径**: 确保所有文件的路径与代码中的引用路径一致
2. **文件大小**: 3D模型文件可能较大请确保有足够的存储空间
3. **跨域问题**: 如果从外部服务器加载资源,可能需要配置 CORS
4. **版本兼容**: 确保使用的 ooomap 库版本与模型文件兼容
## 故障排除
### 问题: "ooomap主库加载失败"
**解决方案**:
- 检查 `public/lib/ooomap.min.js` 文件是否存在
- 确认文件路径正确
- 检查文件是否损坏
### 问题: "模型加载失败"
**解决方案**:
- 检查 `public/models/hospital/glb/` 目录中的模型文件
- 确认 `modelsData.json` 配置文件存在且格式正确
- 检查模型文件路径是否与配置文件中的路径一致
### 问题: 地图显示空白
**解决方案**:
- 检查浏览器控制台是否有错误信息
- 确认所有必需的资源文件都已正确加载
- 检查网络请求是否成功
## 联系支持
如果您在获取或配置资源文件时遇到问题,可以:
- 访问 ooomap 官方文档: https://www.ooomap.com/docs
- 联系 ooomap 技术支持
- 查看项目 GitHub 仓库的 Issues