美乐迪电玩大厅加载机制与 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 参数设定点击行为


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

  1. 使用 Cocos Creator 将每个子游戏打成独立的 bundle

  2. 在主工程设置:

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

  3. 将 bundle 打包并上传至远程服务器:

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

  4. 大厅热更管理器会自动检测对应 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"
}

4. 更新大厅资源路径配置(可选)

若大厅已接入动态 CDN 拉取机制,请确保 CDN 路径在 remote_config.json 中也添加 leidianzhanji 节点。


六、调试技巧与注意事项

  • 所有 icon 路径必须存在,否则实例化失败会报错

  • 若 bundle 构建后无法热更新,请确认版本号变动

  • 子游戏 Prefab 与 icon 推荐统一命名规则,便于维护

  • 子游戏资源中不要引用主工程资源,避免依赖错乱


小结

通过 roomlist.json + 动态 bundle 架构,美乐迪电玩的大厅实现了模块化加载、按需接入、热更新分发等多种场景的适配,为多子游戏平台构建提供了高扩展性的基础设施。下一篇我们将进入服务器层,逐步剖析游戏状态同步与发卡查分模块的完整实现。

相关推荐
老华带你飞1 小时前
口腔助手|口腔挂号预约小程序|基于微信小程序的口腔门诊预约系统的设计与实现(源码+数据库+文档)
java·数据库·微信小程序·小程序·论文·毕设·口腔小程序
尸僵打怪兽1 小时前
HBuilder X打包发布微信小程序
微信小程序·小程序·打包·hbuilder x
草梅友仁9 小时前
草梅 Auth 1.1.0 发布与最新动态 | 2025 年第 30 周草梅周报
开源·github·ai编程
说私域12 小时前
公域流量向私域流量转化策略研究——基于开源AI智能客服、AI智能名片与S2B2C商城小程序的融合应用
人工智能·小程序
半生过往12 小时前
微信小程序文件下载与预览功能实现详解
微信小程序·小程序·notepad++·压缩包下载解压
源码_V_saaskw12 小时前
JAVA图文短视频交友+自营商城系统源码支持小程序+Android+IOS+H5
java·微信小程序·小程序·uni-app·音视频·交友
weixin_lynhgworld15 小时前
淘宝扭蛋机小程序系统开发:重塑电商互动模式
大数据·小程序
★YUI★15 小时前
学习游戏制作记录(剑投掷技能)7.26
学习·游戏·unity·c#
Xi_Xu17 小时前
Xget:下一代开源资源获取加速引擎,让你的文件下载、储存库克隆和镜像拉取快如闪电
开源·github
不摸鱼17 小时前
创业找不到方向?不妨从行业卧底开始 | 不摸鱼的独立开发者日报(第66期)
人工智能·开源·资讯