项目介绍
这是一个围绕中药资料浏览与交互展示的 UE 项目。展示端将药材检索、文字介绍、图片、语音、三维模型和显微切片组织到同一套浏览流程中；配套资料管理工具用于维护药材与切片记录，以及相关媒体素材。
用户可以按类别或名称查找药材，查看选中内容的图文和模型，再进入切片内容观察不同倍率的图像。我的工作集中在交互程序、数据组织、资源加载和资料维护工具，药材知识、模型与图片等内容素材的制作不计入个人开发成果。
项目组成与个人职责
| 部分 | 面向的使用者 | 我负责的内容 |
|---|---|---|
| 交互展示端 | 资料浏览与展览体验的用户 | 检索、分类选择、图文语音展示、模型切换和切片浏览 |
| 数据与资源层 | 展示端与维护工具 | 药材、分类、地区、切片和媒体资源的组织与读取 |
| 外部资料工具 | 内容维护人员 | 记录新增与编辑、媒体导入、格式检查和保存 |
我负责的功能
药材检索与分类浏览
整理药材数据、分类和地区等查询接口，根据当前选择为界面提供对应内容。用户按类别或名称查找时，展示端读取相关资料，再组织介绍、图片、语音和模型。
数据查询与场景表现分开，使资料选择和具体展示各有职责。内置资料与外部补充内容可以进入统一的浏览列表。
图文、语音与多模型展示
接入图片、音频和多模型资料，按选中内容组织展示资源，并处理相关资源的异步预加载。药材模型按配置顺序切换，展示逻辑使用当前记录的媒体配置，不将所有内容写死在同一套场景表现中。
显微切片浏览
整理切片记录与倍率图像之间的关系，提供 4×、10×、40× 等实际配置倍率下的图像切换。切片展示以对应记录和素材为基础，倍率选项与具体图像保持关联。
外部资料维护
配套资料管理工具支持新增、编辑药材与切片记录，并导入和校验图片、音频及模型。维护人员更新并保存资料后，重启展示程序即可读取最新内容。
支持的素材包括 PNG、JPG、JPEG 图片，OGG、WAV、MP3 音频，以及自包含 GLB 模型。素材导入需要符合展示端的格式要求。
解决的难点
一条药材记录关联多种展示资源
药材介绍、图片、语音、模型与切片具有不同的展示方式，仅处理一个文本列表无法覆盖完整浏览需求。
我按资料记录组织媒体关联，再将当前选择交给相应展示逻辑。数据查询、资源准备和场景表现因此可以分别处理，也为同一药材配置多个模型和不同切片图像提供了基础。
内容选择与资源加载需要配合
三维模型、图片和音频不能都按普通文本字段处理，用户选择内容后还需要准备相应资源。我接入相关资源的异步预加载，将资源准备与具体展示配合组织，使资料查询和媒体加载承担各自的职责。
内置资料与外部资料需要共同浏览
展示内容既有程序内置部分，也有通过工具补充的资料。如果两部分各自维护独立的交互入口，用户浏览和后续内容维护都会变得分散。
我将内置和外部内容组织到统一的浏览列表，并保留数据查询与场景表现的分工。维护人员通过外部工具更新记录和资源，展示程序在启动后读取保存内容。
资料维护要同时检查记录与素材
维护工作不仅是增加一个名称，还需要保证图片、音频和模型符合展示程序的读取要求。资料工具因此同时提供记录编辑、素材导入与保存检查，而不是让维护人员只修改一份文本后自行拼接资源。
模型导入使用自包含 GLB；图片和音频也按支持格式检查。这样把内容维护的操作集中到对应工具中，展示端则专注读取与呈现。
资料维护流程
- 新增或选择需要编辑的药材、切片记录，填写相关资料。
- 导入对应图片、音频和自包含 GLB 模型，按内容配置媒体顺序与切片倍率。
- 保存时检查记录及资源，形成展示端能够读取的内容。
- 重启展示程序，查看更新后的浏览列表、模型与切片图像。
实现结果与适用范围
项目将资料查询、多媒体展示、显微切片浏览和外部维护组织到配套流程中。用户在展示端查看内容，维护人员在工具端更新记录与素材，两端通过数据和资源配置衔接。
展示能力以实际配置的内容、倍率图像和支持格式为范围。外部资料更新采用保存后重启读取的方式，不将其描述为运行期间的无缝热更新；药材知识与素材本身也不作为个人开发成果。