HandyCafe Docs
owner it-admin

客户端显示模式与系统托盘

HandyCafe 客户端既可以占满整个屏幕,也可以作为面板停靠在普通桌面的一侧。具体用哪种方式在服务端选择,设置会推送到所有已连接的客户端。

另有一组设置允许顾客在会话期间把客户端窗口收进系统托盘。窗口隐藏时,屏幕角落可以保留一个小会话窗口,显示剩余时间和当前费用。


设置位置

打开设置,进入客户端,再切换到常规标签页。

显示相关的设置集中在该标签页的一个区块中:

  • 客户端显示模式及其两张选项卡片
  • 面板宽度和允许顾客调整面板大小(仅桌面模式)
  • 保持任务栏可见(仅游戏模式)
  • 启用隐藏按钮
  • 隐藏时显示会话信息和窗口样式

点击设置页面底部的保存使更改生效。已连接的客户端会立即收到新设置。


客户端显示模式

选项 顾客看到的界面
游戏模式(全屏) 带应用启动网格的全屏 kiosk 界面。
桌面模式(浮动面板) 浮在操作系统普通桌面上的面板。

点击选项卡片即可选中,选中的卡片会显示勾选标记。

游戏模式

会话界面覆盖整个显示器,包括任务栏。顾客从启动网格中打开游戏和应用。主题和布局来自外观标签页,参见客户端外观。

选中游戏模式时,模式卡片下方会出现保持任务栏可见。开启后,会话窗口只覆盖屏幕的工作区域,顾客仍可使用操作系统任务栏。该选项默认关闭。

桌面模式

客户端以面板形式停靠在屏幕工作区域的右侧,紧挨普通桌面。顾客照常使用桌面,会话详情、应用和点单都保留在面板中。

选中桌面模式时会出现两项设置:

设置 作用
面板宽度 客户端上停靠面板的宽度,单位为像素。可选范围 300 px 到 1200 px,默认 420 px。面板宽度最多为屏幕工作区域的 80%。
允许顾客调整面板大小 顾客可以拖动面板左边缘调窄或调宽,最小 300 px。调整后的宽度仅在本次会话内有效。默认开启。

会话结束、客户端回到锁屏界面后,面板会恢复为您设置的宽度。关闭允许顾客调整面板大小也会丢弃顾客选择的宽度。

宽度以逻辑像素为单位。在缩放显示器上(例如 150%),面板会按比例占用更多物理像素,因此在每台显示器上看起来大小一致。


将客户端隐藏到系统托盘

客户端启动时会在系统托盘中放置一个图标,该图标始终存在。顾客能用它做什么取决于管理员的两项选择:

  • 常规标签页上的启用隐藏按钮。
  • 客户端任务标签页上的把窗口收进托盘任务。

两者都关闭时,窗口永远不能离开屏幕,托盘菜单也不会提供隐藏选项。

隐藏按钮

开启启用隐藏按钮,顾客就可以在会话期间隐藏客户端。

  • 游戏模式:屏幕顶部边缘中间有一个小标签。鼠标悬停在上面会展开隐藏窗口标签,点击即可把窗口收进托盘。在触摸屏上,第一次轻触展开标签,第二次轻触隐藏窗口。
  • 桌面模式:面板标题栏中会出现带托盘图标的隐藏窗口按钮。

会员面板、AI 聊天、活动对话框或点单对话框打开时,游戏模式下不显示该标签。

托盘图标与菜单

托盘菜单有两个条目:

条目 何时可用
显示 仅在窗口隐藏时可用,用于恢复客户端。
隐藏窗口 仅在允许隐藏、会话进行中且窗口位于屏幕上时可用。

双击托盘图标也能恢复窗口,单击则没有任何反应。这样,顾客在游戏中不小心碰到图标时,客户端不会盖到游戏上面。菜单条目跟随客户端语言显示。

在 macOS 上,隐藏的客户端还会从 Dock 和 Cmd-Tab 切换器中消失,菜单栏图标保留。

窗口自动恢复的情况

  • 会话结束提醒:会话结束提醒任务触发时,隐藏的窗口会被调回,让顾客看到时间快用完了。如果开启了在游戏上方显示,窗口保持隐藏,提醒直接显示在游戏上方。参见客户端任务。
  • 会话结束:会话结束时,窗口恢复并显示锁屏界面。

锁屏界面永远无法隐藏。隐藏按钮、托盘菜单和任务都不能隐藏它。


隐藏时的小会话窗口

隐藏时显示会话信息默认开启。客户端隐藏到托盘期间,屏幕底部角落会保留一个小窗口,显示顾客的剩余时间和费用。它不会遮挡任务栏。

该窗口始终置于其他窗口之上,在客户端窗口所在的显示器上打开,客户端一恢复就会关闭。

在窗口样式中选择布局:

样式 说明 显示内容
状态条 单行,占用空间最小 机位、顾客姓名、付费方式、剩余时间(不限时会话显示已用时间)、进度条和时长费用。
计时卡片 倒计时优先,中等大小 顾客姓名和机位、活跃或已暂停标记、大字号剩余时间、已用时间和时长费用(预付费会话显示已付金额)。这是默认样式。
完整明细 逐项账单,最宽 会话状态、顾客和机位、剩余时间、开始时间、已用时间、时长费用、有咖啡厅消费时显示该费用,以及总计。

每种样式都有一个打开窗口按钮,用于恢复客户端。

如果在顾客隐藏客户端期间更改样式,小窗口会立即按新尺寸重建。


会话开始时直接进入托盘

旧的“会话开始时把窗口收进托盘”开关现在改为客户端任务。打开设置,进入客户端,再进入客户端任务,添加一个动作为把窗口收进托盘的任务。

该动作只能与会话开始、会员登录或访客登录触发条件搭配使用,并支持设置运行前延迟(秒)。

任务设置 结果
会话开始,延迟为 0 会话开始时窗口已在托盘中,客户端窗口不会出现在屏幕上。
会话开始,设置了延迟 窗口先出现,延迟结束后进入托盘。
会员登录或访客登录 对应类型的登录完成后,经过您设置的延迟,窗口进入托盘。

之前开启了旧开关的网咖已自动获得一个等效的会话开始任务。

如何添加任务和调整顺序,请参见客户端任务。


操作步骤

将客户端切换到桌面模式

  1. 打开设置,进入客户端,再切换到常规标签页。
  2. 在客户端显示模式下,点击桌面模式(浮动面板)。
  3. 选择面板宽度。
  4. 通过允许顾客调整面板大小决定顾客能否拖动面板边缘。
  5. 点击保存。

在游戏模式下让顾客看到任务栏

  1. 打开设置,进入客户端,再切换到常规标签页。
  2. 选择游戏模式(全屏)。
  3. 开启保持任务栏可见。
  4. 点击保存。

允许顾客隐藏客户端并显示角落计时器

  1. 打开设置,进入客户端,再切换到常规标签页。
  2. 开启启用隐藏按钮。
  3. 确认隐藏时显示会话信息已开启。
  4. 在窗口样式下,选择状态条、计时卡片或完整明细。
  5. 点击保存。

让每个会话都在托盘中开始

  1. 打开设置,进入客户端,再进入客户端任务。
  2. 点击添加任务。
  3. 选择会话开始触发条件和把窗口收进托盘动作。
  4. 将运行前延迟(秒) 保持为 0。
  5. 点击任务对话框中的保存,任务会立即保存。

权限

拥有管理员角色的收银员可以打开设置。参见收银员角色。


故障排查与说明

隐藏按钮不显示。 检查启用隐藏按钮是否已开启并保存。该按钮只在会话期间存在。在游戏模式下,抽屉或对话框打开时也会隐藏。

托盘菜单中的隐藏窗口是灰色的。 只有在会话进行中,并且启用了隐藏按钮或把窗口收进托盘任务时,才允许隐藏。窗口已经隐藏时,该条目同样是灰色的。

单击托盘图标没有反应。 这是有意的设计。请双击图标,或从菜单中选择显示。

小会话窗口不出现。 检查隐藏时显示会话信息是否开启。该窗口只在客户端隐藏到托盘时出现。

面板比我设置的宽度窄。 面板宽度上限为屏幕工作区域的 80%。在较小或缩放比例较高的显示器上,这个上限可能低于您的设置值。

顾客调整的面板宽度被重置了。 顾客拖出的宽度只在本次会话内保留,下次会话从您设置的面板宽度开始。