Cocos Creator
Cocos Creator v2.4 用户手册
欢迎使用 Cocos Creator 用户手册!本手册包括详尽的使用说明、面向不同职能用户的工作流程和 step by step 的新手教程。能够帮您快速掌握使用 Cocos Creator 开发跨平台游戏的方法。
注意:请在右上角根据您使用的 Cocos Creator 版本选择相应的手册版本。
产品线简介
Cocos(雅基软件)多年来不断发展,已经发布了多个与 Cocos Creator 密切相关的产品线。为避免混淆,以下是对这些产品的简要介绍:
- Cocos Creator 3.x:发布于 2021 年初,是当前 Cocos Creator 的最新版本,已经过大量商业项目验证。3.x 完全摒弃了 Cocos2d-x 底层,采用全新高性能跨平台 3D 内核,标志着 Cocos Creator 正式发展为全面的泛移动端 3D 游戏引擎。由于 3.x 底层已经完全重写,Cocos Creator 不再被视为 Cocos2d-x 的直接扩展和升级版本。
- Cocos Creator 2.x:发布于 2018 年,2023 年停止更新。所有能力已被 Cocos Creator 3.x 继承,因此建议新项目使用最新的 Cocos Creator 3.x。
- Cocos Creator 3D:2017 年立项,2019 年底以 Cocos Creator 3D 的身份在中国进行了一年多的小规模测试,后正式合并至 Cocos Creator 3.0。由于已被 Cocos Creator 3.x 替代且不再单独更新,提及 Cocos Creator 3D 时通常指代 Cocos Creator 本身的 3D 能力,而非此特定版本。
- Cocos2d-x:发布于 2010 年,2019 年停止更新。这是 Cocos2d 社区最活跃的分支,Cocos Creator 2.x 最初采用的底层运行时便是升级过后的 Cocos2d-x。
- Cocos:当 Cocos 作为引擎的名字单独出现时,通常代表 Cocos Creator 3.x,而不是 Cocos2d-x。
经过多年的快速发展,Cocos Creator 3.x 与 Cocos Creator 2.x 在用法上已经有所不同,二者的 API 也不完全兼容。因此,在查阅文档、API 和教程时,请开发者注意辨别目标版本是 2.x 还是 3.x,以免因版本不一致导致错误。
特别推荐
- 从 v2.4.11 开始,Cocos Creator 支持发布到 淘宝小程序创意互动。
- 从 v2.4.2 开始,Cocos Creator 支持发布到 字节跳动小游戏。
- 从 v2.4.1 开始,Cocos Creator 支持发布到 HUAWEI AppGallery Connect。
- 从 v2.4.0 开始,Cocos Creator 重写了资源管理模块,兼容了大部分原有的 API。除个别项目使用了无法兼容的特殊用法的 API 必须手动升级外,大部分项目都可以照常运行。建议开发者都升级到最新的资源管理模块。详情请查阅 v2.4 资源管理模块升级指南 和 v2.4 资源分包升级指南。
- 从 v2.4.0 开始,Cocos Creator 正式支持了 Asset Bundle,提供了更强大的远程资源加载能力、子项目动态加载能力,并进一步减小了首包的大小。详情请查阅 Asset Bundle。
- 从 v2.4.0 开始,编辑器的构建流程将以 Asset Bundle 为单元。如果开发者在 v2.4 之前有在编辑器中使用插件扩展了构建流程,则需要对部分 API 的使用进行升级。详情请查阅 定制构建流程升级指南。
- 从 v2.3.0 开始,Cocos Creator 新增了对 3D 物理与碰撞系统、3D 粒子 的支持,同时 材质系统 也升级到了正式版。
- Spine 换装指南。
- DragonBones 换装指南。
- 从 v2.1.4 开始,Cocos Creator 支持发布到 支付宝小游戏。
- 从 v2.1 开始,Cocos Creator 引入了 3D 的支持。详情请查阅 3D 节点。
- 从 v2.0.10 开始,Cocos Creator 支持发布到 小米快游戏 及 Cocos Play。
- 从 v2.0.9 开始,Cocos Creator 支持发布到 百度小游戏。
- 从 v2.0.7 开始,Cocos Creator 支持发布到 华为快游戏。
- 从 v2.0.5 开始,Cocos Creator 支持发布到 OPPO 小游戏 及 vivo 小游戏。
- 从 v2.0.4 开始,Cocos Creator 支持发布到 Google Play Instant。
- v2.0 升级指南
- 从 v1.10 开始,Cocos Creator 对底层资源类型进行了重构,绝大多数项目不受影响,但有些项目可能会收到一些警告,详情请查阅 v1.10 资源升级指南。
总导读
- Cocos Creator 入门
- 资源工作流程
- 场景制作工作流程
- 脚本开发指南
- 发布跨平台游戏
- 图像和渲染
- UI 系统
- 动画系统
- 音乐和音效
- 2D 物理和碰撞系统
- 3D 系统
- 3D 物理与碰撞系统
- 扩展编辑器
- 进阶主题
- SDK 集成
视频教程
前往 视频教程 页面。
演示和范例项目
- 范例集合(GitHub | Gitee):从基本的组件到交互输入,这个项目里包括了 case by case 的功能点用法介绍。
- Star Catcher(GitHub | Gitee):也就是 快速上手 文档里分步讲解制作的游戏。
- 腾讯合作开发的 21 点游戏(GitHub | Gitee)
- UI 展示 Demo(GitHub | Gitee)
- 暗黑斩 Cocos Creator 复刻版(GitHub | Gitee):由 Veewo Games 独家授权原版暗黑斩资源素材,在 Cocos Creator 里复刻的演示项目。
注意:这些项目会不定期跟随版本进行更新。它们在 GitHub 上的默认分支是 master,对应的一般是最新的 Cocos Creator 版本。如果仍在使用旧版本的 Cocos Creator,这些项目有可能会打不开,可尝试切换到和旧版本相同命名的分支。