定制自助终端

自助终端可以使用 ESC/POS 打印机打印实体排队号。排队号包含组织名称、门店名称、队列名称、排队号号码，以及您在门店上配置的排队号页眉/页脚文字。

要求

打印需要使用原生自助终端应用。纯浏览器自助终端部署不支持打印：它们会在屏幕上显示每个排队号号码和手机二维码（见在手机上跟踪排队号）。支持的连接方式取决于应用：

应用	网络	USB	蓝牙
Android 自助终端应用	是	是	是
桌面自助终端客户端（macOS、Windows、Linux）	是	是	否

在 Windows 和 Linux 上，桌面 USB 打印需要额外设置。见 USB 打印机（桌面）。

只有自助终端打印排队号。服务台不打印；当门店的自助终端打印机离线时，服务台会显示一条横幅提示。

设置打印机

配对新的 Android 或桌面自助终端后，如果尚未配置打印机，自助终端会打开打印机设置。该屏幕列出自助终端找到的打印机，并为每台打印机标明连接类型，并提供一个按地址添加网络打印机的表单。

1. 在 打印机语言模式 下，选择打印机支持的模式。大多数打印机使用 西欧字符集（CP858）。仅当打印机支持时才选择 简体中文（Epson GB18030）。
2. 通过以下任一方式选择打印机：
   • 在 可用打印机 下选择打印机，然后点按 连接。如果列表中没有该打印机，请点按 搜索打印机。
   • 在 手动添加网络打印机 下输入打印机的 IP 地址，然后点按 连接。
3. 自助终端连接打印机并自动打印一张测试小票。没有单独的测试或保存步骤。
4. 检查测试小票。如果打印正确，请点按 正常，继续。自助终端会打开排队屏幕。如果打印不正确，请点按 异常，重新测试。自助终端会移除该打印机并返回列表，以便你重新选择。

如果没有找到打印机，屏幕会显示 未找到打印机。连接或配对打印机，然后点按 搜索打印机。你也可以按地址添加网络打印机。

网络打印机

网络打印机必须使用私有 IPv4 地址，例如 192.168.x.x、10.x.x.x 或 172.16–31.x.x，并且必须在端口 9100 上接受连接。端口字段已填入 9100，不接受其他端口。不接受主机名和公网地址。请在网络中为打印机分配固定地址，这样打印机重启后自助终端仍能连接到它。

USB 打印机（桌面）

桌面自助终端客户端直接向 USB 打印机发送排队号，而不经过操作系统的打印机驱动程序。请根据你的操作系统检查以下要求：

• Windows — 打印机必须使用 WinUSB 驱动程序。Windows 通常会安装自带的 USB 打印驱动程序或制造商的驱动程序，自助终端无法打开使用其中任一驱动程序的打印机。请使用 Zadig 等驱动程序工具，将打印机的驱动程序替换为 WinUSB。更换后，其他 Windows 应用将无法向该打印机打印。

• Linux — 运行自助终端的账户必须有权访问打印机的 USB 设备。运行 lsusb 查找打印机的供应商 ID 和产品 ID。创建文件 /etc/udev/rules.d/70-jonot-printer.rules，写入下面这一行，并用你的打印机 ID 替换 04b8 和 0202。然后运行 sudo udevadm control --reload-rules，并重新连接打印机。

  SUBSYSTEM=="usb", ATTR{idVendor}=="04b8", ATTR{idProduct}=="0202", TAG+="uaccess"

• macOS — 无需设置驱动程序。macOS 上的 USB 打印尚未在真实打印机硬件上验证。

如果列表中显示了打印机，但测试小票没有打印出来，请先检查这些要求。

如果在连接第二台同型号打印机后，或将自助终端设置复制到另一台电脑后，自助终端报告 USB 打印机不可用，请打开管理员菜单并选择更换打印机。

蓝牙打印机（Android）

在自助终端中设置打印机之前，请先在 Android 蓝牙设置中配对打印机。如果列表中没有该打印机，请点按 打开蓝牙设置，配对打印机，返回自助终端，然后点按 搜索打印机。默认情况下，列表只显示标识为打印机的已配对设备。如果打印机已配对但未列出，请选择 显示所有已配对设备。列表随后会显示所有已配对设备，并标记未标识为打印机的设备。

在 Android 12 及更高版本上，打印机设置首次查找打印机时，Android 会请求连接附近设备的权限。如果拒绝该权限，打印机设置会显示一条消息。要恢复，请打开 Android 设置，前往应用 → Jonot Kiosk → 权限，并允许该权限。然后返回打印机设置。

Android 自助终端在连接打印机之前不会进入锁定的自助终端模式，因此你可以在设置期间打开 Android 设置。

更换打印机

1. 打开管理员菜单：在右上角快速点按五次（每次距上一次约 1.5 秒内），然后输入管理员 PIN。完整手势见 退出自助终端锁定。
2. 选择更换打印机重新运行打印机设置。在 Android 上，确认显示当前打印机的提示。
3. 打印机设置会显示当前打印机。在你连接新打印机之前，自助终端会继续使用当前打印机。要保留当前打印机，请点按 取消 — 保留当前打印机。
4. 按照设置打印机中的说明设置新打印机。

在 Android 上，锁定的自助终端无法打开 Android 设置。要更换为尚未配对的蓝牙打印机，请打开管理员菜单并选择退出。在 Android 蓝牙设置中配对打印机，再次打开自助终端，然后选择更换打印机。

如果你在连接新打印机后点按 异常，重新测试，自助终端将没有打印机，直到你重新设置一台。在此之前如果有顾客取号，自助终端会切换到打印机故障模式。

排队号内容

每张打印的排队号都包含：

• 组织名称
• 门店名称
• 队列名称
• 排队号号码（大号、醒目）
• 排队号页眉（最多 48 个字符） — 在管理后台的门店上配置
• 排队号页脚（最多 48 个字符） — 在管理后台的门店上配置

要更新页眉或页脚文字，请前往管理后台 → 您的门店 → 编辑门店。

重新打印排队号

打印成功后，自助终端会显示 重新打印小票 按钮约 30 秒。点按后，打印机会再次打印完全相同的排队号，包括相同的号码、页眉、页脚和时间戳。排队号卡纸或顾客需要另一份时，可以使用此功能。

• 重新打印会延长自动消失倒计时，让顾客有时间取走新的小票。
• 如果重新打印失败，自助终端会显示打印机不可用卡片，并可能切换到打印机故障模式。
• 每次重新打印都是一个单独的打印任务，具有自己的任务 ID。

在手机上跟踪排队号

顾客取号后，排队号卡片会显示 用手机查看排队进度 以及该排队号的二维码。无论排队号是否打印出来，都会显示此二维码。顾客用手机相机扫描后，手机浏览器会打开同一张排队号，顾客可以跟踪自己的排队位置。扫描二维码绝不会创建第二张排队号：顾客保留同一个号码。

• 二维码显示 30 秒。每点按一次 延长时间 增加 30 秒，最多 10 次。剩余 20 秒时，卡片会提示二维码即将隐藏。点按屏幕其他位置不会延长二维码的显示时间。
• 在成功卡片上，点按卡片外部会关闭卡片，二维码也会随之隐藏。
• 手机打开排队号后，二维码会隐藏，自助终端会确认排队号已在手机上打开。
• 当顾客点按 完成、卡片返回主屏幕、下一位顾客取号，或自助终端与 Jonot 断开连接时，二维码也会隐藏。二维码隐藏后，该排队号不会再次显示二维码。
• 如果手机在二维码失效后才打开它，手机会显示 此二维码已失效。手机不会提示再次加入队列，因此顾客保留已有的排队号。
• 如果顾客取号时自助终端未连接到 Jonot，卡片只显示排队号号码，不显示二维码。

二维码打开的排队号页面与顾客自己的排队号链接拥有相同的访问权限，包括取消排队号。打开二维码的手机在排队号结束之前都可以查看和取消该排队号。二维码隐藏后仍会在短时间内有效，并且可以在多部手机上打开。因此二维码只显示很短的时间。

没有手机的顾客保留打印的排队号。如果排队号没有打印出来，由工作人员为顾客记下号码。

主屏幕上的二维码是另一个二维码。它让尚未取号的顾客用手机加入队列。

空闲返回主页

自助终端在一段时间无操作后会自动返回主屏幕：

• 成功卡片 — 在最后一次触摸后，或顾客点按 重新打印小票 后，30 秒消失。
• 失败卡片 — 45 秒后消失。排队号未打印时，此卡片会显示 已取号 — 打印机不可用 和排队号号码，并请顾客让工作人员记下号码。

手机二维码显示期间，两种卡片都不会在二维码隐藏之前自动消失。

应用进入后台时，倒计时会暂停；回到前台时继续。短暂关闭屏幕不会在交互过程中重置倒计时。此功能始终开启，无需配置。

顾客语言

当组织或门店提供多种语言时，每位顾客都可以在自助终端上选择本次使用的语言。自助终端返回主屏幕后，会恢复为门店默认语言，供下一位顾客使用。请在管理后台设置可用语言和默认语言。参见语言。

打印机故障

只要有一次排队号打印或重新打印失败，自助终端就会切换到打印机故障模式。这包括打印机已关机、未连接线缆或无法访问，也包括自助终端的蓝牙已关闭或未设置打印机。与打印机本身无关的失败不计入：没有打印机连接的浏览器自助终端、已在进行中的打印任务，或在到达打印机之前就被自助终端拒绝的排队号（例如含有打印机无法打印的字符，或内容过大）。自助终端无法检测打印纸是否用完：打印机通常仍会接收排队号，因此自助终端会将其显示为已打印。

如果打印机在 8 秒内没有响应，自助终端会显示打印机不可用卡片，并最多再等待 30 秒。如果排队号在这段时间内打印出来，自助终端保持正常模式。打印机设置过程中测试小票打印失败，本身不会改变该模式。

在打印机故障模式下：

• 顾客仍然可以取号。自助终端不会尝试打印。它会在 已取号 — 打印机不可用 卡片上显示排队号号码和手机二维码。没有手机的顾客请工作人员记下号码。
• 主屏幕会显示一条横幅，提示排队号打印机故障，打印排队小票 按钮上方的文字会说明排队号不会打印。按钮的文字不变。
• 自助终端将该模式保存在设备上，因此自助终端应用重新加载或重启后，该模式仍然有效。
• 服务台会为该自助终端显示打印机离线横幅，管理后台会将打印机显示为 离线。自助终端每次加载以及每次有顾客取号时都会再次报告该故障。如果 24 小时内这两种情况都没有发生，服务台会停止显示横幅，但自助终端仍处于故障模式。

只有工作人员可以通过测试小票结束打印机故障模式：

1. 检查打印机的纸张、电源和连接。
2. 打开管理员菜单并选择更换打印机。见更换打印机。
3. 连接打印机。自助终端会打印一张测试小票。响应较慢的打印机可能还需要最多 30 秒，请等待结果。
4. 如果测试小票打印正确，请点按 正常，继续。

只有当自助终端成功将测试小票发送到打印机，并且你确认打印正确时，该模式才会结束。如果自助终端无法将测试小票发送到打印机，自助终端仍处于故障模式，并显示 重新打印测试小票，而不是 正常，继续。点按 取消 — 保留当前打印机 后，自助终端仍处于故障模式。顾客永远不需要取号来测试打印机。

管理后台中的打印机状态

当前打印机状态可在管理后台门店的 设备 标签页中查看。状态显示：

• 已连接 — 上一张排队号或测试小票打印成功。
• 离线 — 上一次打印尝试失败，并附简短原因。

如果打印机显示错误，请检查网络、USB 或蓝牙连接，并确认打印机有纸。下一次打印成功后，状态会恢复为 已连接。在打印机故障模式下自助终端不打印排队号，因此只有成功打印测试小票并结束该模式后，状态才会恢复。