cocos2d-x

何时使用此技能

在用户希望进行以下操作时，使用此技能：

• 创建 Cocos2d-x v4 游戏或应用程序
• 学习 Cocos2d-x v4 的核心概念（Node、Sprite、Scene、Action）
• 搭建 Cocos2d-x v4 开发环境
• 使用精灵、纹理、动画和标签
• 实现场景管理和节点生命周期
• 处理输入事件（触摸、鼠标、键盘）
• 使用物理引擎（Box2D）和碰撞检测
• 实现渲染管线、着色器和粒子系统
• 为多个平台（Windows、macOS、Linux、Android、iOS）构建和部署游戏
• 使用 CMake 构建系统和命令行工具
• 从旧版 Cocos2d-x 迁移
• 通过自定义渲染和脚本绑定扩展引擎

如何使用此技能

使用 Cocos2d-x v4：

1. 根据用户请求识别主题：

   • 引擎概览/了解引擎 → examples/getting-started/about-engine.md
   • 快速入门/快速上手 → examples/getting-started/quick-start.md
   • 安装/安装配置 → examples/getting-started/installation.md
   • 节点和场景/节点和场景 → examples/core/node-scene.md
   • 精灵/精灵 → examples/core/sprite.md
   • 纹理/纹理 → examples/core/texture.md
   • 动画/动画 → examples/core/animation.md
   • 动作/动作 → examples/core/action.md
   • 标签/标签 → examples/core/label.md
   • 场景管理/场景管理 → examples/core/scene.md
   • 输入处理/输入处理 → examples/core/input.md
   • 事件系统/事件系统 → examples/core/event.md
   • 物理/物理引擎 → examples/advanced/physics.md
   • 渲染/渲染 → examples/advanced/rendering.md
   • 着色器/着色器 → examples/advanced/shader.md
   • 粒子系统/粒子系统 → examples/advanced/particle.md
   • 构建系统/构建系统 → examples/tools/build-system.md
   • 平台部署/平台部署 → examples/tools/deployment.md

2. 从 examples/ 目录加载相应的示例文件：

   • examples/getting-started/about-engine.md - 引擎概览和功能
   • examples/getting-started/quick-start.md - 创建第一个项目
   • examples/getting-started/installation.md - 环境配置
   • examples/core/node-scene.md - 节点和场景概念
   • examples/core/sprite.md - 精灵的创建和操作
   • examples/core/texture.md - 纹理加载和管理
   • examples/core/animation.md - 动画系统
   • examples/core/action.md - 动作系统和序列
   • examples/core/label.md - 标签和文本渲染
   • examples/core/scene.md - 场景管理和切换
   • examples/core/input.md - 触摸、鼠标和键盘输入
   • examples/core/event.md - 事件系统和监听器
   • examples/advanced/physics.md - 物理引擎集成
   • examples/advanced/rendering.md - 渲染管线
   • examples/advanced/shader.md - 自定义着色器
   • examples/advanced/particle.md - 粒子效果
   • examples/tools/build-system.md - CMake 和构建配置
   • examples/tools/deployment.md - 特定平台的部署

3. 遵循该示例文件中关于语法、结构和最佳实践的具体说明

   每个示例文件都包含：

   • 说明：概述和使用指南
   • 语法：API 语法和参数
   • 示例：附有说明的完整代码示例
   • 参考资料：官方文档链接

4. 遵循 Cocos2d-x v4 规范生成 C++ 代码：

   • 使用 USING_NS_CC; 指定命名空间
   • 使用 CREATE_FUNC() 宏定义创建函数
   • 遵循 Cocos2d-x 命名规范
   • 包含适当的错误处理
   • 适当使用智能指针

5. 参考官方文档：

   • 官方手册：https://docs.cocos.com/cocos2d-x/v4/manual/zh/
   • API 参考：查看 api/ 目录中的详细 API 文档
   • 示例：查看 examples/ 目录中的代码示例

6. 创建新项目时使用模板：

   • templates/project-structure.md - 标准项目结构
   • templates/cmake-config.md - CMake 配置示例

文档映射（与官方文档一一对应）

• 查看示例和 API 文件 → https://docs.cocos.com/cocos2d-x/v4/manual/zh/

核心概念

节点系统

• 节点：所有显示对象的基类
• 场景：场景图的根节点
• 精灵：图像显示节点
• 标签：文本显示节点
• 节点层级：父子关系

坐标系统

• 原点位于左下角（OpenGL 风格）
• 用于定位的锚点
• 局部坐标和世界坐标

动作系统

• Action：节点变换的基类
• Sequence：串联多个动作
• Spawn：同时运行多个动作
• Repeat：多次重复动作
• Ease：应用缓动函数

场景管理

• 场景转换
• 场景生命周期（onEnter、onExit）
• 用于场景管理的 Director

输入处理

• 触摸事件（单点触控和多点触控）
• 鼠标事件
• 键盘事件
• 事件分发系统

平台支持

Cocos2d-x v4 支持：

• 桌面端：Windows、macOS、Linux
• 移动端：Android、iOS
• Web：（通过 Cocos Creator）

构建系统

• CMake：主要构建系统
• 命令行工具：cocos 命令
• IDE 支持：Visual Studio、Xcode、Android Studio

迁移指南

从旧版本迁移时：

• 查看 examples/migration/ 中的迁移指南
• API 变更和兼容性说明
• 从旧构建系统迁移到 CMake

参考资源

• 官方文档：https://docs.cocos.com/cocos2d-x/v4/manual/zh/
• API 参考：参见 api/ 目录
• 示例：参见 examples/ 目录
• 模板：参见 templates/ 目录

关键词

cocos2d-x, cocos2d, 游戏引擎, 游戏开发, C++ 游戏, 2D 游戏, 跨平台游戏, 精灵, 场景, 节点, 动作, 动画, 物理, 渲染, 着色器, 粒子系统, CMake, 游戏框架, 游戏引擎, 游戏开发, 精灵, 场景, 节点, 动作, 动画, 物理引擎, 渲染, 着色器, 粒子系统

重要说明

1. 版本：本技能专门介绍 Cocos2d-x v4
2. 语言：C++ 是主要开发语言
3. 构建系统：构建项目需要使用 CMake
4. 平台：确保已安装特定平台所需的依赖项
5. 示例：所有代码示例均使用 C++ 语法
6. 内存管理：Cocos2d-x 使用引用计数，请注意 retain/release 循环
7. 坐标系：采用 OpenGL 风格的坐标系（原点位于左下角）
8. 线程安全：大多数 Cocos2d-x 操作必须在主线程上执行