跳转到内容

设备

Jonot 有三种设备类型,每种在队列工作流中承担不同角色。所有设备都使用短时效配对代码配对到门店(以及可选的队列)——代码在设备上生成,然后在管理后台输入。

放置在场地入口的平板。顾客通过自助终端加入队列。在生产环境中,Jonot 通常以专用原生应用运行自助终端——Android,或面向 macOS、Windows 和 Linux 的桌面客户端。基于浏览器的自助终端部署也是可能的。在 Android 或桌面客户端上,自助终端可以连接 ESC/POS 打印机以签发纸质排队号。自助终端配对到特定队列。

界面:专用自助终端应用(Android 或桌面),或 https://kiosk.jonot.io

等待区域的电视或显示器,展示实时队列状态——当前呼叫的排队号编号、在哪个服务台、多少位顾客在等待、接下来要呼叫的编号预览,以及最近呼叫的可视化历史。呼叫新编号时播放语音播报。通过 WebSocket 实时更新。

界面:https://display.jonot.io

工作人员使用的界面,用于呼叫下一位顾客、完成服务或跳过未到场者。可以作为固定柜台平板(Android)或桌面/笔记本电脑(macOS、Windows、Linux)上的专用原生应用运行,也可以在 PC/平板的浏览器中运行。服务台配对到特定队列。工作人员不需要单独的 Jonot 账户——服务台会话本身就是凭证。

界面:专用服务台应用(Android 或桌面),或 https://desk.jonot.io

三种设备类型使用相同的配对握手:

  1. 在物理设备上,打开相应运行时的配对屏幕。对于自助终端和服务台,通常是平板上的专用设备应用;基于浏览器的设置可以改为打开 https://kiosk.jonot.io/pair/https://desk.jonot.io/pair/。显示屏目前使用 https://display.jonot.io/pair/。设备请求一个7 字符的配对代码(例如 K7M-4PQ)并显示在屏幕上。代码有效期为10 分钟
  2. 组织管理员或门店管理员在管理后台打开门店,进入 设备 选项卡,点击 配对设备,并输入设备屏幕上显示的代码。
  3. 服务器激活设备,创建一个 DeviceSession,并签发长期设备令牌。设备检测到激活后打开其工作屏幕。新配对的、未配置打印机的 Android 或桌面自助终端会先重定向到打印机设置。

如果代码在管理后台输入之前过期,请返回设备的配对屏幕请求新代码。在基于浏览器的设置中,这意味着返回相应的 /pair URL。旧代码会自动失效。

DeviceSession 在配对时创建,持续存在,直到在管理后台手动吊销或会话过期。它承载:

  • 设备类型(自助终端 / 显示屏 / 服务台)
  • 门店分配
  • 可选的队列分配(自助终端、服务台、显示屏)
  • 可选的服务台分配(显示屏——见下文)
  • 可选的显示名称(例如 “Desk 1”、“Kiosk A”)
  • 最后在线时间戳
  • 在线/离线状态

要吊销设备会话,请前往管理后台 → 门店 → 设备,找到该设备,点击 吊销。设备将在其下一次请求时被锁定。

显示屏有两个独立的分配维度——展示哪些队列,以及(可选地)聚焦哪个服务台。

队列分配控制看板布局:

  • 单队列——分配一个队列;显示屏使用以“正在办理”主角开头的单队列布局。
  • 多队列看板——分配 2–5 个队列;显示屏并排展示,每列独立实时。
  • 门店视图(所有服务台) ——未分配队列;显示屏展示整个门店所有正在进行的呼叫。

服务台链接是叠加在上述任何布局之上的可选层:

  • 链接到服务台——将 assignedDeskSessionId 设置为特定服务台会话。该服务台在线期间,显示屏以聚焦的单排队号视图仅展示其呼叫的排队号。当每个服务台有自己的屏幕时很有用。
  • 未链接——assignedDeskSessionIdnull。显示屏按上述队列分配跟随。

如果显示屏链接到某个服务台,而该服务台离线超过2 分钟,显示屏自动回退到门店视图。服务台重连后,它返回服务台链接模式。

操作员视角的演练参见配对显示屏,看板布局细节参见自定义显示屏

设备维护与 Jonot API 的 WebSocket 连接。服务器跟踪每个设备会话的 lastSeenAt。在设备列表中,管理后台在设备连接期间将其标记为 在线;一旦其最后在线时间戳超过阈值,状态列改为显示其最后在线时间。网络恢复时设备自动重连——无需手动干预。

服务台使用配对时签发的设备令牌进行认证,而非个人用户账户。这意味着使用该设备的任何工作人员无需登录即可获得服务台访问权限。要限制访问,请吊销设备会话,仅与授权设备重新配对。