非遗声景漫游馆 - 用户使用文档
项目简介
非遗声景漫游馆是一个融合「听觉 + 视觉 + 互动」的非遗文化沉浸体验网页项目。通过现代Web技术，让用户能够可听、可看、可玩、可分享地体验中国非物质文化遗产。
快速开始
系统要求
- 操作系统: Windows 10/11, macOS 10.14+, Linux
- 浏览器: Chrome 70+, Firefox 65+, Safari 12+, Edge 79+
- 网络: 需要网络连接加载外部资源
- 音频: 需要扬声器或耳机
启动方式
方式一：直接打开（推荐）
- 双击
index.html文件 - 浏览器自动打开项目页面
- 等待加载动画完成
方式二：本地服务器启动
- 打开命令行工具
- 进入项目目录
- 运行命令：
node server.js - 浏览器访问：
http://localhost:3000
功能模块详解
1. 首页概览
功能特色
- 精美的加载动画效果
- 六大非遗模块快速入口
- 响应式设计适配各种设备
操作指南
- 点击任意模块卡片进入对应功能
- 使用顶部导航栏切换不同模块
- 右上角可控制背景音乐开关
2. 皮影戏模块 🎭
核心功能
- 皮影控制: 控制皮影人物动作
- 故事播放: 播放预设皮影故事
- 剧本创作: 创作个性化皮影剧本
操作步骤
-
控制皮影动作
- 点击"挥手"按钮：皮影人物挥手示意
- 点击"转身"按钮：皮影人物转身动作
- 点击"鞠躬"按钮：皮影人物鞠躬行礼
-
播放皮影故事
- 点击"播放故事"按钮
- 观看皮影人物自动表演
- 故事结束后可重新播放
-
剧本创作
- 在剧本编辑器中输入故事内容
- 选择不同角色和场景
- 保存并播放自定义剧本
3. 榫卯工艺模块 ⚒️
核心功能
- 拼图游戏: 拖拽式榫卯拼图
- 口诀学习: 匠人口诀展示
- 成就系统: 完成度检测
操作步骤
-
拼图游戏
- 选择要拼装的榫卯结构类型
- 拖拽木块到正确位置
- 系统自动检测拼装正确性
-
学习匠人口诀
- 查看每种榫卯结构的传统口诀
- 理解古代工匠的智慧结晶
- 通过口诀记忆结构特点
-
成就解锁
- 完成所有拼图解锁成就
- 查看完成度统计
- 分享成就到社区
4. 油纸伞模块 ☂️
核心功能
- 制作流程: 四步制作动画展示
- 工艺介绍: 详细工艺说明
- 交互展示: 步骤高亮切换
操作步骤
-
了解制作流程
- 点击不同步骤查看详细说明
- 观看制作过程动画演示
- 了解传统油纸伞工艺
-
交互学习
- 鼠标悬停查看工艺细节
- 点击步骤按钮切换展示
- 跟随动画学习制作技巧
5. 昆曲模块 🎵
核心功能
- 经典选段: 三大经典昆曲选段
- 唱词显示: 动态唱词同步
- 声景体验: 多感官沉浸体验
操作步骤
-
欣赏昆曲
- 选择想要欣赏的昆曲选段
- 点击播放按钮开始欣赏
- 观看动态显示的唱词
-
声景体验
- 感受传统昆曲的韵律美
- 结合视觉元素增强体验
- 了解昆曲的历史背景
6. 互动创作模块 🎨
核心功能
- 皮影创作: 个性化皮影设计
- 榫卯设计: 虚拟榫卯结构设计
- 诗词游戏: 传统文化诗词接龙
操作步骤
-
皮影创作
- 选择皮影角色和服饰
- 设计动作序列
- 保存创作作品
-
榫卯设计
- 选择木材类型和结构
- 虚拟拼装榫卯结构
- 学习结构力学原理
-
诗词游戏
- 参与诗词接龙游戏
- 根据提示填写诗句
- 学习传统文化知识
7. 分享社区模块 🌟
核心功能
- 作品分享: 用户创作作品展示
- 社区互动: 点赞评论功能
- 画廊浏览: 社区作品欣赏
操作步骤
-
分享作品
- 上传在互动模块创作的作品
- 添加作品描述和标签
- 发布到社区画廊
-
社区互动
- 浏览其他用户的作品
- 为喜欢的作品点赞
- 留言交流创作心得
音频功能使用
背景音乐控制
- 开启/关闭: 点击右上角"🎵 背景音乐"按钮
- 音量调节: 使用系统音量控制
- 自动播放: 页面加载后自动播放背景音乐
音效体验
- 皮影音效: 皮影动作伴随传统音效
- 榫卯音效: 拼图成功有反馈音效
- 昆曲音频: 高质量昆曲选段播放
交互技巧
鼠标操作
- 点击: 选择功能、播放动画
- 拖拽: 拼图游戏、元素移动
- 悬停: 查看详细信息、提示
触摸屏操作（移动设备）
- 轻点: 相当于鼠标点击
- 滑动: 页面滚动、元素拖拽
- 长按: 显示更多选项
常见问题解答
Q: 页面加载缓慢怎么办？
A: 请检查网络连接，或尝试刷新页面。首次加载需要下载资源文件。
Q: 音频无法播放？
A: 请检查浏览器是否允许音频自动播放，或点击页面任意位置激活音频权限。
Q: 拼图游戏无法拖拽？
A: 请确保使用支持HTML5拖放功能的现代浏览器。
Q: 如何保存我的创作？
A: 在互动创作模块完成作品后，点击"保存"按钮即可保存到本地。
Q: 社区功能需要登录吗？
A: 当前版本为演示版本，社区功能为模拟实现，无需登录。
浏览器兼容性
推荐浏览器
- Google Chrome (最佳体验)
- Mozilla Firefox
- Microsoft Edge
- Safari (macOS/iOS)
已知限制
- Internet Explorer 不支持部分功能
- 旧版本浏览器可能无法正常显示动画
- 移动设备Safari对音频自动播放有限制
故障排除
页面显示异常
- 清除浏览器缓存
- 刷新页面重新加载
- 尝试使用其他浏览器
音频问题
- 检查设备音量设置
- 确认浏览器音频权限
- 尝试点击页面激活音频
功能无法使用
- 检查浏览器版本是否过旧
- 确认JavaScript已启用
- 查看浏览器控制台错误信息
技术支持
如遇到无法解决的问题，请：
- 记录问题发生的具体情况
- 截图保存错误信息
- 联系技术支持团队
文档版本: 1.0
最后更新: 2025-12-28
维护者: 项目开发团队