打印

SDK升级说明

升级说明

为了方便开发人员调用一敏POS设备的内置打印机,也为了降低打印机开发的难度,简化app接口,我们重新构建了打印SDK。

新旧功能对比

_images/SDK-Difference-contrast.png

SDK V2.0

连接方式:蓝牙(蓝牙设备名称:BluetoothPrinter)、AIDL等。

第三方应用程序可以通过连接到内置打印机来打印。iMin打印机功能:58和80mm热敏打印机,两种打印规格,切割机(部分机器)

开发人员可以参考内置的打印机开发文档来了解打印机的工作原理以及如何调用接口

内置打印机文档:一敏内置打印机开发人员文档 v2.0

1. 接入SDK

打印SDK通过远程仓库获取,只需要在调用模块的build.gradle中添加依赖

1android {
2    ...
3}
4
5dependencies {
6    implementation 'com.github.iminsoftware:IminPrinterLibrary:V1.0.0.12'
7}

2. 参考Demo

_images/demo.png

您可以参考SDK使用Demo的源代码进行开发,点击下面的链接跳转下载上面相应的Demo

Github address

3. 网页打印

Demo Case

Desktop POS https://mp.neostra.com/WebPrint/D.html

Moblie POS https://mp.neostra.com/WebPrint/M.html

备注

SDK V2.0不需要安装iMinprinterplugin插件,在设备浏览器中输入以下URL地址体验网页打印案例

4. JavaScript API

开发人员可以使用 JavaScript API 调用内置打印机

点击下载 JS Print SDK

Demo案例

JS Printer demo

JS 打印文档

备注

SDK V2.0不需要安装iMinprinterplugin插件。

5. Flutter

您可以参考SDK使用Demo的源代码进行开发,点击下面的链接跳转下载上面相应的Demo

Github address

Flutter 打印文档

SDK V1.0

连接方法:蓝牙/USB。 第三方应用程序可以连接内置打印机打印。一敏打印机中包含的功能:两种印刷规格为58mm和80mm,切刀(部分设备),钱箱(部分设备)

打印机与ESC&POS命令兼容,但与标准ESC & POS命令略有不同。 开发人员可以参考内置打印机开发文档,以了解打印机的工作模式和接口调用方法,并了解一敏通过指令文档支持的ESC & POS指令集 内置打印机开发文档 v1.0

1. 接入SDK

一敏提供打印演示和源代码,并支持常见的打印功能,例如:打印QR Code,打印条形码,打印图片,以各种语言的打印文本,打印表单等。Demo支持蓝牙和USB连接方法。 开发在开发打印功能时,开发人员需要使用对应型号的SDK进行调整适配。

SDK版本列表:

备注

说明:该演示仅支持一敏内置打印机,外接蓝牙/USB打印机不适用于此Demo。

2. 网页打印

一敏支持Web/JS方式调用本机内置进行打印。 用户可以通过应用商店搜索iMinprinterplugin,然后下载和安装它后,他们可以通过浏览器的打印功能打印网页内容。

打印案例

备注

在设备浏览器中输入以下URL地址以体验JS打印案例。

3. JavaScript API

点击下载 JS Print SDK

Demo案例

JS Printer demo

JS 打印文档

备注

用户可以通过应用商店搜索iMinprinterplugin,然后下载和安装它后才能使用JavaScript API。

4. Flutter

您可以参考SDK使用Demo的源代码进行开发,点击下面的链接跳转下载上面相应的Demo

Github address

Flutter 打印文档

使用外置打印机

一敏打印机主要包括⼀体机内置打印机和外置独⽴打印机两种类型,本⽂档主要介绍通过SDK快速使用外置打印机;

开发打印机程序之前,您需要对票据打印机的工作原理和ESC/POS指令集有一定的理解,才能理解票据排版所需的基本知识;

当前外置打印机包括:

  1. HPRT Printer(普瑞特打印机)

  1. SEIKO Printer(精工打印机)

打印服务常见问题解答

打印纸张规格

_images/PrinterPageMode.png

注意: 一敏打印机支持58mm和80mm的打印纸。 该文档使用58毫米打印纸作为示例来解释打印机的支持参数。 80mm打印纸的规格相似

一张58张印刷纸的宽度为58mm,有效的打印宽度为48mm。 有效的打印宽度为384像素点。

什么是打印机分辨率?

打印机分辨率为205DPI,计算公式如下

DPI=384dots/48mm=8dots/1mm=205dots/in=205