简介这份资源是一个基于Cocos2d-x引擎实现的双人坦克大战Demo工程面向正在学习游戏开发、希望熟悉Cocos2d-x框架的初学者与团队成员。项目以验证玩法可行性为目标通过坦克移动、射击攻击与碰撞检测等核心机制帮助开发者在实践中理解场景管理、输入响应、动画播放与物理判定等基础模块。压缩包共250个文件约2.62MB包含25个cpp与36个h源码文件、75个png与20个plist资源、10个mm及5个m等平台适配文件另有tmx地图、wav与mp3音效、lua与js脚本以及多平台工程配置结构完整便于直接编译运行。目前已有38人学习下载。读者可借此获得一套可运行的双人对抗示例对照源码梳理角色控制、子弹命中判定与生命值结算逻辑并参考工程目录组织方式快速上手Cocos2d-x的跨平台开发流程。1. 双人坦克大战 demo为什么我选 cocos2d-x 而不是现成引擎去年底我想验证一个很具体的玩法假设两个玩家在同一块屏幕里开坦克对射地图上有可破坏的砖墙和不可穿透的钢墙谁先被击中三次谁输。这个玩法听起来简单但真正动手才会发现碰撞检测的粒度、子弹和墙体的交互顺序、双人输入的同时响应每一个点都能让原型翻车。我需要一个足够轻、能快速跑起来、又不会在底层把我困住的框架最后选了 cocos2d-x。选它的理由很直接C 写逻辑性能可控场景图和节点系统足够简单不用跟复杂的编辑器绑定跨平台发布不用改代码。更重要的是这个 demo 的目标不是做产品是验证玩法——我需要的是能在两三天内跑起来、随时改参数、随时看效果的东西。cocos2d-x 的HelloWorld模板改起来几乎没有阻力Scene、Layer、Sprite三层结构就能把坦克、子弹、地图全部装进去。这篇文章面向两类人一是想用 cocos2d-x 做小游戏原型但不知道从哪下手的开发者二是做过游戏但没碰过 cocos2d-x、想看看它的实际开发手感的人。我会把整个 demo 的搭建过程拆开从环境配置到双人输入、碰撞检测、子弹管理每一步都给出可复现的代码和参数说明。中间会重点讲我踩过的坑比如子弹穿透、输入冲突、节点层级导致的渲染顺序错乱。看完你应该能自己跑起来一个能玩的双人坦克对战原型并且知道哪些地方可以继续改。2. 环境搭建与项目骨架从零跑通第一个坦克场景2.1 cocos2d-x 版本选择和项目创建cocos2d-x 的版本迭代比较快我建议用 3.17 或 4.0 这两个稳定分支。3.17 的文档和社区资料最全4.0 对 C17 支持更好但部分 API 有变动。如果你只是做 demo 验证玩法3.17 足够遇到问题也更容易搜到答案。创建项目用官方命令行工具# 下载 cocos2d-x 3.17 后进入目录 cd cocos2d-x-3.17 # 创建项目项目名 TankBattle包名 com.demo.tankbattle语言 cpp python tools/cocos2d-console/bin/cocos.py new TankBattle -p com.demo.tankbattle -l cpp -d ~/projects这条命令会在~/projects/TankBattle下生成完整的项目结构。关键目录是Classes放 C 代码和Resources放图片、音效。创建完成后先编译运行一次确认HelloWorld能正常显示。编译命令cd ~/projects/TankBattle mkdir build cd build cmake .. make -j4如果用的是 macOS 或 Linux这一步基本不会出问题。Windows 下建议用 Visual Studio 打开proj.win32下的解决方案文件。编译通过后运行看到 cocos2d-x 的默认画面就说明环境没问题。注意如果你在 macOS 上遇到 OpenGL 相关的弃用警告不用管不影响运行。cocos2d-x 3.17 默认用 OpenGL新系统会有警告但功能正常。2.2 场景拆分用 Layer 把地图、坦克、子弹分开管理cocos2d-x 的Scene是一个容器真正干活的是Layer。我一开始把所有东西都塞在一个 Layer 里结果子弹的渲染层级和坦克冲突子弹飞到坦克后面去了看起来像被吃掉。后来改成三个 Layer 分层管理// GameScene.h class GameScene : public cocos2d::Scene { public: static cocos2d::Scene* createScene(); virtual bool init() override; void update(float dt) override; private: cocos2d::Layer* mapLayer; // 地图层砖墙、钢墙 cocos2d::Layer* tankLayer; // 坦克层两个玩家坦克 cocos2d::Layer* bulletLayer; // 子弹层所有子弹 cocos2d::Layer* uiLayer; // UI 层血量、提示 void initMap(); void initTanks(); void initKeyboard(); };init()里按顺序添加 Layer后添加的 Layer 渲染在上层bool GameScene::init() { if (!Scene::init()) return false; mapLayer Layer::create(); this-addChild(mapLayer, 0); // zOrder 0最底层 tankLayer Layer::create(); this-addChild(tankLayer, 1); // zOrder 1坦克在地图上方 bulletLayer Layer::create(); this-addChild(bulletLayer, 2); // zOrder 2子弹在坦克上方 uiLayer Layer::create(); this-addChild(uiLayer, 3); // zOrder 3UI 最上层 initMap(); initTanks(); initKeyboard(); this-scheduleUpdate(); // 开启每帧更新 return true; }这里的关键参数是addChild的第二个参数zOrder。cocos2d-x 按 zOrder 从小到大渲染zOrder 相同的按添加顺序。子弹的 zOrder 必须比坦克大否则子弹会被坦克遮住。地图的 zOrder 最小保证坦克和子弹都在地图上方。scheduleUpdate()开启后每帧会调用update(float dt)这是做碰撞检测和子弹移动的地方。dt是距上一帧的时间间隔用它来算移动距离可以保证不同帧率下速度一致。2.3 地图数据结构用二维数组描述可破坏和不可破坏墙体地图我用一个二维数组来描述每个格子有三种状态0 表示空地1 表示砖墙可被子弹摧毁2 表示钢墙不可摧毁。地图大小设为 13x13 格每格 40 像素刚好铺满 520x520 的区域留出边距放 UI。// 地图数据0 空地1 砖墙2 钢墙 static const int MAP_WIDTH 13; static const int MAP_HEIGHT 13; static const int TILE_SIZE 40; int mapData[MAP_HEIGHT][MAP_WIDTH] { {2,2,2,2,2,2,2,2,2,2,2,2,2}, {2,0,0,0,0,0,0,0,0,0,0,0,2}, {2,0,1,0,1,0,1,0,1,0,1,0,2}, {2,0,0,0,0,0,0,0,0,0,0,0,2}, {2,0,1,0,1,0,1,0,1,0,1,0,2}, {2,0,0,0,0,0,0,0,0,0,0,0,2}, {2,0,1,0,1,0,1,0,1,0,1,0,2}, {2,0,0,0,0,0,0,0,0,0,0,0,2}, {2,0,1,0,1,0,1,0,1,0,1,0,2}, {2,0,0,0,0,0,0,0,0,0,0,0,2}, {2,0,1,0,1,0,1,0,1,0,1,0,2}, {2,0,0,0,0,0,0,0,0,0,0,0,2}, {2,2,2,2,2,2,2,2,2,2,2,2,2} };初始化地图时遍历这个数组根据值创建对应的 Sprite 并设置位置void GameScene::initMap() { for (int row 0; row MAP_HEIGHT; row) { for (int col 0; col MAP_WIDTH; col) { int type mapData[row][col]; if (type 0) continue; const char* img (type 1) ? brick.png : steel.png; auto wall Sprite::create(img); wall-setPosition(Vec2(col * TILE_SIZE TILE_SIZE/2, row * TILE_SIZE TILE_SIZE/2)); wall-setTag(type); // 用 tag 区分砖墙和钢墙 mapLayer-addChild(wall); } } }setTag在这里很关键。后面子弹碰撞检测时通过getTag()就能判断撞到的是砖墙还是钢墙。砖墙被击中后要移除节点并更新mapData对应格子为 0钢墙则只销毁子弹。这个设计让地图逻辑和渲染逻辑解耦改地图只需要改数组。提示TILE_SIZE和地图数组的尺寸要匹配。如果你改了地图大小记得同步调整窗口分辨率否则会出现地图显示不全或者留白过多。3. 双人输入与坦克移动键盘事件绑定和方向控制3.1 用 EventKeyboard 监听双人按键cocos2d-x 的键盘事件通过EventListenerKeyboard处理。双人操作的核心是玩家 1 用 WASD 控制移动、空格射击玩家 2 用方向键控制移动、回车射击。这里有个坑cocos2d-x 默认不区分按键的按下和释放状态你需要自己维护一个按键状态表。// 按键状态true 表示按下false 表示释放 std::setcocos2d::EventKeyboard::KeyCode pressedKeys; void GameScene::initKeyboard() { auto listener EventListenerKeyboard::create(); listener-onKeyPressed [this](EventKeyboard::KeyCode code, Event* event) { pressedKeys.insert(code); }; listener-onKeyReleased [this](EventKeyboard::KeyCode code, Event* event) { pressedKeys.erase(code); }; _eventDispatcher-addEventListenerWithSceneGraphPriority(listener, this); }用std::set存按下的键onKeyPressed插入onKeyReleased删除。在update里检查某个键是否在pressedKeys中就能实现持续移动。这种方式的优点是支持同时按多个键比如玩家 1 按住 W 和 D 可以斜向移动。3.2 坦克移动逻辑速度、方向和边界检测坦克移动不能直接改坐标要考虑速度、方向和边界。我定义了一个Tank类来封装这些逻辑class Tank : public cocos2d::Sprite { public: static Tank* create(const std::string image, int playerId); void move(float dt, const std::setEventKeyboard::KeyCode keys); void setDirection(int dir); // 0上 1下 2左 3右 int getDirection() const { return direction; } int getPlayerId() const { return playerId; } int getHp() const { return hp; } void takeDamage() { hp--; } private: int direction 0; int playerId 0; int hp 3; float speed 120.0f; // 像素/秒 };move方法的实现void Tank::move(float dt, const std::setEventKeyboard::KeyCode keys) { Vec2 pos getPosition(); float dx 0, dy 0; if (playerId 1) { if (keys.count(EventKeyboard::KeyCode::KEY_W)) { dy speed * dt; direction 0; } else if (keys.count(EventKeyboard::KeyCode::KEY_S)) { dy -speed * dt; direction 1; } else if (keys.count(EventKeyboard::KeyCode::KEY_A)) { dx -speed * dt; direction 2; } else if (keys.count(EventKeyboard::KeyCode::KEY_D)) { dx speed * dt; direction 3; } } else { if (keys.count(EventKeyboard::KeyCode::KEY_UP_ARROW)) { dy speed * dt; direction 0; } else if (keys.count(EventKeyboard::KeyCode::KEY_DOWN_ARROW)) { dy -speed * dt; direction 1; } else if (keys.count(EventKeyboard::KeyCode::KEY_LEFT_ARROW)) { dx -speed * dt; direction 2; } else if (keys.count(EventKeyboard::KeyCode::KEY_RIGHT_ARROW)) { dx speed * dt; direction 3; } } // 边界检测留出 TILE_SIZE 的边距 float newX pos.x dx; float newY pos.y dy; float half TILE_SIZE / 2; if (newX half || newX MAP_WIDTH * TILE_SIZE - half) dx 0; if (newY half || newY MAP_HEIGHT * TILE_SIZE - half) dy 0; setPosition(pos.x dx, pos.y dy); }这里用else if而不是独立的if是为了保证同一时间只有一个方向生效。如果你想让坦克支持斜向移动把else if改成if就行但要注意斜向速度会变成speed * 1.414需要做归一化处理。speed设为 120 像素/秒在 60 帧下每帧移动 2 像素手感比较跟手。如果你觉得太慢可以调到 180太快就调到 80。这个参数直接影响游戏节奏建议多试几次。3.3 坦克与墙体的碰撞AABB 检测和位置回退坦克不能穿墙所以每次移动后要检测是否和墙体重叠。我用的是 AABB轴对齐包围盒检测简单高效bool GameScene::checkTankCollision(Tank* tank, const Vec2 newPos) { Rect tankRect(newPos.x - TILE_SIZE/2 4, newPos.y - TILE_SIZE/2 4, TILE_SIZE - 8, TILE_SIZE - 8); // 缩小 4 像素容差 for (auto child : mapLayer-getChildren()) { auto wall dynamic_castSprite*(child); if (!wall) continue; Rect wallRect(wall-getPositionX() - TILE_SIZE/2, wall-getPositionY() - TILE_SIZE/2, TILE_SIZE, TILE_SIZE); if (tankRect.intersectsRect(wallRect)) return true; } return false; }坦克的碰撞盒比实际尺寸小 4 像素这是为了容差。如果不缩小坦克在贴着墙走的时候会频繁触发碰撞导致移动卡顿。这个 4 像素是我试出来的经验值你可以根据坦克图片的实际留白调整。在update里调用void GameScene::update(float dt) { for (auto tank : tanks) { Vec2 oldPos tank-getPosition(); tank-move(dt, pressedKeys); if (checkTankCollision(tank, tank-getPosition())) { tank-setPosition(oldPos); // 碰撞则回退到移动前的位置 } } }位置回退是最简单的碰撞处理方式缺点是贴着墙走的时候会有轻微抖动。如果你追求更顺滑的手感可以用分轴检测先检测 X 轴移动再检测 Y 轴移动这样贴墙滑行会更自然。demo 阶段用回退就够了。注意checkTankCollision里遍历的是mapLayer的所有子节点。如果地图很大每帧遍历所有墙体会有性能问题。优化方案是用空间网格或者四叉树但 13x13 的地图完全不需要直接遍历就行。4. 子弹系统与碰撞检测从发射到销毁的完整链路4.1 子弹的创建、移动和生命周期管理子弹是坦克大战的核心交互对象。每颗子弹需要知道谁发射的、往哪个方向飞、速度多少、什么时候销毁。我用一个Bullet类来封装class Bullet : public cocos2d::Sprite { public: static Bullet* create(int ownerId, int direction, const Vec2 startPos); void update(float dt); int getOwnerId() const { return ownerId; } bool isAlive() const { return alive; } void destroy() { alive false; this-removeFromParent(); } private: int ownerId 0; int direction 0; float speed 300.0f; bool alive true; };create方法里根据方向设置子弹的初始位置偏移避免子弹一出生就和自己坦克碰撞Bullet* Bullet::create(int ownerId, int direction, const Vec2 startPos) { auto bullet new (std::nothrow) Bullet(); if (bullet bullet-initWithFile(bullet.png)) { bullet-autorelease(); bullet-ownerId ownerId; bullet-direction direction; // 根据方向偏移子弹出生位置偏移量 坦克半尺寸 子弹半尺寸 Vec2 offset(0, 0); float offsetDist TILE_SIZE / 2 8; switch (direction) { case 0: offset Vec2(0, offsetDist); break; // 上 case 1: offset Vec2(0, -offsetDist); break; // 下 case 2: offset Vec2(-offsetDist, 0); break; // 左 case 3: offset Vec2(offsetDist, 0); break; // 右 } bullet-setPosition(startPos offset); return bullet; } CC_SAFE_DELETE(bullet); return nullptr; }offsetDist设为TILE_SIZE/2 8即 28 像素。这个值必须大于坦克碰撞盒的半宽20-416加上子弹半宽8否则子弹会在坦克内部生成导致刚发射就触发碰撞。我一开始设成 20结果子弹一出来就消失排查了半天才发现是出生位置和坦克重叠了。子弹的update每帧移动void Bullet::update(float dt) { if (!alive) return; Vec2 pos getPosition(); float dist speed * dt; switch (direction) { case 0: pos.y dist; break; case 1: pos.y - dist; break; case 2: pos.x - dist; break; case 3: pos.x dist; break; } setPosition(pos); // 飞出地图边界则销毁 if (pos.x 0 || pos.x MAP_WIDTH * TILE_SIZE || pos.y 0 || pos.y MAP_HEIGHT * TILE_SIZE) { destroy(); } }子弹速度设为 300 像素/秒是坦克速度的 2.5 倍。这个比例让子弹有明显的前冲感但又不至于快到看不清。如果你想让游戏更紧张可以调到 400想更休闲就调到 200。4.2 子弹与墙体的碰撞砖墙销毁和钢墙反弹子弹撞墙分两种情况砖墙被摧毁钢墙只销毁子弹。在GameScene::update里统一处理void GameScene::updateBullets(float dt) { for (auto it bullets.begin(); it ! bullets.end(); ) { Bullet* bullet *it; if (!bullet-isAlive()) { it bullets.erase(it); continue; } bullet-update(dt); // 检测子弹和墙体的碰撞 Rect bulletRect(bullet-getPositionX() - 6, bullet-getPositionY() - 6, 12, 12); bool hit false; for (auto child : mapLayer-getChildren()) { auto wall dynamic_castSprite*(child); if (!wall) continue; Rect wallRect(wall-getPositionX() - TILE_SIZE/2, wall-getPositionY() - TILE_SIZE/2, TILE_SIZE, TILE_SIZE); if (bulletRect.intersectsRect(wallRect)) { hit true; if (wall-getTag() 1) { // 砖墙 // 更新地图数据 int col wall-getPositionX() / TILE_SIZE; int row wall-getPositionY() / TILE_SIZE; mapData[row][col] 0; wall-removeFromParent(); } break; } } if (hit) { bullet-destroy(); it bullets.erase(it); } else { it; } } }子弹的碰撞盒设为 12x12比图片略小避免视觉上还没碰到就判定碰撞。砖墙被击中后要同时做两件事从mapLayer移除节点把mapData对应格子设为 0。如果只移除节点不更新数据后续坦克碰撞检测会出问题——坦克会撞到已经消失的墙。提示mapData的索引是[row][col]而wall-getPositionX()对应的是列getPositionY()对应的是行。这里容易搞反建议写个辅助函数Vec2 tileToPos(int row, int col)和Vec2 posToTile(const Vec2 pos)来统一转换。4.3 子弹与坦克的碰撞伤害计算和胜负判定子弹击中坦克的逻辑要排除自己发射的子弹否则一发射就自伤void GameScene::checkBulletTankCollision() { for (auto bullet : bullets) { if (!bullet-isAlive()) continue; Rect bulletRect(bullet-getPositionX() - 6, bullet-getPositionY() - 6, 12, 12); for (auto tank : tanks) { if (tank-getPlayerId() bullet-getOwnerId()) continue; // 跳过自己 Rect tankRect(tank-getPositionX() - TILE_SIZE/2 4, tank-getPositionY() - TILE_SIZE/2 4, TILE_SIZE - 8, TILE_SIZE - 8); if (bulletRect.intersectsRect(tankRect)) { bullet-destroy(); tank-takeDamage(); if (tank-getHp() 0) { // 游戏结束 showGameOver(tank-getPlayerId() 1 ? 2 : 1); } break; } } } }getOwnerId()和getPlayerId()的比对是防止自伤的关键。坦克初始 HP 设为 3每次被击中减 1减到 0 时对方获胜。showGameOver里暂停游戏逻辑在uiLayer上显示获胜方。这里有个细节子弹销毁后要从bullets容器里移除但如果在遍历bullets的过程中直接erase会导致迭代器失效。我的做法是先把alive标记为 false在下一帧的updateBullets里统一清理。这样虽然有一帧的延迟但逻辑更安全。4.4 射击冷却防止按住射击键无限连发如果不加冷却按住空格键每帧都会创建一颗子弹60 帧就是每秒 60 颗屏幕瞬间被子弹填满。我加了一个简单的冷却计时// 在 GameScene 里维护每个玩家的射击冷却 float shootCooldown[2] {0.0f, 0.0f}; const float SHOOT_INTERVAL 0.5f; // 0.5 秒一发 void GameScene::handleShooting(float dt) { shootCooldown[0] - dt; shootCooldown[1] - dt; if (pressedKeys.count(EventKeyboard::KeyCode::KEY_SPACE) shootCooldown[0] 0) { auto bullet Bullet::create(1, tanks[0]-getDirection(), tanks[0]-getPosition()); if (bullet) { bulletLayer-addChild(bullet); bullets.push_back(bullet); shootCooldown[0] SHOOT_INTERVAL; } } if (pressedKeys.count(EventKeyboard::KeyCode::KEY_ENTER) shootCooldown[1] 0) { auto bullet Bullet::create(2, tanks[1]-getDirection(), tanks[1]-getPosition()); if (bullet) { bulletLayer-addChild(bullet); bullets.push_back(bullet); shootCooldown[1] SHOOT_INTERVAL; } } }SHOOT_INTERVAL设为 0.5 秒即每秒最多两发。这个节奏让玩家需要瞄准而不是无脑扫射。如果你想让游戏更爽快可以调到 0.3想更策略化就调到 0.8。冷却时间直接决定了对战的节奏感建议在 demo 里多试几个值。5. 避坑与排查双人坦克 demo 最容易翻车的五个地方5.1 子弹穿透薄墙碰撞检测的帧间跳跃问题现象子弹速度调到 400 以上时偶尔会直接穿过砖墙墙没被摧毁子弹也没消失。原因子弹每帧移动距离 速度 × dt。60 帧下 dt 约 0.0167 秒400 速度每帧移动 6.7 像素。如果墙的碰撞盒只有 40 像素宽理论上不会穿透。但如果某一帧卡顿导致 dt 变大比如 0.05 秒子弹一帧移动 20 像素就可能从墙的一侧跳到另一侧而碰撞检测只检查最终位置不检查路径。解决用射线检测或者分步移动。简单做法是把子弹的移动拆成多个小步每步不超过 4 像素void Bullet::update(float dt) { if (!alive) return; float totalDist speed * dt; float step 4.0f; int steps std::max(1, (int)(totalDist / step)); float stepDist totalDist / steps; for (int i 0; i steps; i) { Vec2 pos getPosition(); switch (direction) { case 0: pos.y stepDist; break; case 1: pos.y - stepDist; break; case 2: pos.x - stepDist; break; case 3: pos.x stepDist; break; } setPosition(pos); if (checkWallCollision()) { destroy(); return; } } }这样即使 dt 波动子弹也不会跳过墙体。代价是每帧多几次碰撞检测但子弹数量不多性能完全没问题。5.2 双人按键冲突同时按下多个键时移动方向错乱现象玩家 1 按住 W 和 D坦克斜向移动但松开 W 后坦克继续斜向移动直到松开 D 才恢复。原因move方法里用了else if同一时间只处理一个方向。但pressedKeys里同时存在 W 和 D代码按顺序检查W 先命中就只处理 WD 被忽略。松开 W 后D 还在pressedKeys里下一帧就处理 D。这本身没问题但如果你在move里改了direction而射击用的是direction就会出现坦克朝向和移动方向不一致。解决把移动和朝向分开。移动用独立的逻辑处理朝向只在射击时更新void Tank::move(float dt, const std::setEventKeyboard::KeyCode keys) { Vec2 pos getPosition(); float dx 0, dy 0; if (playerId 1) { if (keys.count(EventKeyboard::KeyCode::KEY_W)) dy speed * dt; if (keys.count(EventKeyboard::KeyCode::KEY_S)) dy - speed * dt; if (keys.count(EventKeyboard::KeyCode::KEY_A)) dx - speed * dt; if (keys.count(EventKeyboard::KeyCode::KEY_D)) dx speed * dt; } // ... 玩家 2 同理 // 归一化斜向速度 if (dx ! 0 dy ! 0) { dx * 0.707f; dy * 0.707f; } setPosition(pos.x dx, pos.y dy); }用独立的if而不是else if支持斜向移动。归一化系数 0.707 是 1/√2保证斜向速度和直线速度一致。朝向在射击时根据当前按键单独判断不影响移动。5.3 节点层级错乱子弹被地图遮挡现象子弹飞过砖墙区域时突然消失但墙没被摧毁。原因子弹添加到了mapLayer而不是bulletLayer或者bulletLayer的 zOrder 比mapLayer小。cocos2d-x 按 zOrder 渲染zOrder 小的先画会被后画的覆盖。解决检查addChild的 zOrder 参数。子弹必须加到bulletLayer且bulletLayer的 zOrder 要大于mapLayer和tankLayer。我习惯在init里显式设置this-addChild(mapLayer, 0); this-addChild(tankLayer, 10); this-addChild(bulletLayer, 20); this-addChild(uiLayer, 30);zOrder 之间留出间隔方便以后在中间插入新的 Layer。比如以后要加爆炸特效层可以放在 15在坦克和子弹之间。5.4 内存泄漏子弹和墙体移除后未释放现象游戏运行几分钟后帧率下降内存占用持续上升。原因removeFromParent()只是把节点从场景树移除如果没有正确处理引用计数节点可能不会被释放。cocos2d-x 用引用计数管理内存addChild会增加引用计数removeFromParent会减少但如果你在容器里还持有指针引用计数不会归零。解决子弹销毁时从bullets容器移除墙体销毁时从mapLayer移除后不要再持有指针。用autorelease创建的节点由自动释放池管理不需要手动delete。关键是容器里的指针要及时清理// 子弹销毁后从容器移除 bullets.erase(std::remove_if(bullets.begin(), bullets.end(), [](Bullet* b) { return !b-isAlive(); }), bullets.end());墙体不需要额外容器管理removeFromParent后引用计数归零自动释放。如果你发现内存不降检查是不是在某个地方retain了但没有release。5.5 游戏结束后逻辑未暂停坦克还能移动现象一方 HP 归零后显示胜利提示但坦克还能继续移动和射击。原因showGameOver只显示了 UI没有暂停update里的逻辑。解决加一个gameOver标志位在update开头检查void GameScene::update(float dt) { if (gameOver) return; handleShooting(dt); for (auto tank : tanks) { Vec2 oldPos tank-getPosition(); tank-move(dt, pressedKeys); if (checkTankCollision(tank, tank-getPosition())) { tank-setPosition(oldPos); } } updateBullets(dt); checkBulletTankCollision(); }gameOver设为 true 后所有游戏逻辑停止但 UI 层的动画和按钮仍然可以响应。如果你想让玩家能重新开始在uiLayer上加一个按钮点击后重置gameOver和所有状态。6. 进阶技巧用状态机和数据驱动把 demo 变成可扩展的原型6.1 用状态机管理坦克行为现在的坦克只有移动和射击两个行为逻辑直接写在update里还能应付。但如果你想加道具、加 AI 敌人、加复活无敌时间代码会迅速膨胀。我的做法是引入一个极简状态机enum class TankState { Idle, Moving, Shooting, Dead }; class Tank : public cocos2d::Sprite { public: void changeState(TankState newState) { if (state newState) return; onExitState(state); state newState; onEnterState(state); } private: TankState state TankState::Idle; void onEnterState(TankState s) { switch (s) { case TankState::Dead: this-setVisible(false); break; case TankState::Shooting: // 播放射击动画 break; default: break; } } void onExitState(TankState s) { switch (s) { case TankState::Dead: this-setVisible(true); break; default: break; } } };状态机的价值在于把「进入状态时做什么」和「退出状态时做什么」集中管理。比如死亡状态要隐藏坦克、禁用输入、播放爆炸特效复活状态要重置位置、恢复 HP、给 2 秒无敌时间。这些逻辑如果散落在update里改起来很容易漏。6.2 数据驱动把地图和参数抽到 JSONdemo 阶段地图写死在代码里没问题但如果你想快速试不同地图布局每次改代码重新编译太慢。把地图数据抽到 JSON 文件运行时加载{ mapWidth: 13, mapHeight: 13, tileSize: 40, tiles: [ [2,2,2,2,2,2,2,2,2,2,2,2,2], [2,0,0,0,0,0,0,0,0,0,0,0,2], [2,0,1,0,1,0,1,0,1,0,1,0,2], [2,0,0,0,0,0,0,0,0,0,0,0,2], [2,0,1,0,1,0,1,0,1,0,1,0,2], [2,0,0,0,0,0,0,0,0,0,0,0,2], [2,0,1,0,1,0,1,0,1,0,1,0,2], [2,0,0,0,0,0,0,0,0,0,0,0,2], [2,0,1,0,1,0,1,0,1,0,1,0,2], [2,0,0,0,0,0,0,0,0,0,0,0,2], [2,0,1,0,1,0,1,0,1,0,1,0,2], [2,0,0,0,0,0,0,0,0,0,0,0,2], [2,2,2,2,2,2,2,2,2,2,2,2,2] ], tankSpeed: 120, bulletSpeed: 300, shootInterval: 0.5, maxHp: 3 }加载用 cocos2d-x 自带的FileUtils和rapidjson#include json/rapidjson.h #include json/document.h void GameScene::loadConfig(const std::string filename) { std::string content FileUtils::getInstance()-getStringFromFile(filename); rapidjson::Document doc; doc.Parse(content.c_str()); if (doc.HasParseError()) { CCLOG(JSON parse error: %s, filename.c_str()); return; } TILE_SIZE doc[tileSize].GetInt(); // ... 读取其他参数 }数据驱动的好处是改参数不用重新编译。你可以把 JSON 文件放在Resources目录用文本编辑器改完直接运行看效果。对于玩法验证阶段这个效率提升非常明显。6.3 验证玩法是否成立三个可量化的指标demo 跑起来只是第一步真正要验证的是「这个玩法好不好玩」。我一般会看三个指标指标测量方式健康范围平均对局时长从开始到一方 HP 归零的时间30-90 秒射击命中率命中次数 / 总射击次数20%-40%移动/射击时间比移动帧数 / 射击帧数2:1 到 4:1对局时长太短说明伤害太高或地图太小太长说明节奏拖沓。命中率太低说明子弹速度慢或地图掩体太多太高说明掩体太少或子弹太快。移动/射击时间比反映玩家的行为倾向如果射击时间远超移动说明游戏变成了站桩对射缺少走位博弈。我在 demo 里加了一个简单的统计输出每局结束后在控制台打印这三个值。改参数后跑几局看指标是否落在健康范围。这比凭感觉调参靠谱得多。6.4 我踩过的最大的坑不要过早优化最后说一个血泪教训。我在第一版 demo 里花了两天时间做对象池管理子弹、做四叉树优化碰撞检测、做帧同步准备联机。结果玩法验证下来发现双人同屏对战的核心问题是「屏幕太小两个玩家互相看不到对方的位置」而不是性能。如果一开始就用最笨的写法——每颗子弹new一个节点、每帧遍历所有墙体——半天就能跑起来然后花一天时间调地图大小和摄像机跟随玩法可能就成立了。所以我的习惯是demo 阶段只写能跑通的最简代码性能问题等玩法验证通过再解决。cocos2d-x 在几十个节点的情况下性能完全够用真正需要优化的时候你已经知道瓶颈在哪了。希望这个思路能帮到你少走一些我走过的弯路。本文还有配套的精品资源点击获取
cocos2d-x双人坦克大战demo：从零搭建到避坑指南
简介这份资源是一个基于Cocos2d-x引擎实现的双人坦克大战Demo工程面向正在学习游戏开发、希望熟悉Cocos2d-x框架的初学者与团队成员。项目以验证玩法可行性为目标通过坦克移动、射击攻击与碰撞检测等核心机制帮助开发者在实践中理解场景管理、输入响应、动画播放与物理判定等基础模块。压缩包共250个文件约2.62MB包含25个cpp与36个h源码文件、75个png与20个plist资源、10个mm及5个m等平台适配文件另有tmx地图、wav与mp3音效、lua与js脚本以及多平台工程配置结构完整便于直接编译运行。目前已有38人学习下载。读者可借此获得一套可运行的双人对抗示例对照源码梳理角色控制、子弹命中判定与生命值结算逻辑并参考工程目录组织方式快速上手Cocos2d-x的跨平台开发流程。1. 双人坦克大战 demo为什么我选 cocos2d-x 而不是现成引擎去年底我想验证一个很具体的玩法假设两个玩家在同一块屏幕里开坦克对射地图上有可破坏的砖墙和不可穿透的钢墙谁先被击中三次谁输。这个玩法听起来简单但真正动手才会发现碰撞检测的粒度、子弹和墙体的交互顺序、双人输入的同时响应每一个点都能让原型翻车。我需要一个足够轻、能快速跑起来、又不会在底层把我困住的框架最后选了 cocos2d-x。选它的理由很直接C 写逻辑性能可控场景图和节点系统足够简单不用跟复杂的编辑器绑定跨平台发布不用改代码。更重要的是这个 demo 的目标不是做产品是验证玩法——我需要的是能在两三天内跑起来、随时改参数、随时看效果的东西。cocos2d-x 的HelloWorld模板改起来几乎没有阻力Scene、Layer、Sprite三层结构就能把坦克、子弹、地图全部装进去。这篇文章面向两类人一是想用 cocos2d-x 做小游戏原型但不知道从哪下手的开发者二是做过游戏但没碰过 cocos2d-x、想看看它的实际开发手感的人。我会把整个 demo 的搭建过程拆开从环境配置到双人输入、碰撞检测、子弹管理每一步都给出可复现的代码和参数说明。中间会重点讲我踩过的坑比如子弹穿透、输入冲突、节点层级导致的渲染顺序错乱。看完你应该能自己跑起来一个能玩的双人坦克对战原型并且知道哪些地方可以继续改。2. 环境搭建与项目骨架从零跑通第一个坦克场景2.1 cocos2d-x 版本选择和项目创建cocos2d-x 的版本迭代比较快我建议用 3.17 或 4.0 这两个稳定分支。3.17 的文档和社区资料最全4.0 对 C17 支持更好但部分 API 有变动。如果你只是做 demo 验证玩法3.17 足够遇到问题也更容易搜到答案。创建项目用官方命令行工具# 下载 cocos2d-x 3.17 后进入目录 cd cocos2d-x-3.17 # 创建项目项目名 TankBattle包名 com.demo.tankbattle语言 cpp python tools/cocos2d-console/bin/cocos.py new TankBattle -p com.demo.tankbattle -l cpp -d ~/projects这条命令会在~/projects/TankBattle下生成完整的项目结构。关键目录是Classes放 C 代码和Resources放图片、音效。创建完成后先编译运行一次确认HelloWorld能正常显示。编译命令cd ~/projects/TankBattle mkdir build cd build cmake .. make -j4如果用的是 macOS 或 Linux这一步基本不会出问题。Windows 下建议用 Visual Studio 打开proj.win32下的解决方案文件。编译通过后运行看到 cocos2d-x 的默认画面就说明环境没问题。注意如果你在 macOS 上遇到 OpenGL 相关的弃用警告不用管不影响运行。cocos2d-x 3.17 默认用 OpenGL新系统会有警告但功能正常。2.2 场景拆分用 Layer 把地图、坦克、子弹分开管理cocos2d-x 的Scene是一个容器真正干活的是Layer。我一开始把所有东西都塞在一个 Layer 里结果子弹的渲染层级和坦克冲突子弹飞到坦克后面去了看起来像被吃掉。后来改成三个 Layer 分层管理// GameScene.h class GameScene : public cocos2d::Scene { public: static cocos2d::Scene* createScene(); virtual bool init() override; void update(float dt) override; private: cocos2d::Layer* mapLayer; // 地图层砖墙、钢墙 cocos2d::Layer* tankLayer; // 坦克层两个玩家坦克 cocos2d::Layer* bulletLayer; // 子弹层所有子弹 cocos2d::Layer* uiLayer; // UI 层血量、提示 void initMap(); void initTanks(); void initKeyboard(); };init()里按顺序添加 Layer后添加的 Layer 渲染在上层bool GameScene::init() { if (!Scene::init()) return false; mapLayer Layer::create(); this-addChild(mapLayer, 0); // zOrder 0最底层 tankLayer Layer::create(); this-addChild(tankLayer, 1); // zOrder 1坦克在地图上方 bulletLayer Layer::create(); this-addChild(bulletLayer, 2); // zOrder 2子弹在坦克上方 uiLayer Layer::create(); this-addChild(uiLayer, 3); // zOrder 3UI 最上层 initMap(); initTanks(); initKeyboard(); this-scheduleUpdate(); // 开启每帧更新 return true; }这里的关键参数是addChild的第二个参数zOrder。cocos2d-x 按 zOrder 从小到大渲染zOrder 相同的按添加顺序。子弹的 zOrder 必须比坦克大否则子弹会被坦克遮住。地图的 zOrder 最小保证坦克和子弹都在地图上方。scheduleUpdate()开启后每帧会调用update(float dt)这是做碰撞检测和子弹移动的地方。dt是距上一帧的时间间隔用它来算移动距离可以保证不同帧率下速度一致。2.3 地图数据结构用二维数组描述可破坏和不可破坏墙体地图我用一个二维数组来描述每个格子有三种状态0 表示空地1 表示砖墙可被子弹摧毁2 表示钢墙不可摧毁。地图大小设为 13x13 格每格 40 像素刚好铺满 520x520 的区域留出边距放 UI。// 地图数据0 空地1 砖墙2 钢墙 static const int MAP_WIDTH 13; static const int MAP_HEIGHT 13; static const int TILE_SIZE 40; int mapData[MAP_HEIGHT][MAP_WIDTH] { {2,2,2,2,2,2,2,2,2,2,2,2,2}, {2,0,0,0,0,0,0,0,0,0,0,0,2}, {2,0,1,0,1,0,1,0,1,0,1,0,2}, {2,0,0,0,0,0,0,0,0,0,0,0,2}, {2,0,1,0,1,0,1,0,1,0,1,0,2}, {2,0,0,0,0,0,0,0,0,0,0,0,2}, {2,0,1,0,1,0,1,0,1,0,1,0,2}, {2,0,0,0,0,0,0,0,0,0,0,0,2}, {2,0,1,0,1,0,1,0,1,0,1,0,2}, {2,0,0,0,0,0,0,0,0,0,0,0,2}, {2,0,1,0,1,0,1,0,1,0,1,0,2}, {2,0,0,0,0,0,0,0,0,0,0,0,2}, {2,2,2,2,2,2,2,2,2,2,2,2,2} };初始化地图时遍历这个数组根据值创建对应的 Sprite 并设置位置void GameScene::initMap() { for (int row 0; row MAP_HEIGHT; row) { for (int col 0; col MAP_WIDTH; col) { int type mapData[row][col]; if (type 0) continue; const char* img (type 1) ? brick.png : steel.png; auto wall Sprite::create(img); wall-setPosition(Vec2(col * TILE_SIZE TILE_SIZE/2, row * TILE_SIZE TILE_SIZE/2)); wall-setTag(type); // 用 tag 区分砖墙和钢墙 mapLayer-addChild(wall); } } }setTag在这里很关键。后面子弹碰撞检测时通过getTag()就能判断撞到的是砖墙还是钢墙。砖墙被击中后要移除节点并更新mapData对应格子为 0钢墙则只销毁子弹。这个设计让地图逻辑和渲染逻辑解耦改地图只需要改数组。提示TILE_SIZE和地图数组的尺寸要匹配。如果你改了地图大小记得同步调整窗口分辨率否则会出现地图显示不全或者留白过多。3. 双人输入与坦克移动键盘事件绑定和方向控制3.1 用 EventKeyboard 监听双人按键cocos2d-x 的键盘事件通过EventListenerKeyboard处理。双人操作的核心是玩家 1 用 WASD 控制移动、空格射击玩家 2 用方向键控制移动、回车射击。这里有个坑cocos2d-x 默认不区分按键的按下和释放状态你需要自己维护一个按键状态表。// 按键状态true 表示按下false 表示释放 std::setcocos2d::EventKeyboard::KeyCode pressedKeys; void GameScene::initKeyboard() { auto listener EventListenerKeyboard::create(); listener-onKeyPressed [this](EventKeyboard::KeyCode code, Event* event) { pressedKeys.insert(code); }; listener-onKeyReleased [this](EventKeyboard::KeyCode code, Event* event) { pressedKeys.erase(code); }; _eventDispatcher-addEventListenerWithSceneGraphPriority(listener, this); }用std::set存按下的键onKeyPressed插入onKeyReleased删除。在update里检查某个键是否在pressedKeys中就能实现持续移动。这种方式的优点是支持同时按多个键比如玩家 1 按住 W 和 D 可以斜向移动。3.2 坦克移动逻辑速度、方向和边界检测坦克移动不能直接改坐标要考虑速度、方向和边界。我定义了一个Tank类来封装这些逻辑class Tank : public cocos2d::Sprite { public: static Tank* create(const std::string image, int playerId); void move(float dt, const std::setEventKeyboard::KeyCode keys); void setDirection(int dir); // 0上 1下 2左 3右 int getDirection() const { return direction; } int getPlayerId() const { return playerId; } int getHp() const { return hp; } void takeDamage() { hp--; } private: int direction 0; int playerId 0; int hp 3; float speed 120.0f; // 像素/秒 };move方法的实现void Tank::move(float dt, const std::setEventKeyboard::KeyCode keys) { Vec2 pos getPosition(); float dx 0, dy 0; if (playerId 1) { if (keys.count(EventKeyboard::KeyCode::KEY_W)) { dy speed * dt; direction 0; } else if (keys.count(EventKeyboard::KeyCode::KEY_S)) { dy -speed * dt; direction 1; } else if (keys.count(EventKeyboard::KeyCode::KEY_A)) { dx -speed * dt; direction 2; } else if (keys.count(EventKeyboard::KeyCode::KEY_D)) { dx speed * dt; direction 3; } } else { if (keys.count(EventKeyboard::KeyCode::KEY_UP_ARROW)) { dy speed * dt; direction 0; } else if (keys.count(EventKeyboard::KeyCode::KEY_DOWN_ARROW)) { dy -speed * dt; direction 1; } else if (keys.count(EventKeyboard::KeyCode::KEY_LEFT_ARROW)) { dx -speed * dt; direction 2; } else if (keys.count(EventKeyboard::KeyCode::KEY_RIGHT_ARROW)) { dx speed * dt; direction 3; } } // 边界检测留出 TILE_SIZE 的边距 float newX pos.x dx; float newY pos.y dy; float half TILE_SIZE / 2; if (newX half || newX MAP_WIDTH * TILE_SIZE - half) dx 0; if (newY half || newY MAP_HEIGHT * TILE_SIZE - half) dy 0; setPosition(pos.x dx, pos.y dy); }这里用else if而不是独立的if是为了保证同一时间只有一个方向生效。如果你想让坦克支持斜向移动把else if改成if就行但要注意斜向速度会变成speed * 1.414需要做归一化处理。speed设为 120 像素/秒在 60 帧下每帧移动 2 像素手感比较跟手。如果你觉得太慢可以调到 180太快就调到 80。这个参数直接影响游戏节奏建议多试几次。3.3 坦克与墙体的碰撞AABB 检测和位置回退坦克不能穿墙所以每次移动后要检测是否和墙体重叠。我用的是 AABB轴对齐包围盒检测简单高效bool GameScene::checkTankCollision(Tank* tank, const Vec2 newPos) { Rect tankRect(newPos.x - TILE_SIZE/2 4, newPos.y - TILE_SIZE/2 4, TILE_SIZE - 8, TILE_SIZE - 8); // 缩小 4 像素容差 for (auto child : mapLayer-getChildren()) { auto wall dynamic_castSprite*(child); if (!wall) continue; Rect wallRect(wall-getPositionX() - TILE_SIZE/2, wall-getPositionY() - TILE_SIZE/2, TILE_SIZE, TILE_SIZE); if (tankRect.intersectsRect(wallRect)) return true; } return false; }坦克的碰撞盒比实际尺寸小 4 像素这是为了容差。如果不缩小坦克在贴着墙走的时候会频繁触发碰撞导致移动卡顿。这个 4 像素是我试出来的经验值你可以根据坦克图片的实际留白调整。在update里调用void GameScene::update(float dt) { for (auto tank : tanks) { Vec2 oldPos tank-getPosition(); tank-move(dt, pressedKeys); if (checkTankCollision(tank, tank-getPosition())) { tank-setPosition(oldPos); // 碰撞则回退到移动前的位置 } } }位置回退是最简单的碰撞处理方式缺点是贴着墙走的时候会有轻微抖动。如果你追求更顺滑的手感可以用分轴检测先检测 X 轴移动再检测 Y 轴移动这样贴墙滑行会更自然。demo 阶段用回退就够了。注意checkTankCollision里遍历的是mapLayer的所有子节点。如果地图很大每帧遍历所有墙体会有性能问题。优化方案是用空间网格或者四叉树但 13x13 的地图完全不需要直接遍历就行。4. 子弹系统与碰撞检测从发射到销毁的完整链路4.1 子弹的创建、移动和生命周期管理子弹是坦克大战的核心交互对象。每颗子弹需要知道谁发射的、往哪个方向飞、速度多少、什么时候销毁。我用一个Bullet类来封装class Bullet : public cocos2d::Sprite { public: static Bullet* create(int ownerId, int direction, const Vec2 startPos); void update(float dt); int getOwnerId() const { return ownerId; } bool isAlive() const { return alive; } void destroy() { alive false; this-removeFromParent(); } private: int ownerId 0; int direction 0; float speed 300.0f; bool alive true; };create方法里根据方向设置子弹的初始位置偏移避免子弹一出生就和自己坦克碰撞Bullet* Bullet::create(int ownerId, int direction, const Vec2 startPos) { auto bullet new (std::nothrow) Bullet(); if (bullet bullet-initWithFile(bullet.png)) { bullet-autorelease(); bullet-ownerId ownerId; bullet-direction direction; // 根据方向偏移子弹出生位置偏移量 坦克半尺寸 子弹半尺寸 Vec2 offset(0, 0); float offsetDist TILE_SIZE / 2 8; switch (direction) { case 0: offset Vec2(0, offsetDist); break; // 上 case 1: offset Vec2(0, -offsetDist); break; // 下 case 2: offset Vec2(-offsetDist, 0); break; // 左 case 3: offset Vec2(offsetDist, 0); break; // 右 } bullet-setPosition(startPos offset); return bullet; } CC_SAFE_DELETE(bullet); return nullptr; }offsetDist设为TILE_SIZE/2 8即 28 像素。这个值必须大于坦克碰撞盒的半宽20-416加上子弹半宽8否则子弹会在坦克内部生成导致刚发射就触发碰撞。我一开始设成 20结果子弹一出来就消失排查了半天才发现是出生位置和坦克重叠了。子弹的update每帧移动void Bullet::update(float dt) { if (!alive) return; Vec2 pos getPosition(); float dist speed * dt; switch (direction) { case 0: pos.y dist; break; case 1: pos.y - dist; break; case 2: pos.x - dist; break; case 3: pos.x dist; break; } setPosition(pos); // 飞出地图边界则销毁 if (pos.x 0 || pos.x MAP_WIDTH * TILE_SIZE || pos.y 0 || pos.y MAP_HEIGHT * TILE_SIZE) { destroy(); } }子弹速度设为 300 像素/秒是坦克速度的 2.5 倍。这个比例让子弹有明显的前冲感但又不至于快到看不清。如果你想让游戏更紧张可以调到 400想更休闲就调到 200。4.2 子弹与墙体的碰撞砖墙销毁和钢墙反弹子弹撞墙分两种情况砖墙被摧毁钢墙只销毁子弹。在GameScene::update里统一处理void GameScene::updateBullets(float dt) { for (auto it bullets.begin(); it ! bullets.end(); ) { Bullet* bullet *it; if (!bullet-isAlive()) { it bullets.erase(it); continue; } bullet-update(dt); // 检测子弹和墙体的碰撞 Rect bulletRect(bullet-getPositionX() - 6, bullet-getPositionY() - 6, 12, 12); bool hit false; for (auto child : mapLayer-getChildren()) { auto wall dynamic_castSprite*(child); if (!wall) continue; Rect wallRect(wall-getPositionX() - TILE_SIZE/2, wall-getPositionY() - TILE_SIZE/2, TILE_SIZE, TILE_SIZE); if (bulletRect.intersectsRect(wallRect)) { hit true; if (wall-getTag() 1) { // 砖墙 // 更新地图数据 int col wall-getPositionX() / TILE_SIZE; int row wall-getPositionY() / TILE_SIZE; mapData[row][col] 0; wall-removeFromParent(); } break; } } if (hit) { bullet-destroy(); it bullets.erase(it); } else { it; } } }子弹的碰撞盒设为 12x12比图片略小避免视觉上还没碰到就判定碰撞。砖墙被击中后要同时做两件事从mapLayer移除节点把mapData对应格子设为 0。如果只移除节点不更新数据后续坦克碰撞检测会出问题——坦克会撞到已经消失的墙。提示mapData的索引是[row][col]而wall-getPositionX()对应的是列getPositionY()对应的是行。这里容易搞反建议写个辅助函数Vec2 tileToPos(int row, int col)和Vec2 posToTile(const Vec2 pos)来统一转换。4.3 子弹与坦克的碰撞伤害计算和胜负判定子弹击中坦克的逻辑要排除自己发射的子弹否则一发射就自伤void GameScene::checkBulletTankCollision() { for (auto bullet : bullets) { if (!bullet-isAlive()) continue; Rect bulletRect(bullet-getPositionX() - 6, bullet-getPositionY() - 6, 12, 12); for (auto tank : tanks) { if (tank-getPlayerId() bullet-getOwnerId()) continue; // 跳过自己 Rect tankRect(tank-getPositionX() - TILE_SIZE/2 4, tank-getPositionY() - TILE_SIZE/2 4, TILE_SIZE - 8, TILE_SIZE - 8); if (bulletRect.intersectsRect(tankRect)) { bullet-destroy(); tank-takeDamage(); if (tank-getHp() 0) { // 游戏结束 showGameOver(tank-getPlayerId() 1 ? 2 : 1); } break; } } } }getOwnerId()和getPlayerId()的比对是防止自伤的关键。坦克初始 HP 设为 3每次被击中减 1减到 0 时对方获胜。showGameOver里暂停游戏逻辑在uiLayer上显示获胜方。这里有个细节子弹销毁后要从bullets容器里移除但如果在遍历bullets的过程中直接erase会导致迭代器失效。我的做法是先把alive标记为 false在下一帧的updateBullets里统一清理。这样虽然有一帧的延迟但逻辑更安全。4.4 射击冷却防止按住射击键无限连发如果不加冷却按住空格键每帧都会创建一颗子弹60 帧就是每秒 60 颗屏幕瞬间被子弹填满。我加了一个简单的冷却计时// 在 GameScene 里维护每个玩家的射击冷却 float shootCooldown[2] {0.0f, 0.0f}; const float SHOOT_INTERVAL 0.5f; // 0.5 秒一发 void GameScene::handleShooting(float dt) { shootCooldown[0] - dt; shootCooldown[1] - dt; if (pressedKeys.count(EventKeyboard::KeyCode::KEY_SPACE) shootCooldown[0] 0) { auto bullet Bullet::create(1, tanks[0]-getDirection(), tanks[0]-getPosition()); if (bullet) { bulletLayer-addChild(bullet); bullets.push_back(bullet); shootCooldown[0] SHOOT_INTERVAL; } } if (pressedKeys.count(EventKeyboard::KeyCode::KEY_ENTER) shootCooldown[1] 0) { auto bullet Bullet::create(2, tanks[1]-getDirection(), tanks[1]-getPosition()); if (bullet) { bulletLayer-addChild(bullet); bullets.push_back(bullet); shootCooldown[1] SHOOT_INTERVAL; } } }SHOOT_INTERVAL设为 0.5 秒即每秒最多两发。这个节奏让玩家需要瞄准而不是无脑扫射。如果你想让游戏更爽快可以调到 0.3想更策略化就调到 0.8。冷却时间直接决定了对战的节奏感建议在 demo 里多试几个值。5. 避坑与排查双人坦克 demo 最容易翻车的五个地方5.1 子弹穿透薄墙碰撞检测的帧间跳跃问题现象子弹速度调到 400 以上时偶尔会直接穿过砖墙墙没被摧毁子弹也没消失。原因子弹每帧移动距离 速度 × dt。60 帧下 dt 约 0.0167 秒400 速度每帧移动 6.7 像素。如果墙的碰撞盒只有 40 像素宽理论上不会穿透。但如果某一帧卡顿导致 dt 变大比如 0.05 秒子弹一帧移动 20 像素就可能从墙的一侧跳到另一侧而碰撞检测只检查最终位置不检查路径。解决用射线检测或者分步移动。简单做法是把子弹的移动拆成多个小步每步不超过 4 像素void Bullet::update(float dt) { if (!alive) return; float totalDist speed * dt; float step 4.0f; int steps std::max(1, (int)(totalDist / step)); float stepDist totalDist / steps; for (int i 0; i steps; i) { Vec2 pos getPosition(); switch (direction) { case 0: pos.y stepDist; break; case 1: pos.y - stepDist; break; case 2: pos.x - stepDist; break; case 3: pos.x stepDist; break; } setPosition(pos); if (checkWallCollision()) { destroy(); return; } } }这样即使 dt 波动子弹也不会跳过墙体。代价是每帧多几次碰撞检测但子弹数量不多性能完全没问题。5.2 双人按键冲突同时按下多个键时移动方向错乱现象玩家 1 按住 W 和 D坦克斜向移动但松开 W 后坦克继续斜向移动直到松开 D 才恢复。原因move方法里用了else if同一时间只处理一个方向。但pressedKeys里同时存在 W 和 D代码按顺序检查W 先命中就只处理 WD 被忽略。松开 W 后D 还在pressedKeys里下一帧就处理 D。这本身没问题但如果你在move里改了direction而射击用的是direction就会出现坦克朝向和移动方向不一致。解决把移动和朝向分开。移动用独立的逻辑处理朝向只在射击时更新void Tank::move(float dt, const std::setEventKeyboard::KeyCode keys) { Vec2 pos getPosition(); float dx 0, dy 0; if (playerId 1) { if (keys.count(EventKeyboard::KeyCode::KEY_W)) dy speed * dt; if (keys.count(EventKeyboard::KeyCode::KEY_S)) dy - speed * dt; if (keys.count(EventKeyboard::KeyCode::KEY_A)) dx - speed * dt; if (keys.count(EventKeyboard::KeyCode::KEY_D)) dx speed * dt; } // ... 玩家 2 同理 // 归一化斜向速度 if (dx ! 0 dy ! 0) { dx * 0.707f; dy * 0.707f; } setPosition(pos.x dx, pos.y dy); }用独立的if而不是else if支持斜向移动。归一化系数 0.707 是 1/√2保证斜向速度和直线速度一致。朝向在射击时根据当前按键单独判断不影响移动。5.3 节点层级错乱子弹被地图遮挡现象子弹飞过砖墙区域时突然消失但墙没被摧毁。原因子弹添加到了mapLayer而不是bulletLayer或者bulletLayer的 zOrder 比mapLayer小。cocos2d-x 按 zOrder 渲染zOrder 小的先画会被后画的覆盖。解决检查addChild的 zOrder 参数。子弹必须加到bulletLayer且bulletLayer的 zOrder 要大于mapLayer和tankLayer。我习惯在init里显式设置this-addChild(mapLayer, 0); this-addChild(tankLayer, 10); this-addChild(bulletLayer, 20); this-addChild(uiLayer, 30);zOrder 之间留出间隔方便以后在中间插入新的 Layer。比如以后要加爆炸特效层可以放在 15在坦克和子弹之间。5.4 内存泄漏子弹和墙体移除后未释放现象游戏运行几分钟后帧率下降内存占用持续上升。原因removeFromParent()只是把节点从场景树移除如果没有正确处理引用计数节点可能不会被释放。cocos2d-x 用引用计数管理内存addChild会增加引用计数removeFromParent会减少但如果你在容器里还持有指针引用计数不会归零。解决子弹销毁时从bullets容器移除墙体销毁时从mapLayer移除后不要再持有指针。用autorelease创建的节点由自动释放池管理不需要手动delete。关键是容器里的指针要及时清理// 子弹销毁后从容器移除 bullets.erase(std::remove_if(bullets.begin(), bullets.end(), [](Bullet* b) { return !b-isAlive(); }), bullets.end());墙体不需要额外容器管理removeFromParent后引用计数归零自动释放。如果你发现内存不降检查是不是在某个地方retain了但没有release。5.5 游戏结束后逻辑未暂停坦克还能移动现象一方 HP 归零后显示胜利提示但坦克还能继续移动和射击。原因showGameOver只显示了 UI没有暂停update里的逻辑。解决加一个gameOver标志位在update开头检查void GameScene::update(float dt) { if (gameOver) return; handleShooting(dt); for (auto tank : tanks) { Vec2 oldPos tank-getPosition(); tank-move(dt, pressedKeys); if (checkTankCollision(tank, tank-getPosition())) { tank-setPosition(oldPos); } } updateBullets(dt); checkBulletTankCollision(); }gameOver设为 true 后所有游戏逻辑停止但 UI 层的动画和按钮仍然可以响应。如果你想让玩家能重新开始在uiLayer上加一个按钮点击后重置gameOver和所有状态。6. 进阶技巧用状态机和数据驱动把 demo 变成可扩展的原型6.1 用状态机管理坦克行为现在的坦克只有移动和射击两个行为逻辑直接写在update里还能应付。但如果你想加道具、加 AI 敌人、加复活无敌时间代码会迅速膨胀。我的做法是引入一个极简状态机enum class TankState { Idle, Moving, Shooting, Dead }; class Tank : public cocos2d::Sprite { public: void changeState(TankState newState) { if (state newState) return; onExitState(state); state newState; onEnterState(state); } private: TankState state TankState::Idle; void onEnterState(TankState s) { switch (s) { case TankState::Dead: this-setVisible(false); break; case TankState::Shooting: // 播放射击动画 break; default: break; } } void onExitState(TankState s) { switch (s) { case TankState::Dead: this-setVisible(true); break; default: break; } } };状态机的价值在于把「进入状态时做什么」和「退出状态时做什么」集中管理。比如死亡状态要隐藏坦克、禁用输入、播放爆炸特效复活状态要重置位置、恢复 HP、给 2 秒无敌时间。这些逻辑如果散落在update里改起来很容易漏。6.2 数据驱动把地图和参数抽到 JSONdemo 阶段地图写死在代码里没问题但如果你想快速试不同地图布局每次改代码重新编译太慢。把地图数据抽到 JSON 文件运行时加载{ mapWidth: 13, mapHeight: 13, tileSize: 40, tiles: [ [2,2,2,2,2,2,2,2,2,2,2,2,2], [2,0,0,0,0,0,0,0,0,0,0,0,2], [2,0,1,0,1,0,1,0,1,0,1,0,2], [2,0,0,0,0,0,0,0,0,0,0,0,2], [2,0,1,0,1,0,1,0,1,0,1,0,2], [2,0,0,0,0,0,0,0,0,0,0,0,2], [2,0,1,0,1,0,1,0,1,0,1,0,2], [2,0,0,0,0,0,0,0,0,0,0,0,2], [2,0,1,0,1,0,1,0,1,0,1,0,2], [2,0,0,0,0,0,0,0,0,0,0,0,2], [2,0,1,0,1,0,1,0,1,0,1,0,2], [2,0,0,0,0,0,0,0,0,0,0,0,2], [2,2,2,2,2,2,2,2,2,2,2,2,2] ], tankSpeed: 120, bulletSpeed: 300, shootInterval: 0.5, maxHp: 3 }加载用 cocos2d-x 自带的FileUtils和rapidjson#include json/rapidjson.h #include json/document.h void GameScene::loadConfig(const std::string filename) { std::string content FileUtils::getInstance()-getStringFromFile(filename); rapidjson::Document doc; doc.Parse(content.c_str()); if (doc.HasParseError()) { CCLOG(JSON parse error: %s, filename.c_str()); return; } TILE_SIZE doc[tileSize].GetInt(); // ... 读取其他参数 }数据驱动的好处是改参数不用重新编译。你可以把 JSON 文件放在Resources目录用文本编辑器改完直接运行看效果。对于玩法验证阶段这个效率提升非常明显。6.3 验证玩法是否成立三个可量化的指标demo 跑起来只是第一步真正要验证的是「这个玩法好不好玩」。我一般会看三个指标指标测量方式健康范围平均对局时长从开始到一方 HP 归零的时间30-90 秒射击命中率命中次数 / 总射击次数20%-40%移动/射击时间比移动帧数 / 射击帧数2:1 到 4:1对局时长太短说明伤害太高或地图太小太长说明节奏拖沓。命中率太低说明子弹速度慢或地图掩体太多太高说明掩体太少或子弹太快。移动/射击时间比反映玩家的行为倾向如果射击时间远超移动说明游戏变成了站桩对射缺少走位博弈。我在 demo 里加了一个简单的统计输出每局结束后在控制台打印这三个值。改参数后跑几局看指标是否落在健康范围。这比凭感觉调参靠谱得多。6.4 我踩过的最大的坑不要过早优化最后说一个血泪教训。我在第一版 demo 里花了两天时间做对象池管理子弹、做四叉树优化碰撞检测、做帧同步准备联机。结果玩法验证下来发现双人同屏对战的核心问题是「屏幕太小两个玩家互相看不到对方的位置」而不是性能。如果一开始就用最笨的写法——每颗子弹new一个节点、每帧遍历所有墙体——半天就能跑起来然后花一天时间调地图大小和摄像机跟随玩法可能就成立了。所以我的习惯是demo 阶段只写能跑通的最简代码性能问题等玩法验证通过再解决。cocos2d-x 在几十个节点的情况下性能完全够用真正需要优化的时候你已经知道瓶颈在哪了。希望这个思路能帮到你少走一些我走过的弯路。本文还有配套的精品资源点击获取
![You Don‘t Know JS Yet（Objects Classes）：深入对象机制 —— 属性描述符、对象子类型与 `[[Prototype]]` 原型链](http://pic.xiahunao.cn/yaotu/You Don‘t Know JS Yet（Objects Classes）：深入对象机制 —— 属性描述符、对象子类型与 `[[Prototype]]` 原型链)
