客户端菜单

客户端菜单是顾客在电竞馆或电竞中心活跃时段期间在桌面上看到的应用启动器。它提供由服务端管理的层级结构，以分类包含应用的形式组织，让您完全控制向顾客提供的软件和内容。

分类管理

分类是客户端菜单的顶层组织单元。每个分类将相关应用分组，便于浏览。

• 创建分类，包含名称、图标和可选描述。
• 重新排序分类，拖拽到目标位置。排序顺序持久化并同步到所有已连接客户端。
• 可见性开关，允许您将分类从客户端桌面隐藏而不删除。隐藏的分类及其应用不会向顾客显示。
• 图标，可为每个分类指定图标，在启动器中提供视觉标识。

应用管理

分类中的每个应用代表客户端桌面上的一个可启动项目。应用支持以下配置：

• 名称和描述 -- 在启动器中向顾客展示。
• 应用类型 -- 决定应用的启动方式：
  • 游戏 -- 客户端 PC 上的游戏可执行文件。
  • 浏览器 -- 在客户端浏览器中打开 URL。
  • 链接 -- 打开外部链接。
  • 文件 -- 启动本地文件。
  • 应用 -- 运行标准应用程序可执行文件。
• 可执行路径或启动 URI -- 用于启动应用的文件路径或 URL。
• 图标和海报图片 -- 用于应用外观的视觉媒体文件。图标在紧凑视图中显示，海报在详细和网格视图中显示。
• 排序位置 -- 分类内的应用可通过指定排序位置来重新排列。

主推轮播

符合条件的应用可以出现在主推轮播中，在客户端桌面顶部展示大型推广横幅。将应用标记为可推荐后，它将以轮播横幅的形式吸引顾客关注推荐内容。

商店集成

应用可以关联到外部商店平台以获取元数据和启动功能：

• 平台 -- 商店平台（如 Steam、Epic Games）。
• 应用 ID -- 外部平台上的标识符。
• 启动 URI -- 通过商店客户端启动应用的协议 URI。
• 商店 URL -- 指向应用商店页面的链接。

IGDB 游戏元数据

添加游戏时，可以搜索 IGDB（互联网游戏数据库）来自动填充游戏信息，包括名称、描述、封面图等元数据。这在构建游戏目录时节省时间，并确保信息准确一致。

快速启动栏

快速启动栏在客户端桌面顶部显示固定的收藏应用，供一键访问。顾客无需浏览分类即可快速找到最热门或最常用的应用。

实时同步

所有菜单修改会立即推送到已连接的客户端。当您创建、编辑、重新排序或切换任何分类或应用的可见性时，服务端通过 TCP 调用 push_client_menu_to_connected_clients()。变更会立即出现在所有已连接客户端桌面上，无需重启或手动刷新。