打印机设置

打印机设置位于 POS 的 设置 > 打印机。每台设备都会管理自己的打印机配置 — 打印机会保存在本地，不会在设备之间同步。

按平台支持的打印机

添加打印机表单会根据你正在使用的应用调整 — 每个平台只显示它实际可用的连接方式和选项。

平台	支持的打印机	连接
Web 应用	带内置 Web 服务器的 Epson 和 Star 打印机	网络 (HTTP)
桌面应用	任意网络收据打印机	网络 (原始 TCP)
iOS 应用	Epson 和 Star	网络、蓝牙
Android 应用	Epson 和 Star	网络、蓝牙、USB

为什么 Web 上只支持 Epson 和 Star？

Web 浏览器无法打开原始 TCP 连接。Epson 和 Star 收据打印机内置 Web 服务器，可以通过 HTTP 接收打印任务 — 这是从浏览器发送 ESC/POS 命令的唯一方式。桌面应用没有这个限制，因为它可以直接通过 TCP 连接。

在移动应用中，蓝牙和 USB 打印会通过 Epson 和 Star 的官方 SDK，因此这些连接同样需要 Epson 或 Star 打印机。通用打印机只能通过网络工作。

添加打印机

1

打开打印机设置

在 POS 中转到设置 > 打印机。如果还没有配置打印机，你会看到一个空状态和添加打印机按钮。每台打印机都会获得一个打印机名称 — 只是一个标签，会自动填为“收据打印机”（之后是“收据打印机 2”，依此类推）— 你可以改成任何方便区分打印机的名称。

2

选择打印机连接方式

这一步会按平台变化：

• Web 应用 — 选择厂商：Epson 或 Star。这是 Web 上的首要选择，因为浏览器只能访问这两个品牌的内置 Web 服务器。
• 桌面应用 — 打印机通过网络连接；这里没有额外内容需要选择。
• 移动应用 — 选择连接类型：网络、蓝牙或 USB（USB 仅限 Android）。下面的字段会根据你的选择变化。

3

识别打印机

网络打印机 — 输入 IP 地址（例如 192.168.1.100）。WCPOS 会探测该地址，判断它是 Epson 还是 Star 设备，并自动填入端口、命令语言和厂商。检测完成后，你会看到“已检测到：Epson”或“已检测到：Star”标签。在 Web 应用中，它还会显示将要连接的确切端点 URL。

蓝牙或 USB 打印机（移动端）— 从发现的设备列表中选择你的打印机。选择设备后会自动填入名称和厂商。如果打印机还没有出现在列表中，请点按扫描打印机（蓝牙）或刷新（USB）。

如果自动检测没有完全正确，你可以在高级设置中调整所有内容。

4

保存并测试

点击保存。WCPOS 会先发送一次测试打印，只有成功后才保存打印机。

测试打印是一段简短诊断内容 — 包括编号列尺、居中的普通和双倍大小文本、左右对齐行以及切纸。它用于确认纸张宽度、对齐、尺寸和切纸都配置正确，而不只是确认打印机可以访问。

如果测试失败，你会看到错误，并看到不测试直接保存选项，用于仍然保存该配置。

连接类型（移动应用）

在 iOS 和 Android 应用中，打印机可以通过三种方式连接。在添加打印机表单顶部选择连接类型，连接字段会随之更新。

网络

打印机与设备位于同一 Wi-Fi 网络。输入它的 IP 地址 — 参见查找打印机的 IP 地址。网络打印机可以是 Epson、Star 或通用型号。

蓝牙

打印机已通过蓝牙与设备配对。点按扫描打印机并从列表中选择你的打印机 — 名称和厂商会自动填入。蓝牙打印使用 Epson 和 Star 的原生 SDK，因此打印机必须是 Epson 或 Star 型号。

USB（仅限 Android）

打印机通过 USB 线连接。点按刷新并从已连接设备列表中选择它。与蓝牙一样，USB 打印需要 Epson 或 Star 打印机。iOS 没有通用 USB 外设支持，因此此选项只会出现在 Android 上。

注意

端口设置只适用于网络打印机 — 对蓝牙和 USB 连接会隐藏。

高级设置

展开高级设置以微调打印机配置。知道厂商后，大多数字段都会自动填入。

设置	选项	描述
厂商	Epson, Star, Generic	打印机制造商。在 Web 应用中，厂商是表单顶部的主要选择（仅 Epson 或 Star），而不是高级设置。Generic 可用于桌面和移动应用中的网络打印机，但不适用于蓝牙或 USB 连接。
端口	自动填入	打印机的网络端口。仅网络 — 对蓝牙和 USB 隐藏。
语言	ESC/POS, StarPRNT, Star Line Mode	打印机使用的命令协议。根据检测到的厂商自动填入。
打印机文本宽度	58mm（32 个字符）、80mm 标准（42 个字符）、80mm 宽（48 个字符）	一行可容纳的字符数。请与纸张和打印机匹配 — 大多数 80mm 打印机每行 42 个字符，有些为 48 个。
完整收据栅格化	关 / 开	将整张收据作为图像打印，而不是作为文本 — 见下方完整收据栅格化。

打印机选项

这些开关位于添加打印机表单底部：

选项	描述
自动切纸	每张收据后自动切纸
自动打开钱箱	打印后发送弹开命令，打开已连接的钱箱
设为默认	将其设为默认打印机 — 用于任何未路由到特定打印机的收据

在找“结账后自动打印”？

销售完成后自动打印收据是购物车设置，不是打印机设置 — 请在 POS 购物车设置中开启自动打印收据。使用哪台打印机由默认打印机以及每个模板的打印机路由决定。

打印路由

如果你使用多个模板 — 比如一张热敏收据和一张 A4 发票 — 打印路由会决定每个模板发送到哪台打印机。路由有三层，按以下顺序检查：

1. 单次任务覆盖。 在收据屏幕上，打印机下拉菜单位于模板切换器旁边。在这里选择打印机会只覆盖这一次打印任务的所有设置。切换模板会将其重置为自动。
2. 设置覆盖。 转到设置 → 打印路由，为每个模板分配特定打印机。例如，将热敏收据路由到 Epson 网络打印机，将 HTML 发票路由到系统打印对话框。将模板改回自动即可移除覆盖。
3. 自动匹配。 未设置覆盖时，WCPOS 会自动匹配：
   • 热敏模板会路由到字符宽度匹配的热敏打印机。58mm 热敏模板优先选择 32 列打印机；80mm 模板优先选择 42 或 48 列打印机。
   • HTML 模板会路由到系统打印对话框。
   • 如果多台打印机匹配，默认打印机会优先。

如果你手动将模板发送到不兼容的打印机 — 例如把热敏模板发送到系统对话框 — 收据屏幕会出现琥珀色的不匹配警告。打印仍会继续，但输出可能无法正确渲染。

路由覆盖会按设备存储。每台 iPad、手机或电脑都管理自己的路由 — 没有服务器端同步。

注意

只有在至少添加一台打印机后，打印路由设置页才会出现。未配置打印机时，每个模板都会隐式使用系统打印对话框。

完整收据栅格化

默认情况下，WCPOS 将收据作为文本发送到热敏打印机 — 快速、紧凑且清晰，使用打印机内置字体。问题在于：热敏打印机字体只覆盖有限字符集。打印机没有字体的书写系统 — 许多非拉丁字母、从右到左的文本以及某些符号 — 可能会打印为空白方框或乱码。

完整收据栅格化可以解决这个问题。开启后，WCPOS 会将整张收据渲染为图像，并将该图像发送到打印机，因此打印结果会与屏幕显示完全一致 — 适用于任何语言或书写系统。