capacitor-ble-printer2

Capacitor plugin for Zebra printers with Bluetooth.

Install

npm install capacitor-ble-printer2
npx cap sync

Android

Add the following to your AndroidManifest.xml

<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>
<uses-permission android:name="android.permission.BLUETOOTH_SCAN"/>

Usage

You can send data in ZPL Zebra

import { ZPLPrinter } from 'capacitor-ble-printer2'

//Bounded Devices
ZPLPrinter.listenPrinters().then(value => {
    console.log(value.devices);
});

//Print Text
var printText = "^XA"
	+ "^FO20,20^A0N,25,25^FDThis is a ZPL test.^FS"
	+ "^XZ";

var printerOpts: PrinterOptions = {
    macAddress: macAddressPrinter,
    printText: printText
}

ZPLPrinter.print(printerOpts).then(_ => {
    console.log("Printer Ok!")
}

API

• print(...)
• listenPrinters()
• openBluetoothSettings()
• enableBluetooth()
• getStatusPrinter(...)
• getZPLFromImage(...)
• Interfaces

print(...)

print(options: PrinterOptions) => Promise<any>

You can send data in ZPL Zebra Programing Language

Param	Type
options	PrinterOptions

Returns: Promise<any>

---

listenPrinters()

listenPrinters() => Promise<{ devices: BluetoothDevices[]; }>

Discover bonded devices

Returns: Promise<{ devices: BluetoothDevices[]; }>

---

openBluetoothSettings()

openBluetoothSettings() => Promise<any>

Show the Bluetooth settings on the device

Returns: Promise<any>

---

enableBluetooth()

enableBluetooth() => Promise<any>

Enable Bluetooth on the device

Returns: Promise<any>

---

getStatusPrinter(...)

getStatusPrinter(options: StatusPrinterOptions) => Promise<{ status: string; }>

You can get a status response from a connected Zebra printer using

Param	Type
options	StatusPrinterOptions

Returns: Promise<{ status: string; }>

---

getZPLFromImage(...)

getZPLFromImage(options: ZPLConverterOptions) => Promise<{ zplCode: string; }>

Get ZPL equivalent code from the base64 Image string

Param	Type
options	ZPLConverterOptions

Returns: Promise<{ zplCode: string; }>

---

Interfaces

PrinterOptions

Prop	Type	Description
macAddress	string	Identifier of the remote device
printText	string	text to print

BluetoothDevices

Prop	Type	Description
name	string	Name of the remote device
macAddress	string	Identifier of the remote device
id	string
class	string

StatusPrinterOptions

Prop	Type	Description
macAddress	string	Identifier of the remote device

ZPLConverterOptions

Prop	Type	Description
base64Image	string	base64 Image string
blacknessPercentage	number	Want to add header/footer ZPL code or not
addHeaderFooter	boolean	Want to add header/footer ZPL code or not