### Godot 中使用 AudioStreamPlayer 播放音效的示例 在 Godot 引擎中，`AudioStreamPlayer` 是用于播放音效的核心节点之一。通过 GDScript 编写脚本可以灵活控制音效的播放逻辑。以下是实现 `AudioStreamPlayer` 播放音效的具体方法。 #### 场景结构 为了演示方便，假设场景中有以下节点： - **Root Node**: `Spatial` 或 `Node2D` - **AudioStreamPlayer**: 子节点，命名为 `AudioStreamPlayer` #### 示例代码 ```gdscript extends Spatial var audio_player: AudioStreamPlayer func _ready(): # 获取 AudioStreamPlayer 节点 audio_player = $AudioStreamPlayer # 设置要播放的音频文件 (预加载资源) audio_player.stream = preload("res://sounds/example_sound.ogg") # 连接自定义信号或其他事件触发器 connect("custom_event", self, "_on_custom_event") func play_sound(): """ 播放音效 """ if audio_player.is_playing(): audio_player.stop() audio_player.play() func _on_custom_event(): """ 当 custom_event 信号被触发时调用此函数 """ play_sound() ``` 以上代码展示了如何初始化 `AudioStreamPlayer` 并绑定其行为[^1]。具体功能如下： 1. **获取节点**：通过 `$AudioStreamPlayer` 访问子节点。 2. **设置音频流**：利用 `preload()` 方法加载音频文件并赋值给 `stream` 属性。 3. **播放控制**：提供了一个 `play_sound()` 函数，在必要时停止当前正在播放的声音再重新启动新声音。 4. **信号连接**：可以通过信号机制动态触发音效播放[^3]。 如果希望更复杂的功能比如调整音量或者淡入淡出效果，则可扩展脚本逻辑[^2]: ```gdscript func fade_in(duration: float): """ 实现淡入效果 """ var current_volume = audio_player.volume_db while current_volume < 0: current_volume += duration / abs(current_volume) audio_player.volume_db = clamp(current_volume, -80, 0) yield(get_tree().create_timer(0.05), "timeout") func set_volume(volume_level: float): """ 手动设定音量 (-80 到 0 的范围)""" audio_player.volume_db = volume_level ``` 这些额外的方法允许开发者进一步定制用户体验。 ---