美乐迪电玩大厅加载机制与 RoomList 配置结构分析

本篇为《美乐迪电玩全套系统搭建》系列的第三篇，聚焦大厅与子游戏的动态加载机制，深入解析 roomlist.json 的数据结构、解析流程、入口配置方式与自定义接入扩展技巧。通过本篇内容，开发者可实现自由控制子游戏接入与分发策略。

一、RoomList 的定位与作用

在美乐迪电玩项目中，大厅与子游戏采用模块解耦加载机制。核心逻辑由 roomlist.json 文件驱动，该文件定义了所有子游戏的资源路径、名称标识、加载逻辑、热更新地址等。

路径：

assets/resources/config/roomlist.json

二、RoomList.json 数据结构详解

以实际配置为例：

[{"id": 1001,"name": "水果玛丽","prefab": "ui/games/shuiguomali/prefab","bundle": "shuiguomali","icon": "icon_fruit","type": "slots","hot": true,"entry": true,"version": "1.0.3"},{"id": 1002,"name": "跳高高","prefab": "ui/games/tiaogaogao/prefab","bundle": "tiaogaogao","type": "arcade","hot": false,"entry": false,"version": "1.0.1"}
]

字段解释：

字段名	含义说明
id	游戏唯一编号，用于逻辑判断
name	展示用游戏名称
prefab	子游戏 UI 入口 Prefab 路径
bundle	对应热更新资源包名称（即子游戏目录名）
icon	显示在大厅的图标路径
type	游戏类别标签（slots、arcade等）
hot	是否在大厅显示“火爆”标识
entry	是否显示在大厅首页
version	当前子游戏版本号，用于热更新对比

三、大厅挂载流程源码解析

关键入口：HallGameLoader.ts

loadRoomList() {cc.resources.load("config/roomlist", cc.JsonAsset, (err, data) => {const list = data.json;list.forEach(item => {this.createGameEntry(item);});});
}createGameEntry(item) {cc.resources.load(item.icon, cc.SpriteFrame, (err, icon) => {const node = cc.instantiate(this.gameEntryPrefab);node.getComponent(GameEntry).init(item, icon);this.content.addChild(node);});
}

说明：

从 roomlist.json 加载所有子游戏条目
动态实例化按钮节点，根据 JSON 参数设定点击行为

四、子游戏打包与热更新配置

使用 Cocos Creator 将每个子游戏打成独立的 bundle
在主工程设置：

项目设置 -> Asset Bundle -> 创建新Bundle -> 命名与子游戏路径一致

将 bundle 打包并上传至远程服务器：

/shuiguomali/├── index.js├── config.json├── assets/

大厅热更管理器会自动检测对应 bundle/version 进行更新处理

五、扩展：新增一个子游戏

假设你要新增一个叫“雷电战机”的小游戏：

1. 构建资源包

将其项目以 bundle 形式构建，生成 leidianzhanji 目录

2. 上传远程服务器

上传路径为：https://your.cdn.com/leidianzhanji/

3. 修改 roomlist.json

{"id": 1010,"name": "雷电战机","prefab": "ui/games/leidianzhanji/prefab","bundle": "leidianzhanji","icon": "icon_jet","type": "shoot","hot": true,"entry": true,"version": "1.0.0"
}