《抖音弹幕游戏开发专栏》是优雅草建立的专栏，由优雅草资深开发工程师云桂提供实战教学配对发布有对应的视频教程，以下内容为技术文稿，卓伊凡辅助。
抖音弹幕游戏开发之第12集：添加冷却时间机制·优雅草云桧·卓伊凡

第12集：添加冷却时间机制

为什么需要冷却时间

如果直播间每秒10条弹幕，其中5条包含"跳"，角色会每秒跳5次，根本停不下来！

冷却机制：触发一次效果后，在一段时间内忽略后续的触发请求。

冷却机制原理

1. 记录上次触发的时间
2. 收到新请求时，检查时间间隔
3. 间隔 < 冷却时间 → 忽略
4. 间隔 ≥ 冷却时间 → 执行并更新时间

导入time模块

import time

定义冷却配置

COOLDOWN = 2  # 冷却时间（秒）
last_trigger_time = 0  # 上次触发时间

添加冷却检查

def handle_barrage(data):
    global last_trigger_time
    
    content = data.get('content', '')
    name = data.get('name', '')
    print(f"💬 [弹幕] {name}: {content}")
    
    # 检查冷却时间
    current_time = time.time()
    time_passed = current_time - last_trigger_time
    if time_passed < COOLDOWN:
        remaining = COOLDOWN - time_passed
        print(f"⏰ 冷却中，还需等待 {remaining:.1f} 秒")
        return

    # 触发规则
    if '跳' in content:
        pyautogui.press('space')
        last_trigger_time = current_time  # 更新触发时间
        print("✓ 触发跳跃")

关键点

• global last_trigger_time - 声明使用全局变量
• time.time() - 获取当前时间戳（秒）
• 只有真正触发时才更新 last_trigger_time

测试效果

快速发送多条"跳"弹幕：

💬 [弹幕] 用户A: 跳
✓ 触发跳跃
💬 [弹幕] 用户B: 跳跳跳
⏰ 冷却中，还需等待 1.5 秒
💬 [弹幕] 用户C: 跳
⏰ 冷却中，还需等待 0.8 秒

调整冷却时间

COOLDOWN = 1  # 1秒，触发更频繁
COOLDOWN = 5  # 5秒，触发更少

建议：

• 休闲游戏：1-2秒
• 竞技游戏：3-5秒

本集总结

• ✅ 理解冷却机制的必要性和原理
• ✅ 使用time.time()获取时间戳
• ✅ 实现冷却时间检查
• ✅ 添加剩余时间显示

下一集：完善代码结构