映美打印机

mtl支持版本6.0.6及以上

封装映美CFP-820BW针式云打印机局域网wifi、蓝牙打印的相关操作，支持打印html、图片，使用前请先按照说明书配置网络。图片仅支持jpg、png格式，大小不能超过600K。打印html仅支持本地静态htlm通过局域网wifi链接打印。手机系统支持Android 7.0以上手机，ios暂不支持。

搜索可用的映美打印设备

searchDevices

搜索可用的映美打印设备，需要手机开启蓝牙和位置；使用局域网wifi,需要先扫描打印机上的二维码，配置网络
支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✘

参数

字段 类型 默认值 必填 说明
time number 10 是 搜索超时时间，默认10秒，超出时间后没有搜索到可用设备时需要重新搜索
type string all 是 搜索类型，参考值：
"wifi":局域网wifi;
"classic":蓝牙经典版；
"ble":蓝牙低功耗版;
"all":包括全面三种全部
callback function 是 搜索数据回调函数

注意：

  • 注意：打印效果wifi>classic>ble;使用ble打印图片数据量较大会出现数据丢包进而出现打印乱码的现象；搜索不到打印机wifi的时候需要扫描打印机上的二维码重新配网

示例

mtl.ymPrinter.searchDevices({
  time:10,
  type:'all',
  callback: function(res){
    const status = res.status,//布尔类型：true：表示扫描到设备，false
    const eventType = res.eventType,   //字符串类型：//startDevices 表示开始搜索； //stopDevices 表示结束搜索；//findDevices表示发现设备，只要搜索到新的就会一直回调，直到搜索结束
    const deviceInfos = res.deviceInfos, //JSonArray,eventType为"findDevices"时返回搜索到的打印设备信息
  },
  success: function(res) {
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

是否支持蓝牙BLE

isSupportedBLE

支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✘

参数
-无-
示例

mtl.ymPrinter.isSupportedBLE({
  success: function(res) {
    const isSupportedBLE = res.isSupportedBLE,//布尔类型：布尔类型：true：支持，false：不支持
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

蓝牙是否开启

isBluetoothOpen

支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✘

参数
-无-
示例

mtl.ymPrinter.isBluetoothOpen({
  success: function(res) {
    const isBluetoothOpen = res.isBluetoothOpen,//布尔类型：布尔类型：true：支持，false：不支持
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

获取已链接设备信息

getConnectedDevice

支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✘

参数
-无-
示例

mtl.ymPrinter.getConnectedDevice({
  success: function(res) {
    const status = res.status,//布尔类型：true:表示有设备链接；false表示无设备链接
    const deviceInfo = res.deviceInfo//JSon对象，status为 true 时返回，内部字段如下：
              //wifi搜索: address为ip地址,  did为打印机编号,  pstatus为打印机状态:(0 空闲 1 忙碌 2 异常),  mdl为打印机型号.  (作为打印参数时:则必须有address和did)
              //蓝牙搜索: address 为mac地址, did为蓝牙名  (做为打印参数时:则必须有address)
              //transType:打印类型（BLE/CLASSIC/WIFI），打印时必须有该参数
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

打印图片

printPicture

打印图片, 注意图片仅支持png和jpg格式的，大小有限制，不能超过600K
支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✘

参数

字段 类型 默认值 必填 说明
deviceInfo obj
是 searchDevices方法中返回的deviceInfos中的任意一个都可以选择
path string
是 本地图片的路径，支持fs、绝对路径

示例

mtl.ymPrinter.printPicture({
  deviceInfo:{"address":"DC:E9:94:8B:4B:8A","did":"DESKTOP-1MPSR34","mdl":null,"progress":0,"pstatus":0,"status":0,"taskid":null,"tp":0,"transType":"TRANS_CLASSIC"},
  path:'https://pic2.ntimg.cn/pic/20220520/25297851_161452446108_4.jpg',
  success: function(res) {
    const status = res.status,//布尔类型：true：数据发送成功，false：数据发送失败
    const msg = res.msg //字符串类型： status为 false 时返回错误信息
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

打印html

printHTML

支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✘

参数

字段 类型 默认值 必填 说明
deviceInfo obj
是 searchDevices方法中返回的deviceInfos中的任意一个都可以选择
path string
是 本地html的路径，支持fs、绝对路径

注意：CFP-820BW只支持wifi链接打印；支持标准规范的html标签，样式只能支持到IE11内核，可以打印表格数据以及标准规范排版页面，html页面的body宽度不大于打印机的纸张宽度值，Body宽度的像素最大值等于纸张宽度*打印机dpi/25.4打印机的dpi值。CFP-820BW的dpi值为180。
示例

mtl.ymPrinter.printHTML({
  deviceInfo:{"address":"DC:E9:94:8B:4B:8A","did":"DESKTOP-1MPSR34","mdl":null,"progress":0,"pstatus":0,"status":0,"taskid":null,"tp":0,"transType":"TRANS_CLASSIC"},
  path:'/storage/emulated/0/Android/data/com.yongyou.youpu.debug/files/ymprinter/25297851_161452446108_4.jpg',
  success: function(res) {
    const status = res.status,//布尔类型：true：数据发送成功，false：数据发送失败
    const msg = res.msg //字符串类型： status为 false 时返回错误信息
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

选择一个文件打印

printFile

打开系统的文件选择器，选择一个文件打印，只支持图片、html文件；pdf需要转成图片后才能打印。打印图片大小不能超过600K,图片格式为jpg、png。
支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✘

参数

字段 类型 默认值 必填 说明
deviceInfo obj
是 searchDevices方法中返回的deviceInfos中的任意一个都可以选择

示例

mtl.ymPrinter.printFile({
  deviceInfo:{"address":"DC:E9:94:8B:4B:8A","did":"DESKTOP-1MPSR34","mdl":null,"progress":0,"pstatus":0,"status":0,"taskid":null,"tp":0,"transType":"TRANS_CLASSIC"},
  path:'/storage/emulated/0/Android/data/com.yongyou.youpu.debug/files/ymprinter/25297851_161452446108_4.jpg',
  success: function(res) {
    const status = res.status,//布尔类型：true：数据发送成功，false：数据发送失败
    const msg = res.msg //字符串类型： status为 false 时返回错误信息
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

停止搜索

stopSearch

支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✘

参数
-无-
示例

mtl.ymPrinter.stopSearch({
  success: function(res) {
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

关闭链接

closeConnect

关闭链接，调用该方法会关闭与打印机的通信，未发送完的数据会丢失，应当在不需要连接的时候使用。
支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✘

参数
-无-
示例

mtl.ymPrinter.closeConnect({
  success: function(res) {
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

释放资源

release

释放资源，调用该方法会关闭与打印机的通信，日志写入也会停止。可以在APP退出或页面关闭时调用。
支持平台

微信 友空间 安卓 iOS
✘ ✔︎ ✔︎ ✘

参数
-无-
示例

mtl.ymPrinter.release({
  success: function(res) {
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});
是否仍需要帮助？ 请保持联络！
最后更新于 2024/04/24