102 lines
3.1 KiB
Markdown
102 lines
3.1 KiB
Markdown
# 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
|