Fisrt version
This commit is contained in:
215
Audio/scripts/quick_audio_setup.py
Executable file
215
Audio/scripts/quick_audio_setup.py
Executable file
@@ -0,0 +1,215 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
快速音频设置脚本
|
||||
为游戏创建音频文件 - 组合了下载和占位文件创建
|
||||
"""
|
||||
|
||||
import os
|
||||
import requests
|
||||
import time
|
||||
from pathlib import Path
|
||||
|
||||
TARGET_DIR = "app/src/main/res/raw"
|
||||
|
||||
# 可靠的免费音频下载链接
|
||||
RELIABLE_DOWNLOADS = {
|
||||
# 从 opengameart.org 和其他可靠的免费资源
|
||||
"button_click.mp3": "https://opengameart.org/sites/default/files/button-09.wav",
|
||||
"notification_beep.mp3": "https://opengameart.org/sites/default/files/notification.wav",
|
||||
"error_alert.mp3": "https://opengameart.org/sites/default/files/error.wav",
|
||||
"discovery_chime.mp3": "https://opengameart.org/sites/default/files/pickup.wav",
|
||||
}
|
||||
|
||||
# 无法下载的文件将创建占位符
|
||||
ALL_AUDIO_FILES = [
|
||||
("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", "按钮点击音效 - UI反馈"),
|
||||
("notification_beep.mp3", "通知提示音 - 系统通知"),
|
||||
("error_alert.mp3", "错误警报音 - 错误提示"),
|
||||
("discovery_chime.mp3", "发现音效 - 物品发现"),
|
||||
("time_distortion.mp3", "时间扭曲音效 - 特殊事件"),
|
||||
("oxygen_leak_alert.mp3", "氧气泄漏警报 - 紧急情况"),
|
||||
]
|
||||
|
||||
def create_directories():
|
||||
"""创建必要的目录"""
|
||||
Path(TARGET_DIR).mkdir(parents=True, exist_ok=True)
|
||||
print(f"📁 目录已准备: {TARGET_DIR}")
|
||||
|
||||
def try_download(url, filename):
|
||||
"""尝试下载文件"""
|
||||
file_path = Path(TARGET_DIR) / filename
|
||||
|
||||
if file_path.exists():
|
||||
print(f"✅ 已存在: {filename}")
|
||||
return True
|
||||
|
||||
print(f"⬇️ 尝试下载: {filename}")
|
||||
|
||||
try:
|
||||
headers = {'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36'}
|
||||
response = requests.get(url, headers=headers, timeout=10, stream=True)
|
||||
|
||||
if response.status_code == 200:
|
||||
with open(file_path, 'wb') as f:
|
||||
for chunk in response.iter_content(chunk_size=8192):
|
||||
if chunk:
|
||||
f.write(chunk)
|
||||
print(f"✅ 下载成功: {filename}")
|
||||
return True
|
||||
else:
|
||||
print(f"❌ 下载失败: {filename} (HTTP {response.status_code})")
|
||||
return False
|
||||
|
||||
except Exception as e:
|
||||
print(f"❌ 下载错误: {filename} - {e}")
|
||||
return False
|
||||
|
||||
def create_audio_placeholder(filename, description):
|
||||
"""创建音频占位文件"""
|
||||
file_path = Path(TARGET_DIR) / filename
|
||||
|
||||
if file_path.exists():
|
||||
return
|
||||
|
||||
# 创建一个简单的文本占位文件
|
||||
placeholder_content = f"""AUDIO PLACEHOLDER FILE
|
||||
音频占位文件
|
||||
|
||||
文件名: {filename}
|
||||
描述: {description}
|
||||
|
||||
这是一个占位文件，用于测试音频系统架构。
|
||||
要获得完整的游戏体验，请下载真实的音频文件。
|
||||
|
||||
推荐下载网站:
|
||||
1. https://pixabay.com/sound-effects/ (免费，无需注册)
|
||||
2. https://freesound.org/ (免费，需注册)
|
||||
3. https://opengameart.org/ (开源游戏音频)
|
||||
|
||||
下载后，请将文件重命名为: {filename}
|
||||
并放置在目录: {TARGET_DIR}/
|
||||
|
||||
提示: 运行 ./audio_rename.sh 可以自动重命名下载的文件
|
||||
"""
|
||||
|
||||
try:
|
||||
with open(file_path, 'w', encoding='utf-8') as f:
|
||||
f.write(placeholder_content)
|
||||
print(f"📄 占位符已创建: {filename}")
|
||||
except Exception as e:
|
||||
print(f"❌ 创建占位符失败: {filename} - {e}")
|
||||
|
||||
def create_download_instructions():
|
||||
"""创建下载说明文件"""
|
||||
instructions_file = Path(TARGET_DIR) / "README_AUDIO.txt"
|
||||
|
||||
instructions = """音频文件下载说明
|
||||
=================
|
||||
|
||||
本目录包含游戏所需的 18 个音频文件。
|
||||
|
||||
当前状态:
|
||||
- ✅ 部分文件可能已通过脚本自动下载
|
||||
- 📄 其他文件为占位符，需要手动下载替换
|
||||
|
||||
手动下载步骤:
|
||||
1. 访问 https://pixabay.com/sound-effects/
|
||||
2. 搜索对应的音效类型 (例如: "button click", "ambient space")
|
||||
3. 下载 MP3 格式的音频文件
|
||||
4. 重命名为对应的文件名 (如 button_click.mp3)
|
||||
5. 替换本目录中的占位符文件
|
||||
|
||||
自动化工具:
|
||||
- 运行 ../../../audio_rename.sh 自动重命名下载的文件
|
||||
- 查看 ../../../AUDIO_DOWNLOAD_GUIDE.md 获取详细下载指南
|
||||
|
||||
测试音频系统:
|
||||
即使使用占位文件，游戏的音频系统也能正常运行，
|
||||
这样你就可以先测试功能，稍后再添加真实音频。
|
||||
|
||||
编译游戏:
|
||||
cd ../../../
|
||||
./gradlew assembleDebug
|
||||
|
||||
下载完成后，游戏将拥有完整的音频体验！
|
||||
"""
|
||||
|
||||
try:
|
||||
with open(instructions_file, 'w', encoding='utf-8') as f:
|
||||
f.write(instructions)
|
||||
print(f"📖 说明文件已创建: {instructions_file.name}")
|
||||
except Exception as e:
|
||||
print(f"❌ 创建说明文件失败: {e}")
|
||||
|
||||
def main():
|
||||
"""主函数"""
|
||||
print("🎵 快速音频设置工具")
|
||||
print("=" * 40)
|
||||
print("🎯 目标: 为游戏设置完整的音频文件集")
|
||||
print("💡 策略: 下载 + 占位符 = 立即可测试")
|
||||
print()
|
||||
|
||||
# 创建目录
|
||||
create_directories()
|
||||
|
||||
# 尝试下载可靠的文件
|
||||
print("⬇️ 尝试下载可用的音频文件...")
|
||||
download_count = 0
|
||||
for filename, url in RELIABLE_DOWNLOADS.items():
|
||||
if try_download(url, filename):
|
||||
download_count += 1
|
||||
time.sleep(1) # 避免请求过频
|
||||
|
||||
print(f"\n📊 下载统计: {download_count}/{len(RELIABLE_DOWNLOADS)} 个文件成功下载")
|
||||
|
||||
# 为所有文件创建占位符（如果不存在）
|
||||
print(f"\n📄 创建完整的音频文件集 ({len(ALL_AUDIO_FILES)} 个文件)...")
|
||||
for filename, description in ALL_AUDIO_FILES:
|
||||
create_audio_placeholder(filename, description)
|
||||
|
||||
# 创建说明文件
|
||||
create_download_instructions()
|
||||
|
||||
# 检查结果
|
||||
audio_files = list(Path(TARGET_DIR).glob("*"))
|
||||
print(f"\n📂 音频目录文件总数: {len(audio_files)}")
|
||||
|
||||
# 最终说明
|
||||
print("\n🎉 音频设置完成！")
|
||||
print("\n✅ 你现在可以:")
|
||||
print(" 1. 立即编译并测试: ./gradlew assembleDebug")
|
||||
print(" 2. 音频系统界面将正常显示")
|
||||
print(" 3. 所有音频功能都可以测试")
|
||||
|
||||
print("\n🎵 要获得完整音频体验:")
|
||||
print(" 1. 访问 https://pixabay.com/sound-effects/")
|
||||
print(" 2. 下载对应类型的音频文件")
|
||||
print(" 3. 使用 ./audio_rename.sh 自动重命名")
|
||||
print(" 4. 或查看 AUDIO_DOWNLOAD_GUIDE.md 详细指南")
|
||||
|
||||
if download_count > 0:
|
||||
print(f"\n🎊 已有 {download_count} 个真实音频文件!")
|
||||
|
||||
print(f"\n📁 音频文件位置: {TARGET_DIR}/")
|
||||
print("🔧 占位符确保系统正常运行，真实音频提升体验")
|
||||
|
||||
if __name__ == "__main__":
|
||||
try:
|
||||
main()
|
||||
except KeyboardInterrupt:
|
||||
print("\n⏹️ 设置中断")
|
||||
except Exception as e:
|
||||
print(f"\n💥 设置错误: {e}")
|
||||
print("请检查目录权限和网络连接")
|
||||
Reference in New Issue
Block a user