CITIZEN Android Label Print SDK
—
Programming Manual
26
2.2.10 searchCitizenPrinter method
Syntax
CitizenPrinterInfo[] searchCitizenPrinter (int ifType, int searchTime, int[] result)
Parameters
Parameter
[IN/OUT] Description
Setting range
ifType
[IN]
Connection type
CLS_PORT_WiFi
CLS_PORT_Bluetooth
CLS_PORT_Bluetooth_Insecure
searchTime
[IN]
Time out (sec)
0:
Get paired address in the case of
CLS_PORT_Bluetooth or
CLS_PORT_Bluetooth_Insecure.
1 - 30:
Search for a specified time.
result
[OUT]
Error code
The output parameter, result receives CLS_SUCCESS (0) on success, an error code otherwise. See
below for the error codes. "
" describes all error codes.
Error code
Description
CLS_E_NOCONTEXT (1006)
No context is specified.
CLS_E_ILLEGAL (1101)
Invalid parameter.
(1) The connect type is unsupported.
(2) The time out value is out of range.
CLS_E_NO_LIST (1106)
No printer found.
Description
Searches available Citizen printers and obtains a list of printer information. The connection type and
time out value must be specified.
must be called prior to searchCitizenPrinter(). This
method doesn't work on the simulator.
After the specified time of searching process, it returns an array of printer information found, receives
a result code to the output parameter, result.
In case of CLS_PORT_WiFi, the CL-S400/521/531/621/631/700/703 series and the
CL-E720/730/300/303/321/331 series can be found. It may fail to find when the time out value is
less than 3 seconds depanding on the network environment.
In case of CLS_PORT_Bluetooth or CLS_PORT_Bluetooth_Insecure as ifType, it returns addresses
which are already paired when 0 is set to searchTime, it returns addresses which are available to
connect when 1 to 30 is set to searchTime. 10 or above are recommended. It may fail to find if it
is less than 10 depending on the Bluetooth condition.
Return value
Returns a list of printer information when successful, returns empty otherwise.
The information will be stored in the CitizenPrinterInfo class type. Available information inside of the
class is depanding on the connection type.
Connection Type
Property
Available information
CLS_PORT_WiFi
ipAddress
IP Address
macAddress
MAC Address
deviceName
(Empty character)
bdAddress
(Empty character)
CLS_PORT_Bluetooth
ipAddress
(Empty character)
macAddress
(Empty character)
deviceName
Bluetooth device name
