资料来源、版本与事实边界
本手册把稳定原理、引擎版本行为、平台规则与教学方案分开记录。阅读时先判断一条结论属于哪一类,再决定能否直接使用。一本教材能解释思路,但你实际发布时仍需要核对当前项目、账号和构建目标。
四类内容怎样使用
| 类型 | 示例 | 使用方式 |
|---|---|---|
| 稳定原理 | 速度乘以时间、AABB 相交、状态机 | 理解推导与假设,检查坐标和单位 |
| 版本行为 | Cocos 生命周期、构建参数、Spine 兼容 | 对照本项目引擎与插件版本 |
| 平台条件 | 微信 API、广告/支付准入、审核 | 以发布时官方文档与实际后台为准 |
| 教学决策 | 三波试炼、伤害数值、示例预算 | 作为可验证例子,不当作商业最佳值 |
各章末尾提供对应一手资料。核查日期表示资料核对时间,不代表平台承诺长期不变。无法访问官方页面时,章节会说明采用了官方类型定义或源代码交叉确认,不能由类型存在推断账号一定可调用。
本次已读取微信分包加载、激励广告服务端验证、虚拟支付技术手册与小游戏接入指南的官方原文。相应章节区分包体规则、接口机制和项目接入状态;账号准入、后台开通与设备表现仍需各自证据。
实现与工具基线
- 文档站:Docusaurus 3.10.2、React 19、TypeScript 5.9;依赖由 lockfile 固定。
- 引擎教学:Cocos Creator 3.8.8。优先查 3.8 LTS 手册,并针对具体 API 查该版本源码。
- 语言:TypeScript;网页实验使用 Canvas 2D,规则逻辑与表现分开。
- 微信开发者工具:本机核查产品版本 2.02.2609250。Electron 运行时版本不是产品版本。
- 核查基准日:2026-11-17,Asia/Shanghai。实际构建记录见验证报告。
后端、商业 SDK、支付与广告能力采用机制说明和接入检查单,教学案例不存放 AppSecret、生产凭据或用户账号信息。
主要一手资料入口
| 领域 | 入口 | 核对重点 |
|---|---|---|
| Cocos | Creator 3.8 手册 | 项目、渲染、物理、资源与发布 |
| 引擎实现 | cocos-engine v3.8.8 | 手册与实际实现出现差异时追踪版本 |
| 微信 | 小游戏开发文档 | 运行环境、能力、基础库和发布要求 |
| 微信接口 | 官方小游戏 API 类型定义 | API 签名与回调,不代替平台准入政策 |
| Web API | MDN Canvas、Web Audio | 网页实验的运行机制 |
| 物理 | Box2D 文档 | 原理参考;版本特性不能直接套到 Cocos |
| 动画 | Spine 官方文档 | 导出/运行时匹配与授权 |
| 地图 | Tiled 手册 | 地图格式、图块与对象层 |
| 语言 | TypeScript 手册 | 类型与运行时的边界 |
| 游戏设计 | MDA 原论文 | 机制、运行动态与体验的关系 |
| 站点 | Docusaurus 文档 | MDX、侧栏、静态构建与图解 |
| 发布 | GitLab CI/CD | 受保护分支、产物和部署变量 |
哪些证据不能互相替代
浏览器实验可以证明规则和网页实现的行为。Cocos Web 构建可以证明该目标的资源与引擎初始化。微信构建产物可以证明构建链路。开发者工具运行可以检查一部分平台接口和模拟器行为。真机需要验证触控、后台恢复、内存、性能、声音和真实平台能力。
因此,本手册不会把一个“通过”扩展到其他环境。某次测试发现的问题只描述已覆盖场景;设备、微信版本和基础库改变后,要有相应复验。API 文档存在、调用成功、用户权益到账,也分别属于不同证据。
用 AI 查资料时怎样避免失真
要求 AI 给出具体版本、直接链接和支持结论的段落位置。再打开原文,检查它是否回答同一个问题。尤其留意“Web 支持”被改写成“微信小游戏可直接发布”、“存在支付接口”被改写成“当前主体与系统都允许付费”等跳跃。
请验证这条平台结论:<粘贴结论>。
给出:直接官方URL、适用引擎/基础库版本、核查日期、账号/系统条件。
分别标注官方明确说明、你的工程推断、仍未知的部分。
如果只有类型签名或第三方经验,不把它写成当前政策。
如果资料冲突,保存两条来源、版本与复现结果,先缩小到实际项目使用的行为。你自己的最小复现和官方源码,通常比搜索摘要更能帮助定位问题。