Godot引擎：玩家角色行走时音频卡顿问题修复求助

有测试玩家反馈角色行走时出现音频卡顿，仅该玩家遇到此问题，其他测试者及我均无法复现。

原脚步声控制代码 #

func _ready():
    connect("frame_changed", self, "_on_frame_changed")
    

func footstep_grass_audio():
    var footstep_grass_audio_tracks = [
    $"%audio_footstep_grass_0",
    $"%audio_footstep_grass_1",
    $"%audio_footstep_grass_2",
    $"%audio_footstep_grass_3",
    $"%audio_footstep_grass_4",
    ]
    footstep_grass_audio_tracks.shuffle()
    var footstep_grass_audio_track = footstep_grass_audio_tracks[0]
    footstep_grass_audio_track.play()

func footstep_puddle_audio():
    var footstep_puddle_audio_tracks = [
    $"%audio_footstep_puddle_0",
    $"%audio_footstep_puddle_1",
    $"%audio_footstep_puddle_2",
    $"%audio_footstep_puddle_3",
    $"%audio_footstep_puddle_4",
    ]
    footstep_puddle_audio_tracks.shuffle()
    var footstep_puddle_audio_track = footstep_puddle_audio_tracks[0]
    footstep_puddle_audio_track.play()

func _on_frame_changed():
    if Global.current_movement != "bounce" && Global.terrain_type == "land":
        match frame:
            0, 1:
                footstep_grass_audio()
        match frame:
            1, 1:
                footstep_grass_audio()
    if Global.current_movement == "bounce" && Global.terrain_type == "land":
        match frame:
            1, 1:
                footstep_grass_audio()
    if Global.current_movement != "bounce" && Global.terrain_type == "water":
        match frame:
            0, 1:
                footstep_puddle_audio()
        match frame:
            1, 1:
                footstep_puddle_audio()
    if Global.current_movement == "bounce" && Global.terrain_type == "water":
        match frame:
            1, 1:
                footstep_puddle_audio()

问题分析 #

原代码存在几个核心问题：

• 同一条件下重复的match语句，导致同一帧多次触发音频播放，音频叠加产生卡顿感
• frame_changed信号可能因动画帧快速切换、浮点帧精度问题频繁触发，无防抖处理
• 未检查音频播放器状态，可能强制中断正在播放的音频，引发卡顿

修复方案 #

1. 简化帧匹配逻辑，移除重复调用 #

合并冗余的条件判断，避免同一帧多次触发音频：

func _on_frame_changed():
    # 陆地地形逻辑
    if Global.terrain_type == "land":
        if Global.current_movement != "bounce":
            if frame in [0, 1]:
                footstep_grass_audio()
        else:
            if frame == 1:
                footstep_grass_audio()
    # 水域地形逻辑
    elif Global.terrain_type == "water":
        if Global.current_movement != "bounce":
            if frame in [0, 1]:
                footstep_puddle_audio()
        else:
            if frame == 1:
                footstep_puddle_audio()

2. 添加音频防抖与播放状态检查 #

修改音频播放函数，避免短时间内重复播放，同时确保播放器空闲时再触发：

# 新增变量记录上次播放时间，添加冷却阈值
var last_footstep_time = 0
var FOOTSTEP_COOLDOWN = 0.2 # 可根据动画节奏调整，单位：秒

func footstep_grass_audio():
    # 冷却检查，避免短时间内重复播放
    if OS.get_ticks_msec() - last_footstep_time < FOOTSTEP_COOLDOWN * 1000:
        return
    last_footstep_time = OS.get_ticks_msec()
    
    var footstep_grass_audio_tracks = [
        $"%audio_footstep_grass_0",
        $"%audio_footstep_grass_1",
        $"%audio_footstep_grass_2",
        $"%audio_footstep_grass_3",
        $"%audio_footstep_grass_4",
    ]
    footstep_grass_audio_tracks.shuffle()
    var track = footstep_grass_audio_tracks[0]
    # 检查播放器是否空闲，避免中断正在播放的音频
    if not track.playing:
        track.play()

func footstep_puddle_audio():
    if OS.get_ticks_msec() - last_footstep_time < FOOTSTEP_COOLDOWN * 1000:
        return
    last_footstep_time = OS.get_ticks_msec()
    
    var footstep_puddle_audio_tracks = [
        $"%audio_footstep_puddle_0",
        $"%audio_footstep_puddle_1",
        $"%audio_footstep_puddle_2",
        $"%audio_footstep_puddle_3",
        $"%audio_footstep_puddle_4",
    ]
    footstep_puddle_audio_tracks.shuffle()
    var track = footstep_puddle_audio_tracks[0]
    if not track.playing:
        track.play()

3. 优化信号触发逻辑（可选） #

若frame_changed仍触发过于频繁，可改用动画关键帧事件替代：

• 在动画编辑器中，给需要播放脚步声的帧添加自定义事件（如play_footstep）
• 将该事件连接到音频播放函数，替代frame_changed信号，确保仅在指定帧精确触发一次

额外排查建议 #

• 询问该玩家的设备配置（CPU、内存、音频设备）和浏览器版本，排查环境兼容性问题
• 测试时开启Godot性能监视器，查看音频线程负载
• 确保音频文件为游戏友好格式（如OGG），避免过大文件导致加载卡顿

内容的提问来源于stack exchange，提问作者Feanne