打印
==================



SDK升级说明
+++++++++++++++++++++++++++++

升级说明
^^^^^^^^^^^^^^^^^^^^^

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

新旧功能对比
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. image:: ../images/Printer/SDK-Difference-contrast.png
    :width: 800


SDK V2.0
++++++++++++++++++++++

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

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

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

内置打印机文档：`一敏内置打印机开发人员文档 v2.0 <https://yimin-resources.oss-cn-shanghai.aliyuncs.com/demo/%E4%B8%80%E6%95%8F%E6%89%93%E5%8D%B0SDK%202.0%20%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3.pdf>`_

1. 接入SDK
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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

.. code-block:: java
        :linenos:
        :emphasize-lines: 6

        android {
            ...
        }

        dependencies {
            implementation 'com.github.iminsoftware:IminPrinterLibrary:V1.0.0.12'
        }


2. 参考Demo
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. image:: ../images/Printer/demo.png
    :width: 800

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

`Github address <https://github.com/iminsoftware/IminPrinterLibrary>`_


3. 网页打印
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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

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

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


4. JavaScript API
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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

点击下载 `JS Print SDK <https://oss-sg.imin.sg/docs/demo/iMinJSPrinterSDK.zip>`_

Demo案例
    `JS Printer demo <https://mp.neostra.com/JSPrinter/>`_

`JS 打印文档 <JSPrinterSDK.html>`_

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

5. Flutter
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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

`Github address <https://pub.dev/packages/imin_printer>`_

`Flutter 打印文档 <https://iminsoftware.github.io/imin_printer/#/zh-cn/v2/>`_

SDK V1.0
++++++++++++++++++++++

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

打印机与ESC＆POS命令兼容，但与标准ESC & POS命令略有不同。 开发人员可以参考内置打印机开发文档，以了解打印机的工作模式和接口调用方法，并了解一敏通过指令文档支持的ESC & POS指令集 `内置打印机开发文档 v1.0 <https://yimin-resources.oss-cn-shanghai.aliyuncs.com/demo/%E4%B8%80%E6%95%8FPrinterSDK1.0%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3.pdf>`_

1. 接入SDK
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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

SDK版本列表：

* v1.1.0     `下载打印Demo源码 <https://imin-sg-resources.oss-ap-southeast-1.aliyuncs.com/docs/demo/iMinPrinterDemo-v1.3.0.zip>`_

* v1.2.0     `下载打印Demo源码 <https://imin-sg-resources.oss-ap-southeast-1.aliyuncs.com/docs/demo/iMinPrinterDemo-v1.3.1.zip>`_

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


2. 网页打印
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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

打印案例

    桌面式收银设备 https://mp.neostra.com/WebPrint/D.html

    手持式收银设备 https://mp.neostra.com/WebPrint/M.html

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


3. JavaScript API
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

点击下载 `JS Print SDK <https://oss-sg.imin.sg/docs/demo/iMinJSPrinterSDK.zip>`_

Demo案例
    `JS Printer demo <https://mp.neostra.com/JSPrinter/>`_

`JS 打印文档 <JSPrinterSDK.html>`_

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

4. Flutter
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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

`Github address <https://pub.dev/packages/imin_printer>`_

`Flutter 打印文档 <https://iminsoftware.github.io/imin_printer/#/zh-cn/>`_

使用外置打印机
++++++++++++++++++++++

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

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

当前外置打印机包括：

1. HPRT Printer(普瑞特打印机)
  * 点击下载 `普瑞特TP808 SDK <https://yimin-resources.oss-cn-shanghai.aliyuncs.com/demo/%E6%99%AE%E7%91%9E%E7%89%B9TP808_Android_Print_SDKV1.22.01.zip>`_

2. SEIKO Printer(精工打印机)





打印服务常见问题解答
++++++++++++++++++++++++++++++++++

**打印纸张规格**

.. image:: ../images/Printer/PrinterPageMode.png
    :width: 800

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

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

什么是打印机分辨率？

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

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