首次提交: 时间囚笼游戏完整版本

- 实现了完整的Android游戏框架 (Kotlin + Jetpack Compose)
- 科技暗黑风格UI设计与终端风格界面组件
- 完整的故事系统 (主线+支线剧情)
- 固定底部操作区布局,解决选择按钮可见性问题
- 集成Gemini AI智能对话支持
- 游戏状态管理与存档系统
- 动态天气系统与角色状态跟踪
- 支持离线游戏,兼容Android 11+
This commit is contained in:
2025-08-22 10:07:03 -07:00
commit 514ed09825
111 changed files with 10753 additions and 0 deletions

230
Audio/AUDIO_REQUIREMENTS.md Normal file
View File

@@ -0,0 +1,230 @@
# 🎵 音频资源需求清单
## 项目概述
为《月球时间囚笼》游戏创建完整的音频系统包括背景音乐、环境音效、UI音效等。
## 🎼 背景音乐 (Background Music)
### 1. **ambient_mystery.mp3** - 神秘氛围
- **用途**: 初始探索和谜题解决
- **风格**: 神秘、空灵、科幻
- **时长**: 3-5分钟 (可循环)
- **乐器**: 合成器垫音、弦乐、轻微的电子音效
- **情绪**: 宁静但带有紧张感
### 2. **electronic_tension.mp3** - 电子紧张
- **用途**: 危险场景、实验室探索
- **风格**: 电子、工业、紧张
- **时长**: 2-4分钟 (可循环)
- **乐器**: 合成器、鼓机、失真效果
- **情绪**: 紧张、急迫、不安
### 3. **orchestral_revelation.mp3** - 管弦乐启示
- **用途**: 重大发现、剧情高潮
- **风格**: 史诗级管弦乐、电影配乐风格
- **时长**: 4-6分钟 (可循环)
- **乐器**: 完整管弦乐队、合唱团
- **情绪**: 壮观、启发性、情感充沛
### 4. **epic_finale.mp3** - 史诗终章
- **用途**: 游戏结局
- **风格**: 史诗、情感、解脱
- **时长**: 3-5分钟 (不循环)
- **乐器**: 管弦乐、钢琴、人声
- **情绪**: 感人、解脱、希望
## 🌟 环境音效 (Ambient Sounds)
### 5. **ventilation_soft.mp3** - 轻柔通风
- **用途**: 基地内部通风系统
- **特点**: 持续的低频嗡鸣
- **时长**: 30-60秒 (可循环)
### 6. **heart_monitor.mp3** - 心率监控
- **用途**: 医疗舱
- **特点**: 有节奏的哔哔声
- **时长**: 10-20秒 (可循环)
### 7. **reactor_hum.mp3** - 反应堆嗡鸣
- **用途**: 实验室、反应堆核心
- **特点**: 深沉的工业嗡鸣声
- **时长**: 30-60秒 (可循环)
### 8. **space_silence.mp3** - 太空寂静
- **用途**: 月球表面
- **特点**: 极为安静的氛围音
- **时长**: 60-120秒 (可循环)
## ⛈️ 天气音效 (Weather Sounds)
### 9. **wind_gentle.mp3** - 微风
- **用途**: 晴朗天气
- **特点**: 轻柔的风声
- **时长**: 30-60秒 (可循环)
### 10. **rain_light.mp3** - 小雨
- **用途**: 小雨、大雨、酸雨
- **特点**: 轻柔的雨声 (不同音量)
- **时长**: 30-60秒 (可循环)
### 11. **storm_cyber.mp3** - 赛博风暴
- **用途**: 电子风暴
- **特点**: 电子干扰声、静电
- **时长**: 30-60秒 (可循环)
### 12. **solar_storm.mp3** - 太阳风暴
- **用途**: 强烈的太阳风暴
- **特点**: 强烈的电磁干扰声
- **时长**: 30-60秒 (可循环)
## 🔘 UI音效 (UI Sounds)
### 13. **button_click.mp3** - 按钮点击
- **用途**: 按钮点击反馈
- **特点**: 清脆、科技感
- **时长**: 0.1-0.3秒
### 14. **notification_beep.mp3** - 通知提示
- **用途**: 通知、提示
- **特点**: 温和的提示音
- **时长**: 0.3-0.8秒
### 15. **error_alert.mp3** - 错误警报
- **用途**: 错误、警告
- **特点**: 紧急、警示性
- **时长**: 0.5-1.0秒
## 🎭 事件音效 (Event Sounds)
### 16. **discovery_chime.mp3** - 发现音效
- **用途**: 发现物品、解锁内容
- **特点**: 正面、鼓励性
- **时长**: 1-2秒
### 17. **time_distortion.mp3** - 时间扭曲
- **用途**: 时间异常事件
- **特点**: 神秘、扭曲的音效
- **时长**: 2-4秒
### 18. **oxygen_leak_alert.mp3** - 氧气泄漏警报
- **用途**: 氧气泄漏紧急情况
- **特点**: 紧急警报声
- **时长**: 1-3秒
## 📋 技术规格
### 音频格式
- **主要格式**: MP3 (Android兼容)
- **备选格式**: OGG Vorbis (更好的压缩)
- **采样率**: 44.1 kHz 或 48 kHz
- **比特率**:
- 音乐: 256-320 kbps
- 音效: 192-256 kbps
- 环境音: 128-192 kbps
### 文件大小建议
- **单个音乐文件**: 最大 10 MB
- **单个音效文件**: 最大 1 MB
- **总音频包大小**: 建议控制在 50 MB 以内
### 循环要求
- 所有标记为"可循环"的音频必须无缝循环
- 循环点应在音频波形的零交叉点
- 避免循环时的爆音或断裂
## 🎨 风格指导
### 整体音乐风格
- **主题**: 赛博朋克科幻
- **色调**: 暗黑、神秘、科技感
- **情感范围**: 从孤独冷漠到紧张刺激再到感人深刻
### 乐器偏好
- **电子乐器**: 合成器、鼓机、采样器
- **传统乐器**: 弦乐、钢琴、管弦乐 (适度使用)
- **效果处理**: 混响、延迟、失真、滤波
### 避免的元素
- 过于欢快或轻松的音乐
- 明显的流行音乐风格
- 过度复杂的旋律
- 突兀的音量变化
## 📁 文件命名规范
所有音频文件应严格按照以下命名:
```
ambient_mystery.mp3
electronic_tension.mp3
orchestral_revelation.mp3
epic_finale.mp3
ventilation_soft.mp3
heart_monitor.mp3
reactor_hum.mp3
space_silence.mp3
wind_gentle.mp3
rain_light.mp3
storm_cyber.mp3
solar_storm.mp3
button_click.mp3
notification_beep.mp3
error_alert.mp3
discovery_chime.mp3
time_distortion.mp3
oxygen_leak_alert.mp3
```
## 🔧 实现说明
音频系统已完全实现,包括:
- ✅ 多轨道并发播放
- ✅ 音量控制和静音
- ✅ 淡入淡出效果
- ✅ 动态场景切换
- ✅ 游戏状态响应
- ✅ 音频焦点管理
- ✅ 性能监控
只需将音频文件放入 `app/src/main/res/raw/` 目录即可自动加载。
## 📊 优先级
### 高优先级 (核心游戏体验)
1. ambient_mystery.mp3
2. electronic_tension.mp3
3. button_click.mp3
4. error_alert.mp3
5. time_distortion.mp3
### 中优先级 (增强体验)
6. orchestral_revelation.mp3
7. ventilation_soft.mp3
8. oxygen_leak_alert.mp3
9. discovery_chime.mp3
10. notification_beep.mp3
### 低优先级 (完整体验)
11. epic_finale.mp3
12. 所有天气音效
13. 其他环境音效
## 🎵 创建建议
### AI音乐生成工具
- **Suno AI**: 适合创建背景音乐
- **Udio**: 适合电子和实验音乐
- **AIVA**: 适合管弦乐作品
### 免费资源库
- **Freesound.org**: 音效和环境音
- **OpenGameArt.org**: 游戏音频资源
- **Zapsplat**: 专业音效库 (需注册)
### 音频编辑工具
- **Audacity**: 免费开源音频编辑器
- **Reaper**: 专业DAW (60天试用)
- **Logic Pro**: Mac平台专业工具
---
**注意**: 所有音频文件都应该是原创或使用免费/开源许可,避免版权问题。