com.cloudpos.customerdisplay

Interface CustomerDisplayDevice

All Superinterfaces:

Device

public interface CustomerDisplayDevice
extends Device

The USBExtSwitchDevice interface provides control over the power state of USB host ports.

This interface allows applications to manage the power on/off state of USB hosts. The USBExtSwitchDevice object is obtained from the POSTerminal:

 CustomerDisplayDevice customerDisplayDevice =
         (CustomerDisplayDevice) POSTerminal.getInstance().getDevice(POSTerminal.DEVICE_NAME_CUSTOMER_DISPLAY);
 

The identifier CustomerDisplayDevice is used to specify the device, as defined by the implementation.

Applications require the following permission to access the device:

• <uses-permission android:name="android.permission.CLOUDPOS_CUSTOMER_DISPLAY"/>

Method Summary

Modifier and Type	Method and Description
boolean	displayImageOnCustomerScreen(android.graphics.Bitmap image) Displays a Bitmap image on the customer display device.
boolean	displayImageOnCustomerScreen(byte[] imageData) Displays a PNG image on the customer display device.
android.util.Size	getSize() Get the resolution of the customer display.
void	keepImageOnClose(boolean isKeep) The secondary screen remains on or off when the application exits.
void	keepImageOnSleep(boolean isKeep) The secondary screen remains on or off when the primary screen turns off.

Methods inherited from interface com.cloudpos.Device

cancelRequest, close, getFailCount, getUsageCount, open

Method Detail

displayImageOnCustomerScreen

boolean displayImageOnCustomerScreen(android.graphics.Bitmap image)
                              throws DeviceException

Displays a Bitmap image on the customer display device.

This method accepts a Bitmap image of any size and renders it on the customer-facing display starting from the top-left corner. No automatic scaling or cropping is applied. The image should be in PNG format.

Parameters:

image - A Bitmap object representing the image to display.

Returns:

true if the image was successfully written to the display, false otherwise.

Throws:

DeviceException

displayImageOnCustomerScreen

boolean displayImageOnCustomerScreen(byte[] imageData)
                              throws DeviceException

Displays a PNG image on the customer display device.

This method sends a PNG image to the customer-facing display. The image will be rendered starting from the top-left corner of the display, without scaling or cropping. The image should be in PNG format.

Parameters:

imageData - A byte array containing the PNG image data.

Returns:

true if the image was successfully written to the display, false otherwise.

Throws:

DeviceException

getSize

android.util.Size getSize()
                   throws DeviceException

Get the resolution of the customer display.

Returns:

Size, When the size cannot be obtained, it returns a width and height of 0.

Throws:

DeviceException - if the call fails.

keepImageOnClose

void keepImageOnClose(boolean isKeep)
               throws DeviceException

The secondary screen remains on or off when the application exits.

Parameters:

isKeep - true,Set the custom screen to stay on after the application exits.otherwise set to false.

If the setting fails, a DeviceException is thrown.

Throws:

DeviceException

keepImageOnSleep

void keepImageOnSleep(boolean isKeep)
               throws DeviceException

The secondary screen remains on or off when the primary screen turns off.

Parameters:

isKeep - true,Set the custom screen to stay on after sleep.otherwise set to false.

If the setting fails, a DeviceException is thrown.

Throws:

DeviceException