15、音频系统

第15章 音频系统

15.1 AudioStreamPlayer 基础

1# AudioStreamPlayer：非位置音频（BGM、UI音效）
2# AudioStreamPlayer2D：2D 位置音频（距离衰减）
3# AudioStreamPlayer3D：3D 位置音频
4
5extends AudioStreamPlayer
6
7func _ready() -> void:
8    stream = preload("res://audio/bgm/battle_theme.ogg")
9    volume_db = -10  # 音量（分贝）
10    pitch_scale = 1.0
11    autoplay = false
12    bus = "Music"  # 音频总线
13
14func play_bgm() -> void:
15    if not playing:
16        play()
17
18func stop_bgm() -> void:
19    if playing:
20        # 淡出
21        var tween := create_tween()
22        tween.tween_property(self, "volume_db", -40.0, 1.0)
23        await tween.finished
24        stop()
25        volume_db = -10  # 恢复音量
26

15.2 AudioStreamRandomizer（随机音效变体）

1# AudioStreamRandomizer 自动在多个音效中随机选择
2# 避免重复播放同一音效产生机械感
3
4# 设置：
5# 1. 创建 AudioStreamRandomizer 资源
6# 2. 添加多个 AudioStream（如不同的脚步声）
7# 3. 设置 Playback Mode: Random (No Repeat)
8# 4. 设置 Random Pitch: 0.9 ~ 1.1（音高随机变化）
9
10# 代码使用
11extends AudioStreamPlayer2D
12
13func play_footstep() -> void:
14    stream = preload("res://audio/sfx/footstep_randomizer.tres")
15    pitch_scale = randf_range(0.9, 1.1)  # 额外随机
16    play()
17

15.3 音频总线（Audio Bus）

1# 音频总线用于分组控制音量和效果
2# 设置：底部面板 → Audio → Audio Bus
3
4# 推荐总线布局：
5# Bus 0: Master（主音量）
6# Bus 1: Music（背景音乐）
7# Bus 2: SFX（音效）
8# Bus 3: Voice（语音）
9# Bus 4: Ambient（环境音）
10
11# 代码控制
12func set_music_volume(volume_db: float) -> void:
13    var bus_idx := AudioServer.get_bus_index("Music")
14    AudioServer.set_bus_volume_db(bus_idx, volume_db)
15
16func set_sfx_mute(muted: bool) -> void:
17    var bus_idx := AudioServer.get_bus_index("SFX")
18    AudioServer.set_bus_mute(bus_idx, muted)
19
20# 添加音频效果
21func add_reverb_to_sfx() -> void:
22    var bus_idx := AudioServer.get_bus_index("SFX")
23    var reverb := AudioEffectReverb.new()
24    reverb.room_size = 0.8
25    reverb.damping = 0.5
26    AudioServer.add_bus_effect(bus_idx, reverb)
27

15.4 位置音频（AudioStreamPlayer2D）

1extends AudioStreamPlayer2D
2
3func _ready() -> void:
4    # 距离衰减设置
5    max_distance = 500.0  # 超过这个距离听不到
6    # attenuation 属性在 Godot 4.x 中通过衰减曲线控制
7    # 默认使用反距离衰减
8
9# 爆炸音效（在特定位置播放）
10func play_explosion_sound(pos: Vector2) -> void:
11    var sound := AudioStreamPlayer2D.new()
12    sound.stream = preload("res://audio/sfx/explosion.wav")
13    sound.global_position = pos
14    sound.max_distance = 800.0
15    add_child(sound)
16    sound.play()
17    sound.finished.connect(sound.queue_free)
18

15.5 动态音乐系统

1extends Node
2
3@onready var exploration_player: AudioStreamPlayer = $ExplorationMusic
4@onready var combat_player: AudioStreamPlayer = $CombatMusic
5
6var is_in_combat: bool = false
7var crossfade_duration: float = 2.0
8
9func enter_combat() -> void:
10    if is_in_combat:
11        return
12    is_in_combat = true
13    
14    # 交叉渐变
15    combat_player.volume_db = -40
16    combat_player.play()
17    
18    var tween := create_tween().set_parallel(true)
19    tween.tween_property(exploration_player, "volume_db", -40, crossfade_duration)
20    tween.tween_property(combat_player, "volume_db", 0, crossfade_duration)
21
22func exit_combat() -> void:
23    if not is_in_combat:
24        return
25    is_in_combat = false
26    
27    var tween := create_tween().set_parallel(true)
28    tween.tween_property(combat_player, "volume_db", -40, crossfade_duration)
29    tween.tween_property(exploration_player, "volume_db", 0, crossfade_duration)
30    await tween.finished
31    combat_player.stop()
32

15.6 对话语音

1extends RichTextLabel
2
3@export var voice_stream: AudioStreamPlayer
4
5var is_typing: bool = false
6var typing_speed: float = 0.03  # 每个字符的时间
7
8func show_dialogue(text: String, voice: AudioStream = null) -> void:
9    visible_characters = 0
10    self.text = text
11    is_typing = true
12    
13    if voice and voice_stream:
14        voice_stream.stream = voice
15        voice_stream.play()
16    
17    for i in text.length():
18        if not is_typing:
19            break
20        visible_characters = i + 1
21        await get_tree().create_timer(typing_speed).timeout
22    
23    visible_characters = -1  # 显示全部
24    is_typing = false
25
26func skip_typing() -> void:
27    is_typing = false
28    visible_characters = -1
29

《15、音频系统》 是转载文章，点击查看原文。