HandyCafe Docs
owner it-admin

如何配置客户端桌面

本指南将指导您如何构建客户在其PC上看到的应用菜单、应用视觉主题、设置空闲屏幕以及发布公告。您在服务器上所做的每一个更改都会通过TCP即时推送到连接的客户端。

如何构建应用菜单

应用菜单是客户在其会话期间与之交互的界面。它被组织成多个分类，每个分类包含一个或多个应用。您可以从服务器管理整个目录。

您需要准备的

  • HandyCafe服务器正在运行，并至少连接了一个客户端。
  • 客户端PC上已安装应用可执行文件（适用于游戏和应用类型）。
  • 图标图像（PNG, JPG或WebP）已准备好上传。推荐尺寸为128x128像素。

步骤

  1. 打开HandyCafe服务器应用，导航到左侧边栏的设置。
  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服务器正在运行。
  • 对于图像或视频背景：媒体文件格式为PNG, JPG, WebP, MP4或WebM。

步骤

  1. 导航到设置 > 客户端 > 外观标签。
  2. 在主题下，选择一个可用的颜色主题：Neon Arena（蓝紫色游戏美学）、Crimson Pulse（红暗色调）或Emerald Depth（绿青色调）。在您选择时预览会更新。
  3. 在布局预设下，选择屏幕上内容的排列方式。选项包括分割经典（左侧分类，右侧应用）、英雄宽顶（顶部大英雄轮播，下方应用）、目录宽底（紧凑英雄，宽应用网格）或紧凑聚焦（最小化装饰，最大化应用空间）。
  4. 设置卡片密度以控制屏幕上一次显示多少应用。大显示更大的卡片，细节更多。中平衡大小和数量。紧凑每行适合最多应用。
  5. 配置背景。选择类型：纯色（选择颜色）、渐变（选择两种颜色）、图像（上传文件）或视频（上传MP4/WebM）。对于图像和视频类型，调整覆盖不透明度滑块以在卡片后面加深背景，并调整模糊滑块以柔化背景。
  6. 点击保存。主题会立即推送到所有连接的客户端。

预期结果

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

常见错误

  • 使用非常大的视频背景文件。保持视频小于20 MB以便快速同步。较长或高分辨率的视频会导致客户端PC上明显的加载时间。
  • 在繁忙的背景图像上设置过低的覆盖不透明度。文本和卡片标签会变得难以阅读。对于大多数图像，40-60%的覆盖效果良好。

如何配置空闲屏幕

空闲屏幕是在PC未使用时客户看到的内容。它可以显示图像或视频的幻灯片、时钟和您的网吧名称。

您需要准备的

  • 幻灯片的图像文件（PNG, JPG, WebP或GIF）或视频文件（MP4, WebM）。
  • HandyCafe服务器正在运行。

步骤

  1. 导航到设置 > 客户端 > 空闲屏幕标签。
  2. 切换启用幻灯片为开启。
  3. 点击添加媒体上传图像或视频。您可以添加多个项目。支持的格式有PNG, JPG, WebP, GIF, MP4和WebM。
  4. 设置每个项目的持续时间（以秒为单位）。这控制每张幻灯片在过渡前可见的时间。对于大多数设置，8到15秒的值效果良好。
  5. 选择过渡效果：淡入淡出（平滑的不透明度交叉淡化）、滑动（水平滑动）或缩放（缩放效果）。
  6. 启用时钟覆盖切换以在空闲屏幕上显示数字时钟。使用颜色选择器设置时钟文本颜色，以便与您的幻灯片内容形成最大对比。
  7. 启用网吧名称切换以在空闲屏幕上显示您的企业名称。名称从您的常规服务器设置中提取。
  8. 点击保存。空闲屏幕配置会推送到所有连接的客户端。

预期结果

未处于活动会话的客户端PC会显示配置的过渡、时钟覆盖和网吧名称的幻灯片。幻灯片会连续循环。

常见错误

  • 添加太多高分辨率图像而不考虑同步时间。每个媒体文件必须传输到每个客户端。保持幻灯片总大小合理。
  • 设置过短的持续时间（少于3秒）。快速过渡可能会让人感到不安，并使幻灯片中的任何文本难以阅读。
  • 未测试时钟颜色与所有幻灯片图像的对比。白色时钟在明亮的白色幻灯片上是不可见的。选择一种适用于整个幻灯片集的颜色。

如何创建公告

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

您需要准备的

  • HandyCafe服务器正在运行，并至少连接了一个客户端。
  • 如果您想要视觉公告，请准备一个横幅图像（推荐1200x400像素或更宽）。

步骤

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

预期结果

公告会出现在连接的客户端桌面的公告栏中。当客户查看并与之互动时，服务器会跟踪展示次数（显示的次数）和点击次数（客户点击的次数）。

常见错误

  • 创建没有横幅图像的公告。没有图像的纯文本公告在公告栏中很容易被客户忽略。
  • 忘记设置过期时间或删除过时的公告。留下的旧促销活动会带来不好的客户体验。
  • 在公告正文中使用过长的文本。显示区域很紧凑。保持文本简洁，并将详细信息放在链接后面。