132 lines
3.6 KiB
GDScript
132 lines
3.6 KiB
GDScript
extends Node
|
|
|
|
## 简单背景音乐播放器
|
|
## 自动加载指定文件夹的音乐文件，支持顺序和随机循环播放
|
|
|
|
# 播放模式
|
|
enum PlayMode {
|
|
SEQUENTIAL, # 顺序循环
|
|
RANDOM # 随机循环
|
|
}
|
|
|
|
# 配置
|
|
@export var music_folder: String = "res://assets/音乐/" # 音乐文件夹路径
|
|
@export var play_mode: PlayMode = PlayMode.SEQUENTIAL # 播放模式
|
|
@export var auto_start: bool = true # 自动开始播放
|
|
|
|
# 内部变量
|
|
var audio_player: AudioStreamPlayer
|
|
var music_files: Array[String] = []
|
|
var current_index: int = 0
|
|
var played_indices: Array[int] = [] # 随机模式已播放的索引
|
|
|
|
func _ready():
|
|
# 创建音频播放器
|
|
audio_player = AudioStreamPlayer.new()
|
|
add_child(audio_player)
|
|
audio_player.finished.connect(_on_music_finished)
|
|
|
|
# 加载音乐文件
|
|
_load_music_files()
|
|
|
|
# 自动开始播放
|
|
if auto_start and music_files.size() > 0:
|
|
play_next()
|
|
|
|
func _load_music_files():
|
|
"""加载指定文件夹下的音乐文件"""
|
|
music_files.clear()
|
|
|
|
var dir = DirAccess.open(music_folder)
|
|
if dir:
|
|
dir.list_dir_begin()
|
|
var file_name = dir.get_next()
|
|
|
|
while file_name != "":
|
|
if not dir.current_is_dir():
|
|
var extension = file_name.get_extension().to_lower()
|
|
# 支持常见音频格式
|
|
if extension in ["mp3", "ogg", "wav"]:
|
|
music_files.append(music_folder + file_name)
|
|
print("加载音乐: ", file_name)
|
|
file_name = dir.get_next()
|
|
|
|
print("总共加载了 ", music_files.size(), " 首音乐")
|
|
else:
|
|
print("无法打开音乐文件夹: ", music_folder)
|
|
|
|
func play_next():
|
|
"""播放下一首音乐"""
|
|
if music_files.size() == 0:
|
|
print("没有音乐文件可播放")
|
|
return
|
|
|
|
# 根据播放模式获取下一首音乐的索引
|
|
match play_mode:
|
|
PlayMode.SEQUENTIAL:
|
|
current_index = (current_index + 1) % music_files.size()
|
|
PlayMode.RANDOM:
|
|
current_index = _get_random_index()
|
|
|
|
# 播放音乐
|
|
_play_music(current_index)
|
|
|
|
func _get_random_index() -> int:
|
|
"""获取随机音乐索引（避免重复直到所有歌曲都播放过）"""
|
|
# 如果所有歌曲都播放过了，重置列表
|
|
if played_indices.size() >= music_files.size():
|
|
played_indices.clear()
|
|
|
|
# 获取未播放的歌曲索引
|
|
var available_indices: Array[int] = []
|
|
for i in range(music_files.size()):
|
|
if i not in played_indices:
|
|
available_indices.append(i)
|
|
|
|
# 随机选择一个
|
|
if available_indices.size() > 0:
|
|
var random_choice = available_indices[randi() % available_indices.size()]
|
|
played_indices.append(random_choice)
|
|
return random_choice
|
|
|
|
return 0
|
|
|
|
func _play_music(index: int):
|
|
"""播放指定索引的音乐"""
|
|
if index < 0 or index >= music_files.size():
|
|
return
|
|
|
|
var music_path = music_files[index]
|
|
var audio_stream = load(music_path)
|
|
|
|
if audio_stream:
|
|
audio_player.stream = audio_stream
|
|
audio_player.play()
|
|
print("正在播放: ", music_path.get_file())
|
|
else:
|
|
print("加载音乐失败: ", music_path)
|
|
|
|
func _on_music_finished():
|
|
"""音乐播放完成时自动播放下一首"""
|
|
play_next()
|
|
|
|
# 公共接口方法
|
|
func set_play_mode(mode: PlayMode):
|
|
"""设置播放模式"""
|
|
play_mode = mode
|
|
played_indices.clear() # 重置随机播放历史
|
|
print("播放模式设置为: ", "顺序循环" if mode == PlayMode.SEQUENTIAL else "随机循环")
|
|
|
|
func toggle_play_mode():
|
|
"""切换播放模式"""
|
|
if play_mode == PlayMode.SEQUENTIAL:
|
|
set_play_mode(PlayMode.RANDOM)
|
|
else:
|
|
set_play_mode(PlayMode.SEQUENTIAL)
|
|
|
|
func get_current_music_name() -> String:
|
|
"""获取当前播放的音乐名称"""
|
|
if current_index >= 0 and current_index < music_files.size():
|
|
return music_files[current_index].get_file()
|
|
return ""
|