SuperAPI AI 工具集

godot-audio

通用与其它

查看项目

更新于 10-15 21:49

技能介绍

用途:在 Godot 4.7 中播放音效与音乐、把声音路由到总线(Master/Music/SFX)、用代码调节音量与静音、添加总线效果(混响、压缩器)、实现 3D 定位音频,以及让事件与音乐节拍同步。不适用于与引擎无关的音频设计(自适应音乐结构、混音理念、闪避模式)或 Godot 之外的素材导入与编码。

主要能力与用法:按需求选择播放节点——AudioStreamPlayer 用于非定位声音(音乐、UI、全局音效),AudioStreamPlayer2D/3D 用于定位声音,音量与声像随距离变化。为 stream 指定音频流(音乐/循环用 .ogg,短音效用 .wav)并调用 play(),音乐可设 autoplay。把播放器的 bus 设为命名总线(如 Music、SFX),总线在底部 Audio 面板中定义,可设音量、静音、独奏与效果。音量以分贝而非线性值控制:0 dB 不变,-80 dB 近似静音,用 linear_to_db/db_to_linear 转换;通过 AudioServer 按总线索引调节音量与静音。节奏同步时,用 get_playback_position() 加上 get_time_since_last_mix() 再减去 get_output_latency() 获得更精确的播放时间。

常见模式:一次性音效可随机微调 pitch_scale 后 play();大量重叠副本可用 AudioStreamPolyphonic 或短生命周期播放器并在 finished 时释放;音乐交叉淡入淡出可用 Tween 同时淡出与淡入两条轨道。

限制与注意:volume_db 是分贝,设 0.5 接近满音量而非一半;linear_to_db(0.0) 为 -inf,转换前需钳制最小值或对 0 单独静音处理;总线名拼写错误会静默失败(get_bus_index 返回 -1);同一播放器重复触发会截断短音效;音乐需在导入或流上启用循环才会循环;仅用 get_playback_position() 同步会有抖动;3D 音频无声可能因缺少 AudioListener3D/Camera3D、距离衰减过紧或总线被静音。更多总线布局、效果、闪避、复音/交互流、麦克风采集与程序化音频见其参考文档。