Cocos学习之事件通信-CSDN博客

本文链接：https://blog.csdn.net/tipsyes/article/details/147427405

🌟 前言

在复杂游戏系统中，组件通信直接影响架构质量。直接引用耦合度高、维护困难，而事件驱动模式通过发布-订阅机制实现松耦合交互。本文以Cocos Creator为例，通过实际开发场景演示如何构建高效事件系统，涵盖基础实现到进阶控制，为构建可扩展的游戏架构提供实践方案。

📡 事件通信

核心原则

解耦：组件间不直接引用，通过事件交互
全局管理：使用 director 或自定义事件中心
命名规范：事件名建议模块化（如 Player:Jump、UI:ButtonClick）

案例1：全局事件基础

目标：玩家跳跃时触发事件，UI更新跳跃次数。

步骤：

定义事件名（推荐用枚举）

enum GameEvent {
    PLAYER_JUMP = "player-jump",
}

玩家脚本触发事件

// PlayerController.ts
import { director } from 'cc';

export class PlayerController extends Component {
    jump() {
        // 跳跃逻辑...
        director.emit(GameEvent.PLAYER_JUMP); // 派发事件
    }
}

UI脚本监听事件

// JumpCounter.ts
import { director } from 'cc';

export class JumpCounter extends Component {
    private count: number = 0;

    onLoad() {
        director.on(GameEvent.PLAYER_JUMP, this.onJump, this);
    }

    onJump() {
        this.count++;
        this.updateLabel();
    }

    onDestroy() {
        director.off(GameEvent.PLAYER_JUMP, this.onJump, this); // 必须移除监听！
    }
}

案例2：携带数据的自定义事件

目标：敌人死亡时传递击杀者信息和得分。

代码：

// 定义事件类型
interface EnemyDeathEvent {
    killer: string;
    score: number;
}

// 敌人脚本
director.emit(GameEvent.ENEMY_DEATH, {
    killer: "Player1",
    score: 100
} as EnemyDeathEvent);

// 计分板脚本
director.on(GameEvent.ENEMY_DEATH, (event: EnemyDeathEvent) => {
    this.totalScore += event.score;
});

案例3：事件优先级与拦截

目标：任务系统拦截道具拾取事件，判断是否允许拾取。

代码：

// 高优先级监听（返回true拦截事件）
director.on(GameEvent.ITEM_PICKUP, (itemId: number) => {
    if (this.isInventoryFull()) {
        console.log("背包已满，无法拾取");
        return true; // 拦截事件
    }
    return false;
}, this, true); // 第四个参数设置优先级

// 原拾取逻辑
director.on(GameEvent.ITEM_PICKUP, (itemId: number) => {
    this.addToInventory(itemId);
});

🎯 总结

事件通信机制通过三大核心价值优化游戏架构：

解耦性：组件通过事件中心间接交互，降低依赖
灵活性：支持数据传递、优先级控制等动态逻辑
可维护性：统一命名规范+全局管理，便于调试扩展
案例实践表明，合理使用emit/on配合类型声明与销毁控制，既能实现UI-逻辑分离，又能处理复杂业务拦截需求，是构建健壮游戏系统的关键设计模式。