src="docs/logo.png"
width="600"
style="margin-top: 20px; margin-bottom: 20px;"
/>

- 日本語

react-native-star-io10

react-native-star-io10 is a library for supporting application development for Star Micronics devices.

This library is included in StarXpand SDK.

Requirements

| Platform | Version |
| --- | --- |
| iOS | iOS 12.0 or later |
| Android | Android 6.0 or later |
| Windows | Windows 10 1909 or later |

Installation

``
npm install react-native-star-io10 --save
`

$3

- Add key and value in info.plist.
- NSBluetoothAlwaysUsageDescription (iOS 13.0 or later)
- NSLocalNetworkUsageDescription (iOS 14.0 or later)
- UISupportedExternalAccessoryProtocols (Add the following value to the array)
- jp.star-m.starpro

$3

- No setup needed.

$3

- Add Capability in Package.appxmanifest.
- Bluetooth
- Internet (Client)
- Private Networks (Client & Server)
- Disable Compile with .NET Native tool chain.

Documentation

Please refer here.

Examples

$3

`typescript
manager: StarDeviceDiscoveryManager;

async discover(): Promise {
try {
// Specify your printer interface types.
manager = await StarDeviceDiscoveryManagerFactory.create([
InterfaceType.Lan,
InterfaceType.Bluetooth,
InterfaceType.BluetoothLE,
InterfaceType.Usb
]);

// Set discovery time. (option)
manager.discoveryTime = 10000;

// Callback for printer found.
manager.onPrinterFound = (printer: StarPrinter) => {
console.log(printer);
};

// Callback for discovery finished. (option)
manager.onDiscoveryFinished = () => {
console.log(Discovery finished.);
};

// Start discovery.
await manager.startDiscovery();

// Stop discovery.
// await manager.stopDiscovery()
}
catch(error) {
// Error.
console.log(error);
}
}
`

$3

`typescript
async print(): Promise {
// Specify your printer connection settings.
var settings = new StarConnectionSettings();
settings.interfaceType = InterfaceType.Lan;
settings.identifier = '00:11:62:00:00:00';
var printer = new StarPrinter(settings);

try {
// Connect to the printer.
await printer.open();

// create printing data. (Please refer to 'Create Printing data')
var builder = new StarXpandCommand.StarXpandCommandBuilder();
// ...
var commands = await builder.getCommands();

// Print.
await printer.print(commands);
}
catch(error) {
// Error.
console.log(error);
}
finally {
// Disconnect from the printer and dispose object.
await printer.close();
await printer.dispose();
}
}
`

$3

`typescript
// Create printing data using StarXpandCommandBuilder object.
var builder = new StarXpandCommand.StarXpandCommandBuilder();
builder.addDocument(new StarXpandCommand.DocumentBuilder()
.addPrinter(new StarXpandCommand.PrinterBuilder()
.actionPrintImage(new StarXpandCommand.Printer.ImageParameter("logo_01.png", 406))
.styleInternationalCharacter(StarXpandCommand.Printer.InternationalCharacterType.Usa)
.styleCharacterSpace(0)
.styleAlignment(StarXpandCommand.Printer.Alignment.Center)
.actionPrintText("Star Clothing Boutique\n" +
"123 Star Road\n" +
"City, State 12345\n" +
"\n")
.styleAlignment(StarXpandCommand.Printer.Alignment.Left)
.actionPrintText("Date:MM/DD/YYYY Time:HH:MM PM\n" +
"--------------------------------\n" +
"\n")
.actionPrintText("SKU Description Total\n" +
"300678566 PLAIN T-SHIRT 10.99\n" +
"300692003 BLACK DENIM 29.99\n" +
"300651148 BLUE DENIM 29.99\n" +
"300642980 STRIPED DRESS 49.99\n" +
"300638471 BLACK BOOTS 35.99\n" +
"\n" +
"Subtotal 156.95\n" +
"Tax 0.00\n" +
"--------------------------------\n")
.actionPrintText("Total ")
.add(new StarXpandCommand.PrinterBuilder()
.styleMagnification(new StarXpandCommand.MagnificationParameter(2, 2))
.actionPrintText(" $156.95\n")
)
.actionPrintText("--------------------------------\n" +
"\n" +
"Charge\n" +
"156.95\n" +
"Visa XXXX-XXXX-XXXX-0123\n" +
"\n")
.add(new StarXpandCommand.PrinterBuilder()
.styleInvert(true)
.actionPrintText("Refunds and Exchanges\n")
)
.actionPrintText("Within ")
.add(new StarXpandCommand.PrinterBuilder()
.styleUnderLine(true)
.actionPrintText("30 days")
)
.actionPrintText(" with receipt\n")
.actionPrintText("And tags attached\n" +
"\n")
.styleAlignment(StarXpandCommand.Printer.Alignment.Center)
.actionPrintBarcode(new StarXpandCommand.Printer.BarcodeParameter('0123456',
StarXpandCommand.Printer.BarcodeSymbology.Jan8)
.setBarDots(3)
.setBarRatioLevel(StarXpandCommand.Printer.BarcodeBarRatioLevel.Level0)
.setHeight(5)
.setPrintHri(true))
.actionFeedLine(1)
.actionPrintQRCode(new StarXpandCommand.Printer.QRCodeParameter('Hello World.\n')
.setModel(StarXpandCommand.Printer.QRCodeModel.Model2)
.setLevel(StarXpandCommand.Printer.QRCodeLevel.L)
.setCellSize(8))
.actionCut(StarXpandCommand.Printer.CutType.Partial)
)
);

// Get printing data from StarXpandCommandBuilder object.
var commands = await builder.getCommands();
`

$3

`typescript
async getStatus(): Promise {
// Specify your printer connection settings.
var settings = new StarConnectionSettings();
settings.interfaceType = InterfaceType.Lan;
settings.identifier = '00:11:62:00:00:00';
var printer = new StarPrinter(settings);

try {
// Connect to the printer.
await printer.open();

// Get printer status.
var status = await printer.getStatus();
console.log(status);
}
catch(error) {
// Error.
console.log(error);
}
finally {
// Disconnect from the printer and dispose object.
await printer.close();
await printer.dispose();
}
}
`

$3

`typescript
printer: StarPrinter;

async monitor(): Promise {
// Specify your printer connection settings.
var settings = new StarConnectionSettings();
settings.interfaceType = InterfaceType.Lan;
settings.identifier = '00:11:62:00:00:00';
printer = new StarPrinter(settings);

// Callback for printer state changed.
printer.printerDelegate.onReady = () => {
console.log(Printer: Ready);
}
printer.drawerDelegate.onOpenCloseSignalSwitched = (openCloseSignal) => {
console.log(Drawer: Open Close Signal Switched: ${String(openCloseSignal)});
}
printer.inputDeviceDelegate.onDataReceived = (data) => {
console.log(Input Device: DataReceived ${String(data)});
}
printer.displayDelegate.onConnected = () => {
console.log(Display: Connected);
}
// ...
// Please refer to document for other callback.

try {
// Connect to the printer.
await printer.open();
}
catch(error) {
// Error.
console.log(error);
}
}
`

- example` project is located in this directory.

Copyright

Copyright 2021 Star Micronics Co., Ltd. All rights reserved.