首页/产品中心/PrinterService

跨终端、低门槛的统一打印服务

PrinterService

部署在终端或局域网中的轻量打印服务,解决浏览器无法直接、稳定控制打印机的问题。业务系统通过标准接口即可完成设备发现、模板打印和状态回传。

本地打印桥静默打印标准API
安装服务后即可联调 提供 JavaScript 与 C# 示例 提供完整公开接入文档
产品界面
设备激活与调用说明
设备激活与调用说明
产品界面
系统打印机管理
系统打印机管理
即接即用快速集成 Web 系统
无感打印减少人工重复操作
统一管理多设备调用更稳定

业务价值

让网页和 Android 应用用同一套方式调用打印

安装 PrinterService 后,业务页面或 App 通过 printer:// 协议发送任务;简单内容一行代码即可调用,复杂标签和票据也有对应接口。
01

网页框架直接接入

原生 JavaScript、Vue、React、Angular 及普通 H5 页面均可通过 URL Scheme 调用。

02

App 框架复用接口

支持 Android Java/Kotlin、.NET MAUI、Xamarin.Android 及 WebView 页面。

03

业务接口按需选择

提供二维码、条码、图片、标签、小票、价签、表格和 JSON 组合打印。

04

终端运行更可控

支持浓度、黑标、走纸、切纸、打印测试、设备授权和在线升级。

开发接入

网页、H5 与主流 App 框架,共用一套打印协议

PrinterService v1.1 以 printer:// URL Scheme 为主入口。简单打印直接调用,复杂票据使用专用接口或 JSON 组合任务。
01

浏览器网页

前端页面把业务数据编码后写入 printer:// 地址,即可拉起终端打印服务。

原生 JavaScriptVueReactAngularjQueryPHP / Java / .NET 后台生成的网页
02

H5 与 WebView

H5 可直接调用 Scheme,也可引入 AndroidPrinter 适配器,按队列追加文本、条码、二维码和图片。

Android 浏览器Android WebViewH5 业务页混合应用内嵌页
03

Android 原生应用

Java 或 Kotlin 应用可打开自定义 Scheme,也可按项目需要使用 PrintService、AIDL 或前台打印服务。

Android JavaAndroid Kotlin系统 PrintServiceAIDL 调用
04

.NET Android 应用

C# 对参数进行 URL 编码后打开 printer://,同一套接口可用于二维码、标签、价签、表格和小票。

.NET MAUIXamarin.AndroidC# Android

五步完成打印联调

安装打印服务
在 Android 打印终端安装 PrinterService SDK,完成设备授权并连接打印机。
选择合适接口
二维码、条码和图片用快捷接口;标签、小票、价签和表格使用专用接口;复杂内容使用 JSON。
编码业务参数
中文、换行、JSON、Base64 和 Raw 指令中的空格均应进行 URL 编码。
拉起打印服务
网页设置 location.href,Android 或 C# 应用打开 printer:// Scheme,即可提交打印任务。
完成输出验收
核对纸张宽度、标签模式、打印份数、黑标、走纸和切纸等实际效果。

最短调用示例

window.location.href = 'printer://print?qrcode=' + encodeURIComponent(data);
await OpenPrinterSchemeAsync("printer://print?barcode=" + Android.Net.Uri.Encode(value));

正式文本任务建议使用通用 JSON 或 /ticket 接口;rawbtprint:// 仅用于兼容既有调用。

接口类型调用路径适用内容
二维码printer://print?qrcode=

订单码、付款码、核验码

条码printer://print?barcode=

商品码、物流码、资产码

Base64 图片printer://print?base64=

签名、凭证、业务图片

组合 JSONprinter://print?json=

文字、条码、二维码、图片混排

标签printer://print/label

标题、条码、二维码组合标签

小票printer://print/ticket

门店小票、多行文本票据

商品价签printer://print/price_ticket

商品名称、价格和编码

表格标签printer://print/table

表格、文字、条码和二维码

接入前请先在 Android 终端安装 PrinterService SDK,并按文档完成设备与打印机测试。

查看接入文档下载 SDK

核心功能

六项主要能力,对应六个真实业务环节

每屏介绍一个功能,包含工作方式、关键操作与相关模块,便于快速判断是否符合当前业务。
功能 01 / 06

网页与 H5 快速接入

网页通过 printer:// 协议拉起服务,原生 JavaScript、Vue、React、Angular 均可使用。

  • 网页通过 printer:// URL Scheme 拉起打印服务
  • 原生 JavaScript、Vue、React、Angular 页面均可调用
  • PHP、Java、.NET 等后台页面由前端发起同一协议
  • H5 页面可在 Android 浏览器或 WebView 中使用
  • 中文、换行、JSON 和图片数据统一进行 URL 编码
printer:// URL Scheme网页 JavaScript 调用Vue 页面调用React 页面调用Angular 页面调用H5 页面调用
产品界面
PrinterService:打印调用说明与设备激活
打印调用说明与设备激活
功能 02 / 06

快捷打印接口

用一个 URL 参数直接打印二维码、条码或 Base64 图片,适合简单业务快速落地。

  • 提供二维码、条码和 Base64 图片快捷接口
  • 简单内容只需拼接参数即可直接打印
  • 适合订单码、商品码、付款码和业务凭证图片
  • 可传入打印份数及标签模式等参数
  • 复杂内容再切换到 JSON 组合打印接口
Android WebView 调用二维码快捷打印条码快捷打印Base64 图片打印Raw 指令打印通用 JSON 组合打印文字字号与加粗
产品界面
PrinterService:Android 系统打印机添加与管理
Android 系统打印机添加与管理
功能 03 / 06

标签、价签与小票接口

按业务选择标签、小票、商品价签和表格标签专用接口。

  • 标签接口可组合标题、条码、二维码和份数
  • 小票接口用于打印多行文本票据
  • 商品价签接口面向零售价签场景
  • 表格接口可组合文字、条码、二维码和图片单元格
  • 不同业务按用途选择接口,减少接入代码
文字对齐与换行标签专用接口小票专用接口商品价签接口表格标签接口AndroidPrinter 适配器
产品界面
PrinterService:HTTP / WebSocket 打印测试
HTTP / WebSocket 打印测试
功能 04 / 06

JSON 组合与队列打印

一次组合文字、条码、二维码和图片,并通过 H5 适配器按队列发送。

  • 通用 JSON 接口组合文本、条码、二维码和图片
  • AndroidPrinter 适配器支持队列式追加打印内容
  • 可设置文字字号、加粗、对齐和换行
  • 队列完成后一次发送完整打印任务
  • 正式文本业务优先使用 JSON 或小票专用接口
H5 打印队列Java 原生调用Kotlin 原生调用.NET MAUI 调用Xamarin.Android 调用Android PrintServiceAIDL 服务
产品界面
PrinterService:浓度、黑标、走纸与切纸等高级参数
浓度、黑标、走纸与切纸等高级参数
功能 05 / 06

多种 App 开发框架

支持 Android Java/Kotlin、.NET MAUI、Xamarin.Android 与 WebView 页面接入。

  • 支持 Android 原生 Java、Kotlin 调用
  • 支持 .NET MAUI、Xamarin.Android 的 C# 调用
  • 可作为 Android PrintService 接入系统打印流程
  • 提供 AIDL、前台直接打印和自动打印辅助能力
  • 已有 App 只需具备拉起自定义 Scheme 的能力即可接入
前台直接打印自动打印辅助打印浓度标签模式黑标控制走纸切纸
产品界面
PrinterService:设备授权、服务端口与运行设置
设备授权、服务端口与运行设置
功能 06 / 06

设备控制与运行维护

配置浓度、黑标、走纸和切纸,完成授权、测试、版本检查及在线升级。

  • 设置打印浓度、行距、字体、对齐和标签模式
  • 支持黑标、走纸、切纸等打印机控制
  • 内置测试页面核对文字、条码、二维码和图片
  • 设备序列号、二维码激活和授权便于终端管理
  • 支持版本检查、在线升级和异常排查
连接测试打印测试设备序列号二维码激活设备授权版本检查在线升级
产品界面
PrinterService:URL Scheme 与服务调用入口
URL Scheme 与服务调用入口

完整功能

按业务阶段查看系统功能

主要功能按真实业务阶段归类展示,便于同时了解一线操作、后台管理、数据查询和日常配置。
01 快速接入

网页与快捷打印

网页、H5 和 WebView 通过 printer:// 协议调用二维码、条码、图片或 JSON 组合任务,常见前端框架可直接复用。

  • printer:// URL Scheme
  • 网页 JavaScript 调用
  • Vue 页面调用
  • React 页面调用
  • Angular 页面调用
  • H5 页面调用
  • Android WebView 调用
  • 二维码快捷打印
  • 条码快捷打印
  • Base64 图片打印
  • Raw 指令打印
  • 通用 JSON 组合打印
  • 文字字号与加粗
02 业务接入

专用接口与开发框架

提供标签、小票、价签和表格接口,并支持 Android Java/Kotlin、.NET MAUI、Xamarin.Android 及系统打印服务。

  • 文字对齐与换行
  • 标签专用接口
  • 小票专用接口
  • 商品价签接口
  • 表格标签接口
  • AndroidPrinter 适配器
  • H5 打印队列
  • Java 原生调用
  • Kotlin 原生调用
  • .NET MAUI 调用
  • Xamarin.Android 调用
  • Android PrintService
  • AIDL 服务
03 终端运行

设备控制与运行维护

控制浓度、标签模式、黑标、走纸和切纸,配合测试、设备授权、版本检查及在线升级保障现场运行。

  • 前台直接打印
  • 自动打印辅助
  • 打印浓度
  • 标签模式
  • 黑标控制
  • 走纸切纸
  • 连接测试
  • 打印测试
  • 设备序列号
  • 二维码激活
  • 设备授权
  • 版本检查
  • 在线升级

业务流程

从业务发起到结果沉淀,形成完整闭环

每个关键节点在线协同、状态透明、过程可追溯,减少人工交接和重复登记。
适用对象Web 业务系统连锁门店与窗口终端仓储、物流与制造现场
01 安装服务
在打印终端完成轻量部署
02 连接设备
识别并配置可用打印机
03 系统调用
业务应用发送标准打印任务
04 状态回传
获取结果并处理异常任务

常见问题

上线前经常会确认的问题

围绕适用场景、现有数据、现场设备与业务配置,快速了解产品的实际使用方式。
01Vue、React 或普通网页如何接入?

页面最终都由浏览器运行 JavaScript,可将业务数据 URL 编码后拼接到 printer:// 地址并拉起服务;既有 H5 也可引入 AndroidPrinter 适配器。

02.NET MAUI 和 Xamarin.Android 可以使用吗?

可以。C# 侧对参数编码后打开 printer:// Scheme,文档提供通用打开方法、数据模型及标签、价签、表格和二维码示例。

03支持哪些打印内容?

支持条码、二维码、Base64 图片、标签、小票、商品价签、表格标签、Raw 指令和多内容 JSON 组合任务。

04可以控制切纸和黑标吗?

系统包含打印浓度、行距、字体、对齐、黑标、走纸和切纸等参数配置。

05正式业务应优先选择哪个接口?

单一二维码、条码或图片可使用快捷接口;标签、价签、小票和表格使用对应专用接口;复杂内容建议使用通用 JSON 组合打印。

06如何管理设备授权?

应用可展示设备序列号并生成激活二维码,通过授权服务完成设备认证、版本检查和在线升级。

产品咨询

结合您的业务流程,安排一次针对性演示

沟通组织规模、使用场景、现有流程和应用环境,我们将说明适配方式与实施建议。

378117356@qq.com邮件预约演示