HandyCafe Docs
owner it-admin

如何配置客户端桌面

本指南将带您完成应用菜单的构建、视觉主题的应用、待机画面的设置以及公告的发布。您在服务端所做的每一项更改都会通过 TCP 实时推送到已连接的客户端。

如何构建应用菜单

应用菜单是顾客在使用时段中交互的界面。它按分类组织，每个分类包含一个或多个应用。您可以从服务端管理整个应用目录。

前提条件

  • HandyCafe Server 正在运行，且至少有一台客户端已连接。
  • 客户端 PC 上已安装相应的可执行文件（适用于游戏和应用类型）。
  • 图标图片（PNG、JPG 或 WebP）已准备好上传，建议尺寸为 128x128 像素。

操作步骤

  1. 打开 HandyCafe Server 应用，点击左侧边栏中的设置。
  2. 选择顶部的客户端标签页，然后切换到内容子标签页。
  3. 在左侧的分类面板中，点击添加分类按钮。
  4. 输入分类名称（例如"游戏"或"浏览器"），并确认。新分类将出现在列表中。
  5. 选择刚刚创建的分类，在右侧面板中点击添加应用。
  6. 填写应用详情。输入名称（例如"Counter-Strike 2"）、可选的描述，并将类型设置为合适的类别：游戏、浏览器、链接、文件或应用。
  7. 在可执行文件路径字段中，输入客户端 PC 上应用的完整路径。例如：C:\Program Files\Steam\steamapps\common\CS2\cs2.exe。对于链接类型，请改为输入 URL。
  8. 点击图标区域上传图标。您可以粘贴 URL 从网络获取图片，或浏览本地文件。图标将显示在客户端应用网格中。
  9. 可选择上传海报图片以获得更丰富的视觉卡片。这是在"海报优先"显示模式下展示的大型图稿。您还可以启用轮播横幅开关，将此应用展示在客户端桌面顶部的滚动横幅中。
  10. 拖动分类列表或应用列表中的项目进行重新排序。点击任意应用旁边的可见性开关可隐藏应用而不删除。完成后点击保存。

预期结果

所有已连接的客户端桌面将在几秒内更新。新分类和应用将出现在客户端应用网格中。顾客可以点击卡片启动应用。

常见错误

  • 输入了客户端 PC 上不存在的路径。应用卡片会显示，但启动会失败。请务必在实际客户端机器上验证可执行文件路径。
  • 修改后忘记保存。未保存的编辑不会推送到客户端。
  • 使用未压缩的超大图片。虽然任何分辨率都可以使用，但大于 512x512 的图片会降低同步速度，在卡片尺寸下也没有视觉上的提升。

如何设置桌面主题

主题控制活跃时段中客户端桌面的整体外观。您可以选择颜色主题、布局预设、卡片密度和背景设置。

前提条件

  • HandyCafe Server 正在运行。
  • 对于图片或视频背景：PNG、JPG、WebP、MP4 或 WebM 格式的媒体文件。

操作步骤

  1. 导航至设置 > 客户端 > 外观标签页。
  2. 在主题下，选择可用的颜色主题之一：霓虹竞技场（蓝紫电竞风格）、绯红脉冲（红黑色调）或翡翠深度（绿青配色）。选择时预览会实时更新。
  3. 在布局预设下，选择内容在屏幕上的排列方式。选项包括：经典分栏（左侧分类，右侧应用）、英雄宽顶（顶部大型轮播横幅，下方显示应用）、目录宽底（紧凑型横幅，更宽的应用网格）或紧凑焦点（最小化界面，最大化应用空间）。
  4. 设置卡片密度以控制屏幕上同时显示的应用数量。大号显示更大的卡片，包含更多细节；中号平衡大小与数量；紧凑每行显示最多的应用。
  5. 配置背景。选择类型：纯色（选择颜色）、渐变（选择两种颜色）、图片（上传文件）或视频（上传 MP4/WebM）。对于图片和视频类型，调整遮罩透明度滑块以加深卡片后面的背景，以及模糊滑块以柔化背景。
  6. 点击保存。主题将立即推送到所有已连接的客户端。

预期结果

客户端桌面将以新的视觉设置刷新。主题、布局、卡片大小和背景将全部更新，无需重启客户端。

常见错误

  • 使用文件过大的视频背景。请将视频控制在 20 MB 以内以实现快速同步。时长较长或分辨率较高的视频会在客户端 PC 上造成明显的加载时间。
  • 将复杂背景图片的遮罩透明度设置得太低。文字和卡片标签会变得难以阅读。40-60% 的遮罩适用于大多数图片。

如何配置待机画面

待机画面是 PC 未使用时顾客看到的界面。它可以显示图片或视频幻灯片、时钟以及您的网吧名称。

前提条件

  • 图片文件（PNG、JPG、WebP 或 GIF）或视频文件（MP4、WebM）用于幻灯片。
  • HandyCafe Server 正在运行。

操作步骤

  1. 导航至设置 > 客户端 > 待机画面标签页。
  2. 打开启用幻灯片开关。
  3. 点击添加媒体上传图片或视频。您可以添加多个项目。支持的格式为 PNG、JPG、WebP、GIF、MP4 和 WebM。
  4. 设置每个项目的显示时长（秒）。这控制每张幻灯片在切换前保持可见的时间。对于大多数设置，8 到 15 秒的值效果较好。
  5. 选择过渡效果：淡入淡出（平滑的透明度渐变）、滑动（水平滑动）或缩放（缩放进入效果）。
  6. 启用时钟叠加开关以在待机画面上显示数字时钟。使用颜色选择器设置时钟文字颜色，以便与幻灯片内容形成最大对比度。
  7. 启用网吧名称开关以在待机画面上显示您的商家名称。名称从您的服务端常规设置中获取。
  8. 点击保存。待机画面配置将推送到所有已连接的客户端。

预期结果

不在活跃时段中的客户端 PC 将显示配置了过渡效果、时钟叠加和网吧名称的幻灯片。幻灯片将持续循环播放。

常见错误

  • 添加过多高分辨率图片而不考虑同步时间。每个媒体文件都必须传输到每台客户端。请将幻灯片总大小控制在合理范围内。
  • 将显示时长设置得过短（低于 3 秒）。快速切换会让人感到不适，也使幻灯片中的文字难以阅读。
  • 未针对所有幻灯片图片测试时钟颜色。白色时钟在亮白色幻灯片上是不可见的。请选择适用于整个幻灯片集的颜色。

如何创建公告

公告会出现在客户端桌面上，可以宣传活动、分享新闻或展示广告。系统会自动追踪展示次数和点击次数。

前提条件

  • HandyCafe Server 正在运行，且至少有一台客户端已连接。
  • 横幅图片（建议宽度为 1200x400 像素或更宽），如果您需要视觉公告。

操作步骤

  1. 导航至设置 > 客户端 > 内容标签页。
  2. 向下滚动到应用分类下方的公告部分。
  3. 点击添加公告。
  4. 为公告输入标题和正文。如果链接到外部页面，请输入链接 URL。
  5. 设置类型字段。选择公告用于一般新闻，活动用于带有互动表单字段的限时促销，或文字用于简单的纯文字消息。
  6. 设置分类以对公告进行分类：链接、游戏、公告或广告。这决定了公告在客户端布局中的显示位置。
  7. 点击图片区域并选择文件上传横幅图片。横幅将显示在客户端桌面的公告栏中。点击保存。

预期结果

公告将出现在已连接客户端桌面的公告栏中。当顾客浏览并与之交互时，服务端会追踪展示次数（显示次数）和点击次数（顾客点击次数）。

常见错误

  • 创建没有横幅图片的公告。没有图片的纯文字公告在公告栏中容易被顾客忽略。
  • 忘记设置到期时间或删除过期公告。保持活跃的旧促销信息会带来不好的顾客体验。
  • 在公告正文中使用过长的文字。展示区域较为紧凑，请保持文字简洁，将详情放在链接后面。