跳到主要内容

资料来源、版本与事实边界

本手册把稳定原理、引擎版本行为、平台规则与教学方案分开记录。阅读时先判断一条结论属于哪一类,再决定能否直接使用。一本教材能解释思路,但你实际发布时仍需要核对当前项目、账号和构建目标。

四类内容怎样使用​

类型示例使用方式
稳定原理速度乘以时间、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、生产凭据或用户账号信息。

主要一手资料入口​

领域入口核对重点
CocosCreator 3.8 手册项目、渲染、物理、资源与发布
引擎实现cocos-engine v3.8.8手册与实际实现出现差异时追踪版本
微信小游戏开发文档运行环境、能力、基础库和发布要求
微信接口官方小游戏 API 类型定义API 签名与回调,不代替平台准入政策
Web APIMDN Canvas、Web Audio网页实验的运行机制
物理Box2D 文档原理参考;版本特性不能直接套到 Cocos
动画Spine 官方文档导出/运行时匹配与授权
地图Tiled 手册地图格式、图块与对象层
语言TypeScript 手册类型与运行时的边界
游戏设计MDA 原论文机制、运行动态与体验的关系
站点Docusaurus 文档MDX、侧栏、静态构建与图解
发布GitLab CI/CD受保护分支、产物和部署变量

哪些证据不能互相替代​

浏览器实验可以证明规则和网页实现的行为。Cocos Web 构建可以证明该目标的资源与引擎初始化。微信构建产物可以证明构建链路。开发者工具运行可以检查一部分平台接口和模拟器行为。真机需要验证触控、后台恢复、内存、性能、声音和真实平台能力。

因此,本手册不会把一个“通过”扩展到其他环境。某次测试发现的问题只描述已覆盖场景;设备、微信版本和基础库改变后,要有相应复验。API 文档存在、调用成功、用户权益到账,也分别属于不同证据。

用 AI 查资料时怎样避免失真​

要求 AI 给出具体版本、直接链接和支持结论的段落位置。再打开原文,检查它是否回答同一个问题。尤其留意“Web 支持”被改写成“微信小游戏可直接发布”、“存在支付接口”被改写成“当前主体与系统都允许付费”等跳跃。

请验证这条平台结论:<粘贴结论>。
给出:直接官方URL、适用引擎/基础库版本、核查日期、账号/系统条件。
分别标注官方明确说明、你的工程推断、仍未知的部分。
如果只有类型签名或第三方经验,不把它写成当前政策。

如果资料冲突,保存两条来源、版本与复现结果,先缩小到实际项目使用的行为。你自己的最小复现和官方源码,通常比搜索摘要更能帮助定位问题。