游戏引擎接入指南
本文档是游戏引擎接入的父页面，用于说明 MiniGame 支持的通用接入模型，以及 Cocos Creator、Laya、Unity 等引擎的专属适配入口。
1. 适用范围
MiniGame 面向主流 HTML5 和跨端游戏工程提供统一接入能力。不同引擎在构建产物、脚本运行时、资源管理、生命周期和平台桥接方式上存在差异，因此平台在通用 SDK 能力之上，为常见引擎提供了更贴合工程习惯的专属适配。
当前文档结构下，具体引擎接入请参考：
| 引擎 | 子文档 | 适用项目 |
|---|---|---|
| Cocos Creator | Cocos Creator插件SDK接入指南 | 使用 Cocos Creator 构建 H5 或小游戏产物的项目 |
| Laya | Laya接入指南 | 使用 LayaAir 或 Laya 相关工作流的项目 |
| Unity | Unity接入指南 | 使用 Unity 构建 WebGL、H5 或需要平台适配的项目 |
2. 通用接入模型
无论使用哪一种引擎，接入过程通常都包含以下环节：
创建游戏项目并获取平台分配的游戏标识、环境配置和必要密钥。
在游戏启动阶段完成 SDK 或平台桥接层初始化。
将游戏生命周期与平台生命周期对齐，包括启动、暂停、恢复、关闭和异常重试。
按需接入账号、分享、广告、支付、排行榜、数据上报等能力。
在构建阶段按目标平台调整资源路径、加载策略、包体结构和兼容配置。
通过测试环境完成联调，再提交正式环境审核。
3. 引擎适配差异
3.1 Cocos Creator
Cocos Creator 项目通常通过插件 SDK 或工程模板完成接入。插件应尽量处理初始化配置、平台 API 封装、构建配置注入和调试辅助，减少业务代码对平台细节的直接依赖。
重点关注：
插件安装与版本兼容。
构建模板、资源路径和横竖屏配置。
TypeScript 或 JavaScript API 的调用方式。
平台回调与 Cocos 生命周期之间的衔接。
3.2 Laya
Laya 项目通常需要关注脚本桥接、资源加载路径、异步接口调用和运行时兼容。接入时应避免在业务逻辑中散落平台判断，建议通过统一适配层收敛 MiniGame 能力调用。
重点关注：
初始化入口和加载顺序。
异步回调、Promise 或事件分发模型。
资源发布目录和 CDN 路径处理。
调试环境与正式环境的配置隔离。
3.3 Unity
Unity 项目需要重点处理构建目标、WebGL 运行时、JavaScript 桥接、包体资源和平台审核要求。若游戏需要面向多个平台发行，应把平台差异封装在独立适配层中，避免污染核心玩法代码。
重点关注：
Unity 版本、构建目标和模板配置。
WebGL 与宿主平台之间的接口桥接。
首屏加载、资源分包和内存占用。
平台能力回调与 Unity 主线程逻辑的同步。
4. 推荐工程边界
游戏核心玩法不直接依赖平台 SDK，统一通过平台适配层访问外部能力。
初始化、登录、支付、广告、分享等能力保持幂等，避免重复回调造成状态错乱。
测试环境和正式环境配置分离，敏感参数不写死在可公开产物中。
平台能力失败时提供明确降级策略，避免影响基础可玩性。
对不同引擎的构建配置保留最小差异，减少多平台发行维护成本。
5. 验证清单
游戏可以在目标引擎的标准构建产物中正常启动。
SDK 初始化、环境配置和错误回调可观测。
暂停、恢复、切后台、返回、关闭等生命周期行为符合预期。
分享、广告、支付、排行榜等可选能力仅在启用时接入，并已验证异常路径。
首屏加载时间、包体大小、资源路径和缓存策略满足平台要求。
