@tool
class_name VibeSfx
extends Node

## VibeSfx.gd
## 场景中的环境音效控制器节点（“遥控器”）。
## 你可以将此节点放置在任何场景中，用于配置和触发不同的 VibeGroup。
## 它通过调用全局的 VibeManager 来实现功能。

# VibeGroup 库。使用字典可以方便地通过名称（如 "default", "battle"）来引用不同的音轨组。
# 你可以在 Inspector 中配置这个字典，将名称映射到 VibeGroup.tres 资源文件。
@export var vibe_groups: Dictionary[String, VibeGroup] = {"default": null}

# 当此节点进入场景树时，是否自动播放指定的 VibeGroup。
@export var autoplay: bool = true

const autoplay_group_name := &"default"


func _ready():
	# 仅在游戏运行时执行
	if Engine.is_editor_hint():
		return

	if autoplay:
		if vibe_groups.has(autoplay_group_name):
			switch_to(autoplay_group_name)
		else:
			printerr(
				(
					"VibeSfx: Autoplay group '%s' not found in vibe_groups dictionary."
					% autoplay_group_name
				)
			)


## 公共方法：切换到指定的 VibeGroup。
## 可以在其他脚本（如过场动画控制器、区域触发器）中调用此方法。
## example: $VibeSfx.switch_to("event_1_vibe")
func switch_to(group_name: StringName):
	if vibe_groups.has(group_name):
		var group_resource: VibeGroup = vibe_groups[group_name]
		if is_instance_valid(group_resource):
			AudioManager.play_group(group_resource)
		else:
			printerr("VibeSfx: Resource for group '%s' is null or invalid." % group_name)
	else:
		printerr("VibeSfx: Group name '%s' not found." % group_name)


## 公共方法：停止所有由 VibeManager 控制的环境音。
func stop():
	AudioManager.stop_all()