129 lines
3.9 KiB
GDScript
129 lines
3.9 KiB
GDScript
extends Node
|
|
## Central Audio Manager singleton (autoload name: "AudioManager").
|
|
##
|
|
## Pre-warms an AudioStreamPlayer pool for UI and game SFX.
|
|
## Provides convenience methods for standard sound effects and
|
|
## automatically hooks UI buttons for tactile click audio feedback.
|
|
|
|
const STREAM_CLICK: AudioStream = preload("res://assets/audio/click.wav")
|
|
const STREAM_COIN: AudioStream = preload("res://assets/audio/coin.wav")
|
|
const STREAM_CHIME: AudioStream = preload("res://assets/audio/chime.wav")
|
|
const STREAM_FANFARE: AudioStream = preload("res://assets/audio/fanfare.wav")
|
|
const STREAM_BELL: AudioStream = preload("res://assets/audio/bell.wav")
|
|
const STREAM_DOOR: AudioStream = preload("res://assets/audio/door_open.wav")
|
|
|
|
const POOL_SIZE: int = 16
|
|
|
|
var _players: Array[AudioStreamPlayer] = []
|
|
var _player_index: int = 0
|
|
|
|
## Number of active AudioStreamPlayers in the pool.
|
|
var pool_size: int:
|
|
get:
|
|
return _players.size()
|
|
|
|
|
|
func _ready() -> void:
|
|
process_mode = Node.PROCESS_MODE_ALWAYS
|
|
_init_pool()
|
|
var tree := get_tree()
|
|
if tree != null:
|
|
tree.node_added.connect(_on_node_added)
|
|
_hook_existing_buttons(tree.root)
|
|
|
|
|
|
func _init_pool() -> void:
|
|
if not _players.is_empty():
|
|
return
|
|
for i in range(POOL_SIZE):
|
|
var player := AudioStreamPlayer.new()
|
|
player.name = "AudioPlayer_%d" % i
|
|
player.bus = "Master"
|
|
add_child(player)
|
|
_players.append(player)
|
|
|
|
|
|
## Play an audio stream on the specified bus with volume and pitch settings.
|
|
func play_sound(stream: AudioStream, bus: String = "Master", volume_db: float = 0.0, pitch_scale: float = 1.0) -> AudioStreamPlayer:
|
|
if stream == null:
|
|
return null
|
|
if _players.is_empty():
|
|
_init_pool()
|
|
|
|
var player: AudioStreamPlayer = _players[_player_index]
|
|
_player_index = (_player_index + 1) % POOL_SIZE
|
|
|
|
if player.playing:
|
|
player.stop()
|
|
|
|
player.stream = stream
|
|
player.bus = bus
|
|
player.volume_db = volume_db
|
|
player.pitch_scale = pitch_scale
|
|
player.play()
|
|
return player
|
|
|
|
|
|
## Play UI button click with subtle random pitch variance.
|
|
func play_click(volume_db: float = 0.0, pitch_variance: float = 0.05) -> AudioStreamPlayer:
|
|
var pitch := 1.0
|
|
if pitch_variance > 0.0:
|
|
pitch += randf_range(-pitch_variance, pitch_variance)
|
|
return play_sound(STREAM_CLICK, "Master", volume_db, pitch)
|
|
|
|
|
|
## Play coin transaction sound (credits / marketplace / payouts).
|
|
func play_coin(volume_db: float = 0.0) -> AudioStreamPlayer:
|
|
return play_sound(STREAM_COIN, "Master", volume_db, 1.0)
|
|
|
|
|
|
## Play chime sound (successful world / chunk save).
|
|
func play_chime(volume_db: float = 0.0) -> AudioStreamPlayer:
|
|
return play_sound(STREAM_CHIME, "Master", volume_db, 1.0)
|
|
|
|
|
|
## Play victory / achievement fanfare.
|
|
func play_fanfare(volume_db: float = 0.0) -> AudioStreamPlayer:
|
|
return play_sound(STREAM_FANFARE, "Master", volume_db, 1.0)
|
|
|
|
|
|
## Play alert bell sound.
|
|
func play_bell(volume_db: float = 0.0) -> AudioStreamPlayer:
|
|
return play_sound(STREAM_BELL, "Master", volume_db, 1.0)
|
|
|
|
|
|
## Play door open transition sound.
|
|
func play_door(volume_db: float = 0.0) -> AudioStreamPlayer:
|
|
return play_sound(STREAM_DOOR, "Master", volume_db, 1.0)
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Universal Tactile UI Click Wiring
|
|
# ---------------------------------------------------------------------------
|
|
|
|
func _on_node_added(node: Node) -> void:
|
|
if node is BaseButton:
|
|
_hook_button(node as BaseButton)
|
|
|
|
|
|
func _hook_existing_buttons(node: Node) -> void:
|
|
if node is BaseButton:
|
|
_hook_button(node as BaseButton)
|
|
for child in node.get_children():
|
|
_hook_existing_buttons(child)
|
|
|
|
|
|
func _hook_button(btn: BaseButton) -> void:
|
|
var callable := Callable(self, "_on_button_pressed").bind(btn)
|
|
if not btn.pressed.is_connected(callable):
|
|
btn.pressed.connect(callable)
|
|
|
|
|
|
func _on_button_pressed(btn: BaseButton) -> void:
|
|
if not is_instance_valid(btn):
|
|
return
|
|
if btn.is_in_group("no_click_sound"):
|
|
return
|
|
if btn.is_visible_in_tree() and not btn.disabled:
|
|
play_click()
|