Select your printer model

Parameters are refined by the selected printer.

setReceiveEventListener


Registers a listener method for a print completion event.

Syntax

 
public void setReceiveEventListener (ReceiveListener receiveListener) 

Parameter

target

Specifies an object which has a notification target method.

Listener interface

 
public interface ReceiveListener extends EventListener

Listener method

 
void onPtrReceive (Printer printerObj, int code, PrinterStatusInfo status, String printJobId)

Parameter

printerObj

The callback source object is stored.

code

The processing result is stored.

Error status

Description

CODE_SUCCESS

Print succeeded.

CODE_PRINTING

Printing

CODE_ERR_AUTORECOVER

Automatic recovery error occurred.

CODE_ERR_COVER_OPEN

Cover open error occurred.

CODE_ERR_CUTTER

Auto cutter error occurred.

CODE_ERR_MECHANICAL

Mechanical error occurred.

CODE_ERR_EMPTY

No paper is left in the roll paper end detector.

CODE_ERR_UNRECOVERABLE

Unrecoverable error occurred.

CODE_ERR_FAILURE

Error exists in the requested document syntax.

CODE_ERR_NOT_FOUND

Printer specified by the device ID does not exist.

CODE_ERR_SYSTEM

Error occurred with the printing system.

CODE_ERR_PORT

Error was detected with the communication port.

CODE_ERR_TIMEOUT

Print timeout occurred.

CODE_ERR_JOB_NOT_FOUND

Specified print job ID does not exist.

CODE_ERR_SPOOLER

Print queue is full.

CODE_ERR_BATTERY_LOW

Battery has run out.

CODE_ERR_TOO_MANY_REQUESTS

The number of print jobs sent to the printer has exceeded the allowable limit.

CODE_ERR_REQUEST_ENTITY_TOO_LARGE

The size of the print job data exceeds the capacity of the printer.

CODE_ERR_WAIT_REMOVAL

Print command sent while waiting for paper removal.

status

Status at the timing when the process was run is stored as the PrinterStatusInfo type.

printJobId

  • When the spooler function has been enabled, a print job ID is stored.
  • When the spooler function has been disabled, null is stored.

Supplementary explanation

  • When this API is run multiple times, the listener method specified later takes effect.
  • If null is specified in listener when calling this API, the registered listener method is canceled.
  • When a communication error occurs during ePOS-Device XML control, communication disconnection is not notified.
    To notify the disconnection event, implement the setConnectionEventListener.
  • When controlling multiple printers at a time, identify which printer has finished printing by comparing the Printer object in the caller and the printerObj parameter.
  • Check the details of automatic recovery errors and unrecoverable errors in getStatus.
 

Quick Access

  • [Name]
  • [Format]
  • [Range]
  • [Description]
  • [Notes]

Epson ePOS SDK includes patented or patent pending functions. The contents must not be disclosed to third parties.


Epson ePOS SDK for Android

Jump to the top