名称: cocos2d-x 描述: 提供Cocos2d-x v4游戏引擎的全面指导,包括场景图、节点、精灵、动作、动画、物理、渲染、着色器和平台部署。当用户询问Cocos2d-x、需要创建游戏、实现游戏功能、设置开发环境或将游戏部署到多个平台时使用。 许可证: 完整条款在LICENSE.txt
何时使用此技能
每当用户想要时使用此技能:
- 创建Cocos2d-x v4游戏或应用程序
- 学习Cocos2d-x v4核心概念(节点、精灵、场景、动作)
- 设置Cocos2d-x v4开发环境
- 处理精灵、纹理、动画和标签
- 实现场景管理和节点生命周期
- 处理输入事件(触摸、鼠标、键盘)
- 使用物理引擎(Box2D)和碰撞检测
- 实现渲染管道、着色器和粒子系统
- 为多个平台构建和部署游戏(Windows、macOS、Linux、Android、iOS)
- 使用CMake构建系统和命令行工具
- 从旧版Cocos2d-x迁移
- 通过自定义渲染和脚本绑定扩展引擎
如何使用此技能
要使用Cocos2d-x v4:
-
从用户请求中识别主题:
- 引擎概述/了解引擎 →
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
- 引擎概述/了解引擎 →
-
加载适当的示例文件 从
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- 平台特定部署
-
遵循该示例文件中的具体说明 用于语法、结构和最佳实践
每个示例文件包含:
- 说明: 概述和使用指南
- 语法: API语法和参数
- 示例: 完整代码示例和解释
- 参考: 官方文档链接
-
生成C++代码 遵循Cocos2d-x v4约定:
- 使用
USING_NS_CC;用于命名空间 - 使用
CREATE_FUNC()宏用于创建函数 - 遵循Cocos2d-x命名约定
- 包含适当的错误处理
- 在适当处使用智能指针
- 使用
-
参考官方文档:
- 官方手册: https://docs.cocos.com/cocos2d-x/v4/manual/zh/
- API参考: 查看
api/目录获取详细API文档 - 示例: 查看
examples/目录获取代码示例
-
使用模板 当创建新项目时:
templates/project-structure.md- 标准项目结构templates/cmake-config.md- CMake配置示例
文档映射(与官方文档一对一)
- 查看示例和API文件 → https://docs.cocos.com/cocos2d-x/v4/manual/zh/
核心概念
节点系统
- 节点: 所有显示对象的基类
- 场景: 场景图的根节点
- 精灵: 图像显示节点
- 标签: 文本显示节点
- 节点层次: 父子关系
坐标系统
- 原点在左下角(OpenGL风格)
- 锚点用于定位
- 局部和世界坐标
动作系统
- 动作: 节点变换的基类
- 序列: 链接多个动作
- 同时执行: 同时运行动作
- 重复: 重复动作多次
- 缓动: 应用缓动函数
场景管理
- 场景过渡
- 场景生命周期(onEnter, onExit)
- Director用于场景管理
输入处理
- 触摸事件(单点和多点触摸)
- 鼠标事件
- 键盘事件
- 事件分发器系统
平台支持
Cocos2d-x v4支持:
- 桌面: Windows, macOS, Linux
- 移动: Android, iOS
- 网页: (通过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, 游戏框架, 游戏引擎, 游戏开发, 精灵, 场景, 节点, 动作, 动画, 物理引擎, 渲染, 着色器, 粒子系统
重要注意事项
- 版本: 此技能专门涵盖Cocos2d-x v4
- 语言: C++是主要开发语言
- 构建系统: 需要CMake构建项目
- 平台: 确保安装平台特定依赖
- 示例: 所有代码示例使用C++语法
- 内存管理: Cocos2d-x使用引用计数,小心retain/release循环
- 坐标系统: 使用OpenGL风格坐标(原点在左下角)
- 线程安全: 大多数Cocos2d-x操作必须在主线程执行