CITIZEN Android Label Print SDK
—
Programming Manual
28
2.2.11 searchLabelPrinter method
Syntax
String[] searchLabelPrinter (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 addresses. The connection type and
time out value must be specified.
must be called prior to searchLabelPrinter(). This
method doesn't work on the simulator.
After the specified time of searching process, it returns an array of printer addresses 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 addresses when successful, returns empty otherwise.
Example
int[] errCode = new int[1];
String[] list = printer.searchLabelPrinter(
LabelConst.CLS_PORT_WiFi, 3, errCode);
