Capacitor Brother Print is a native Brother Print SDK implementation for iOS & Android. Support These models.
Documentation: Read the full documentation
This plugin is still in the RC (release candidate) phase.
Brother Print SDK is incompatible with CocoaPods and Minimum Developments iOS 14 and is not working at this time, please use Swift Package Manager.
Each product link is an Amazon affiliate link. If you choose to make a purchase through these links, it would be greatly appreciated and would help support development costs. Thank you!
| Product | Model | iOS/WiFi | iOS/BT | iOS/BLE | Android/USB | Android/WiFi | Android/BT | Android/BLE |
|---|---|---|---|---|---|---|---|---|
| QL-810W | QL_810W | ✗ | ✗ | ✗ | ◯ | ✗ | ✗ | ✗ |
| QL-820NWB | QL_820NWB | ◯ | ※1 | ✗ | △ | ◯ | △ | ✗ |
| QL-820NWBc | QL_820NWB | ◯ | ※2 | ✗ | ✗ | ◯ | ◯ | ✗ |
| TD-2320D | TD_2320D_203 | ✗ | ✗ | ✗ | △ | ✗ | ✗ | ✗ |
| TD-2350D | TD_2350D_300 | ◯ | △ | △ | ◯ | ◯ | ◯ | △ |
Amazon Affiliate Links: https://amzn.to/3AiiOFT
Supplement
| description | |
|---|---|
| ◯ | Supported and tested |
| △ | Implemented but not tested |
| - | Plugin is not supported |
| ✗ | Device is not supported |
| BT | Bluetooth |
| BLE | Bluetooth Low Energy |
※1 Due to low Bluetooth version, connection is not possible with iOS. Ref: https://okbizcs.okwave.jp/brother/qa/q9932082.html
※2 The iOS/BT implementation for the QL-820NWBc is in place, but it’s uncertain if it functions correctly. It’s unclear whether this is an implementation issue, as Brother’s official app also doesn’t work well.
% npm install @rdlabo/capacitor-brotherprint
For detailed SDK setup and permission configuration, see Installation.
See Search, Print, and Events.
printImage(...)search(...)isChannelAvailable(...)cancelSearchWiFiPrinter()cancelSearchBluetoothPrinter()addListener(BrotherPrintEventsEnum.onPrinterAvailable, ...)addListener(BrotherPrintEventsEnum.onPrint, ...)addListener(BrotherPrintEventsEnum.onPrintFailedCommunication, ...)addListener(BrotherPrintEventsEnum.onPrintError, ...)- Interfaces
- Type Aliases
- Enums
printImage(options: BRLMPrintOptions) => Promise<void>| Param | Type |
|---|---|
options |
BRLMPrintOptions |
search(option: BRLMSearchOption) => Promise<void>Search for printers. If not found, it will return an empty array.(not error)
| Param | Type |
|---|---|
option |
BRLMSearchOption |
isChannelAvailable(option: BRLMChannelResult) => Promise<isChannelAvailableResult>If you have saved the last connected BRLMChannelResult, you can use it to verify whether it is currently usable.
| Param | Type |
|---|---|
option |
BRLMChannelResult |
Returns: Promise<isChannelAvailableResult>
cancelSearchWiFiPrinter() => Promise<void>Basically, it times out, so there is no need to use it. Use it when you want to run multiple connectType searches at the same time and time out any of them manually.
cancelSearchBluetoothPrinter() => Promise<void>Basically, it times out, so there is no need to use it. Use it when you want to run multiple connectType searches at the same time and time out any of them manually.
addListener(eventName: BrotherPrintEventsEnum.onPrinterAvailable, listenerFunc: (printers: BRLMChannelResult) => void) => Promise<PluginListenerHandle>Find the printer that can connected to the device.
| Param | Type |
|---|---|
eventName |
BrotherPrintEventsEnum.onPrinterAvailable |
listenerFunc |
(printers: BRLMChannelResult) => void |
Returns: Promise<PluginListenerHandle>
addListener(eventName: BrotherPrintEventsEnum.onPrint, listenerFunc: () => void) => Promise<PluginListenerHandle>Success Print Event
| Param | Type |
|---|---|
eventName |
BrotherPrintEventsEnum.onPrint |
listenerFunc |
() => void |
Returns: Promise<PluginListenerHandle>
addListener(eventName: BrotherPrintEventsEnum.onPrintFailedCommunication, listenerFunc: (info: ErrorInfo) => void) => Promise<PluginListenerHandle>Failed to connect to the printer. ex: Bluetooth is off, Printer is off, etc.
| Param | Type |
|---|---|
eventName |
BrotherPrintEventsEnum.onPrintFailedCommunication |
listenerFunc |
(info: ErrorInfo) => void |
Returns: Promise<PluginListenerHandle>
addListener(eventName: BrotherPrintEventsEnum.onPrintError, listenerFunc: (info: ErrorInfo) => void) => Promise<PluginListenerHandle>Failed to print.
| Param | Type |
|---|---|
eventName |
BrotherPrintEventsEnum.onPrintError |
listenerFunc |
(info: ErrorInfo) => void |
Returns: Promise<PluginListenerHandle>
| Prop | Type |
|---|---|
remove |
() => Promise<void> |
{ encodedImage: string; /** * Should use enum BRLMPrinterModelName */ modelName: BRLMPrinterModelName; } & Partial<BRLMChannelResult> & (BRLMPrinterQLModelSettings | BRLMPrinterTDModelSettings)
Make all properties in T optional
{
[P in keyof T]?: T[P];
}
{ port: BRLMPrinterPort; modelName: string; serialNumber: string; macAddress: string; nodeName: string; location: string; /** * This need to connect to the printer. * wifi: IP Address * bluetooth: macAddress * bluetoothLowEnergy: modelName for bluetoothLowEnergy */ channelInfo: string; }
{ /** * Should use enum BRLMPrinterLabelName */ labelName: BRLMPrinterLabelName; } & BRLMPrinterSettings
These are optional. If these are not set, default values are assigned by the printer.
{ /** * The number of copies you print. / numberOfCopies?: BRLMPrinterNumberOfCopies; /* * Whether the auto-cut is enabled or not. If true, your printer cut the paper each page. / autoCut?: BRLMPrinterAutoCutType; /* * A scale mode that specifies how your data is scaled in a print area of your printer. / scaleMode?: BRLMPrinterScaleMode; /* * A scale value. This is effective when ScaleMode is ScaleValue. / scaleValue?: BRLMPrinterScaleValueType; /* * A way to rasterize your data. / halftone?: BRLMPrinterHalftone; /* * A threshold value. This is effective when the Halftone is Threshold. / halftoneThreshold?: BRLMPrinterHalftoneThresholdType; /* * An image rotation that specifies the angle in which your data is placed in the print area. Rotation direction is clockwise. / imageRotation?: BRLMPrinterImageRotation; /* * A vertical alignment that specifies how your data is placed in the printable area. / verticalAlignment?: BRLMPrinterVerticalAlignment; /* * A horizontal alignment that specifies how your data is placed in the printable area. / horizontalAlignment?: BRLMPrinterHorizontalAlignment; /* * A compress mode that specifies how to compress your data. * note: This is ios only. / compressMode?: BRLMPrinterCompressMode; /* * A priority that is print speed or print quality. Whether or not this has an effect is depend on your printer. */ printQuality?: BRLMPrinterPrintQuality; }
number
boolean
number
number
{ /** * Should use enum BRKMPrinterCustomPaperType / paperType: BRLMPrinterCustomPaperType; /* * The width of the label. For example, the RD-U04J1 is 60.0 wide. / tapeWidth: number; /* * The length of the label. For example, the RD-U04J1 is 60.0 wide. / tapeLength: number; /* * It is the difference between a sticker and a mount. * For example, the RD-U04J1 is 1.0, 2.0, 1.0, 2.0 / marginTop: number; marginRight: number; marginBottom: number; marginLeft: number; /* * The spacing between seals. For example, the RD-U04J1 is 0.2. / gapLength: number; paperMarkPosition: number; paperMarkLength: number; /* * Should use enum BRKMPrinterCustomPaperUnit. * For example, the RD-U04J1 is mm. */ paperUnit: BRLMPrinterCustomPaperUnit; }
{ /** * 'usb' is android only, and now developing. / port: BRLMPrinterPort; /* * searchDuration is the time to end search for devices. * default is 15 seconds. * use only port is 'wifi' or 'bluetoothLowEnergy'. */ searchDuration: number; }
{ result: boolean; }
{ message: string; code: number; }
| Members | Value |
|---|---|
QL_800 |
'QL_800' |
QL_810W |
'QL_810W' |
QL_820NWB |
'QL_820NWB' |
TD_2320D_203 |
'TD_2320D_203' |
TD_2030AD |
'TD_2030AD' |
TD_2350D_300 |
'TD_2350D_300' |
| Members | Value |
|---|---|
usb |
'usb' |
wifi |
'wifi' |
bluetooth |
'bluetooth' |
bluetoothLowEnergy |
'bluetoothLowEnergy' |
| Members | Value | Description |
|---|---|---|
DieCutW17H54 |
'DieCutW17H54' |
|
DieCutW17H87 |
'DieCutW17H87' |
|
DieCutW23H23 |
'DieCutW23H23' |
|
DieCutW29H42 |
'DieCutW29H42' |
|
DieCutW29H90 |
'DieCutW29H90' |
|
DieCutW38H90 |
'DieCutW38H90' |
|
DieCutW39H48 |
'DieCutW39H48' |
|
DieCutW52H29 |
'DieCutW52H29' |
|
DieCutW62H29 |
'DieCutW62H29' |
|
DieCutW62H60 |
'DieCutW62H60' |
|
DieCutW62H75 |
'DieCutW62H75' |
|
DieCutW62H100 |
'DieCutW62H100' |
|
DieCutW60H86 |
'DieCutW60H86' |
|
DieCutW54H29 |
'DieCutW54H29' |
|
DieCutW102H51 |
'DieCutW102H51' |
|
DieCutW102H152 |
'DieCutW102H152' |
|
DieCutW103H164 |
'DieCutW103H164' |
|
RollW12 |
'RollW12' |
|
RollW29 |
'RollW29' |
|
RollW38 |
'RollW38' |
|
RollW50 |
'RollW50' |
|
RollW54 |
'RollW54' |
|
RollW62 |
'RollW62' |
|
RollW62RB |
'RollW62RB' |
|
RollW102 |
'RollW102' |
|
RollW103 |
'RollW103' |
|
DTRollW90 |
'DTRollW90' |
|
DTRollW102 |
'DTRollW102' |
|
DTRollW102H51 |
'DTRollW102H51' |
|
DTRollW102H152 |
'DTRollW102H152' |
|
RoundW12DIA |
'RoundW12DIA' |
|
RoundW24DIA |
'RoundW24DIA' |
|
RoundW58DIA |
'RoundW58DIA' |
|
RDDieCutW60H60 |
'RDDieCutW60H60' |
For TD series |
RDDieCutW50H30 |
'RDDieCutW50H30' |
|
RDDieCutW40H60 |
'RDDieCutW40H60' |
|
RDDieCutW40H50 |
'RDDieCutW40H50' |
|
RDDieCutW40H40 |
'RDDieCutW40H40' |
|
RDDieCutW30H30 |
'RDDieCutW30H30' |
|
RDDieCutW50H35 |
'RDDieCutW50H35' |
|
RDDieCutW60H80 |
'RDDieCutW60H80' |
|
RDDieCutW60H100 |
'RDDieCutW60H100' |
| Members | Value |
|---|---|
ActualSize |
'ActualSize' |
FitPageAspect |
'FitPageAspect' |
FitPaperAspect |
'FitPaperAspect' |
ScaleValue |
'ScaleValue' |
| Members | Value |
|---|---|
Threshold |
'Threshold' |
ErrorDiffusion |
'ErrorDiffusion' |
PatternDither |
'PatternDither' |
| Members | Value |
|---|---|
Rotate0 |
'Rotate0' |
Rotate90 |
'Rotate90' |
Rotate180 |
'Rotate180' |
Rotate270 |
'Rotate270' |
| Members | Value |
|---|---|
Top |
'Top' |
Center |
'Center' |
Bottom |
'Bottom' |
| Members | Value |
|---|---|
Left |
'Left' |
Center |
'Center' |
Right |
'Right' |
| Members | Value |
|---|---|
None |
'None' |
Tiff |
'Tiff' |
Mode9 |
'Mode9' |
| Members | Value |
|---|---|
Best |
'Best' |
Fast |
'Fast' |
| Members | Value |
|---|---|
rollPaper |
'rollPaper' |
dieCutPaper |
'dieCutPaper' |
markRollPaper |
'markRollPaper' |
| Members | Value |
|---|---|
mm |
'mm' |
inch |
'inch' |
| Members | Value |
|---|---|
onPrinterAvailable |
'onPrinterAvailable' |
onPrint |
'onPrint' |
onPrintFailedCommunication |
'onPrintFailedCommunication' |
onPrintError |
'onPrintError' |
MIT