Plataformas soportadas: Dispositivos Elo con Android 12 y Android 14, incluyendo Backpack 4 (Estándar/Valor), I-Series 4 (Estándar/Valor), I-Series Estándar, M50, Elo Pay M60, Elo Pay 7”, Elo Pay 22", M100, M100C.

Referencia Completa (Base de Conocimientos + SDK Javadoc)

Las APIs están organizadas por clase funcional (Sistema, Red, Paquete, etc.) para simplificar el descubrimiento y acelerar la implementación.

---

Mejores Prácticas Globales (de KB)

1. Siempre enlazar al servicio antes de llamar a cualquier API.
   No invoque métodos hasta que se reciba onServiceConnected().

2. Suponer que la política del dispositivo puede anular configuraciones locales.
   Esto es especialmente cierto para el tiempo, la zona horaria, USB, el modo kiosco y la instalación de aplicaciones.

3. Usar NTP para la sincronización de tiempo en producción.
   Evite la configuración manual del tiempo excepto para pruebas.

4. Entender el comportamiento del reinicio.

   • Reinicio Empresarial borra la configuración de Elo y el estado de inscripción.

   • Reinicio de Fábrica borra todos los datos del usuario y devuelve el dispositivo al estado de caja.

5. Registrar el resultado de cada llamada a la API.
   Esto es crítico para la resolución de problemas y la escalación.

---

Escenarios Comunes del Mundo Real (de KB)

Escenario: Zona horaria incorrecta después de la inscripción del dispositivo

system.setNtpEnabled(true);
system.setNtpServer("time.aws.com");
system.setTimeZone("US/Central");
system.syncTimeNow();

// Verificar
String tz = system.getTimeZone();
Log.d(TAG, "Timezone=" + tz);

Consejo: Si la zona horaria vuelve a la configuración anterior después de reiniciar, verifique que la zona horaria automática de Android esté habilitada y que la política del dispositivo no esté reaplicando una región diferente.

Escenario: Configurar de manera segura el modo kiosco de una sola aplicación

pkg.setKioskApp("com.example.kiosk");
pkg.setKioskModeEnabled(true);
pkg.launchApp("com.example.kiosk");

Advertencia: Siempre valide un camino de escape administrativo antes de habilitar el modo kiosco en producción.

Plantilla de Enlace de Servicio (de KB)

eloView.bindService(context, callback, accessToken);
// Seguro llamar a APIs del SDK dentro de callback.onServiceConnected()
eloView.unbindService(context);

Nota importante: bindService() y unbindService() no regresan valores. Las APIs del SDK solo deben ser invocadas después de que se llame a onServiceConnected().

APIs Básicas / de Enlace de Servicio

EloView

La clase EloView proporciona las siguientes operaciones:

• Establecer el contenido que se reproducirá en el dispositivo en modo de Control de EloView cuando el dispositivo esté desconectado o no esté registrado a una cuenta usando setOfflinePlayContent().
• Recuperar el tipo de contenido (APK o WebView) y el nombre del contenido actualmente establecido en modo de Control de EloView usando getPlayContent().
• Obtener el estado actual de reproducción del contenido configurado en modo de Control de EloView usando getPlayContentStatus().
• Verificar si el dispositivo está actualmente conectado a EloView Cloud (en línea o fuera de línea) usando getDeviceCloudStatus().
• Alternar Wi-Fi en Configuraciones Rápidas de Elo y Modo Android Home usando toggleWifi().
• Alternar Bluetooth en Configuraciones Rápidas de Elo y Modo Android Home usando toggleBT().

bindService

public void bindService(android.content.Context context, ServiceConnectionCallback callback, java.lang.String accessToken)

Este método enlaza el servicio EloView a la aplicación. Debe llamar a esto antes de invocar cualquier API de EloView.

Parámetros

• context – Contexto en el cual se usan las APIs de EloView.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.bindService(context, callback, "accessToken");
    Log.d(TAG, "OK: bindService result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: bindService", e);
}

unbindService

public void unbindService(android.content.Context context)

Este método se usa para desvincular el servicio de la aplicación. Usa este método para desvincular el servicio de la aplicación al limpiar recursos.

Parámetros

• context – Contexto

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.unbindService(context);
    Log.d(TAG, "OK: unbindService result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: unbindService", e);
}

setOfflinePlayContent

public java.lang.String setOfflinePlayContent(java.lang.String packageName)

Este método se utiliza para establecer contenido en el dispositivo en modo Control de EloView cuando el dispositivo está desconectado o no está registrado a una cuenta. Si el dispositivo vuelve a línea y el contenido se establece a través de EloView, anulará el contenido establecido a través de esta API.

Parámetros

• packageName – Paquete que se establecerá como contenido predeterminado en el dispositivo.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.setOfflinePlayContent("packageName");
    Log.d(TAG, "OK: setOfflinePlayContent result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: setOfflinePlayContent", e);
}

getPlayContent

public java.lang.String getPlayContent()

Este método devuelve el tipo de contenido y el nombre del contenido establecido en el dispositivo. Este método funciona solamente en modo Control de EloView.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getPlayContent();
    Log.d(TAG, "OK: getPlayContent result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getPlayContent", e);
}

getPlayContentStatus

public java.lang.String getPlayContentStatus()

Este método devuelve el estado del contenido de reproducción en el dispositivo en modo Control. El estado puede ser una de las siguientes cadenas:

YET_TO_DOWNLOAD, DOWNLOADING, DOWNLOADED, INSTALLING, INSTALLED, DOWNLOAD_FAILED, INSTALL_FAILED, UNKNOWN_STATUS

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getPlayContentStatus();
    Log.d(TAG, "OK: getPlayContentStatus result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getPlayContentStatus", e);
}

getDeviceCloudStatus

public java.lang.String getDeviceCloudStatus()

Este método devuelve el estado en línea o fuera de línea del dispositivo. El estado puede ser una de las siguientes cadenas: "En línea", "Fuera de línea", "Conectando", "Reconectando", "En línea (No Provisionado)".

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getDeviceCloudStatus();
    Log.d(TAG, "OK: getDeviceCloudStatus result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getDeviceCloudStatus", e);
}

toggleWifi

void toggleWifi(boolean isEnableWifi)

Habilita o deshabilita Wi-Fi en el dispositivo. Esto se aplica tanto en modo EloView como en modo Android Home.

Parámetros

• isEnableWifi – Booleano para habilitar o deshabilitar WiFi en Configuraciones Rápidas.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.toggleWifi(true);
    Log.d(TAG, "OK: toggleWifi result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: toggleWifi", e);
}

switchToAndroidHomeMode

void switchToAndroidHomeMode() void switchToAndroidHomeMode(boolean isRebootNeeded, boolean isAndroidHomeMode)

Este método se utiliza para cambiar al modo Android Home desde el modo EloView. Esto es lo mismo que switchToAndroidHomeMode() excepto que acepta dos parámetros booleanos. No hay forma de volver a al modo EloView sin un reinicio de fábrica, así que úselo con precaución.

Parámetros

• Cambia el dispositivo de modo EloView a modo Android Home.
• Si isRebootNeeded se establece en verdadero, el dispositivo se reiniciará para aplicar el cambio de modo.
• Nota importante: Cambiar a modo Android Home puede deshabilitar las restricciones y políticas gestionadas por EloView.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.switchToAndroidHomeMode(true, true);
    Log.d(TAG, "OK: switchToAndroidHomeMode result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: switchToAndroidHomeMode", e);
}

toggleBT

public int toggleBT(boolean isEnableBT)

Este método se utiliza para alternar Bluetooth en Configuraciones Rápidas (modo EloView). También puede usarse para alternar Bluetooth en modo Android Home.

Parámetros

• isEnableBT – Booleano para habilitar o deshabilitar Bluetooth en Configuraciones Rápidas.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.toggleBT(true);
    Log.d(TAG, "OK: toggleBT result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: toggleBT", e);
}

APIs de Cuenta

AccountManager

La clase AccountManager proporciona las siguientes operaciones:

1. Proporcionar un token de autenticación de un EloServer basado en las credenciales proporcionadas por el usuario (emailId/contraseña o clientId/secretKey).

2. Verificar si un token de autenticación dado es válido o ha expirado. El token de autenticación puede ser el token obtenido del servidor EloView o puede ser un token JWT fuera de línea proporcionado por el equipo de Soporte Elo. (El token fuera de línea se genera utilizando el nombre de paquete de su aplicación y solo puede usarse con el paquete para el que se generó).

3. Todas las APIs requieren un token fuera de línea para funcionar y no funcionarán con un token en línea. La única excepción son las APIs OTA. Las APIs OTA requieren el token en línea al aplicar la OTA desde un servidor EloView. Para aplicar OTA a través de una URL de servidor personalizada o desde un archivo local en el dispositivo, puede usarse el token fuera de línea.

Por ejemplo, para obtener un token de autenticación:

1. Usando emailId y contraseña, llame a getEloAccessToken. 2. Usando clientId y secretKey, llame a getEloOAuthToken. Tras una autenticación exitosa, estos métodos devolverán un token. 3. Para el token JWT fuera de línea, contacte al equipo de Soporte Elo.

El token recuperado del servidor o del equipo de soporte se verifica usando el método verifyEloToken.

Desregistre los receptores de transmisión utilizados por estas APIs de AccountManager usando el método unregisterAccountManagerListener en los métodos onPause y onDestroy de las actividades en las que utilice estas APIs para evitar fugas.

getProperty

public static java.lang.String getProperty()

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getProperty();
    Log.d(TAG, "OK: getProperty result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getProperty", e);
}

setProperty

public void setProperty(java.lang.String property)

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.setProperty("property");
    Log.d(TAG, "OK: setProperty result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: setProperty", e);
}

getClientId

public static java.lang.String getClientId()

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getClientId();
    Log.d(TAG, "OK: getClientId result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getClientId", e);
}

getBaseUri

public static android.net.Uri getBaseUri()

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getBaseUri();
    Log.d(TAG, "OK: getBaseUri result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getBaseUri", e);
}

getEloAccessToken

public void getEloAccessToken(android.content.Context context, java.lang.String userEmail, java.lang.String password, android.os.Handler handler)

Este método se utiliza para obtener un token de acceso del servidor Elo.

Parámetros

• context – Un objeto Contexto de la clase que llama (Actividad o Servicio).

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getEloAccessToken(context, "userEmail", "password", handler);
    Log.d(TAG, "OK: getEloAccessToken result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getEloAccessToken", e);
}

configureOAuthHostedUI

public void configureOAuthHostedUI(android.app.Activity activity, android.os.Handler handler)

Este método se utiliza para inicializar la UI de OAuth hospedada.

Parámetros

• activity – Una instancia de Actividad de la clase que llama.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.configureOAuthHostedUI(activity, handler);
    Log.d(TAG, "OK: configureOAuthHostedUI result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: configureOAuthHostedUI", e);
}

stopOAuth

public void stopOAuth()

Llama a stopOAuth en el método override onStop() de la actividad.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.stopOAuth();
    Log.d(TAG, "OK: stopOAuth result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: stopOAuth", e);
}

destroyOAuth

public void destroyOAuth()

Llama a destroyOAuth en el método override onStop() de la actividad.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.destroyOAuth();
    Log.d(TAG, "OK: destroyOAuth result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: destroyOAuth", e);
}

logoutOAuth

public void logoutOAuth()

Llama a logoutOAuth para finalizar la sesión de inicio actual.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.logoutOAuth();
    Log.d(TAG, "OK: logoutOAuth result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: logoutOAuth", e);
}

verifyEloToken

public void verifyEloToken(android.content.Context context, java.lang.String accessToken, android.os.Handler handler)

Esta función solicita al servidor Elo que verifique el token dado. Tras una verificación exitosa, el controlador recibirá un mensaje de tipo TOKEN_VERIFY_SUCCESS. En caso de falla, se recibirá TOKEN_VERIFY_FAIL.

Parámetros

• context – Un objeto Contexto de la clase que llama (Actividad o Servicio).

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.verifyEloToken(context, "accessToken", handler);
    Log.d(TAG, "OK: verifyEloToken result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: verifyEloToken", e);
}

getEloOAuthToken

public void getEloOAuthToken(android.content.Context context, java.lang.String clientID, java.lang.String secret, android.os.Handler handler)

Este método se utiliza para solicitar al Portal EloView un nuevo token OAuth. Tras una autenticación exitosa, se enviará un token al dispositivo. Este token es válido para su uso durante 24 horas después de su emisión. Cuando el token expire, se recibirán el TOKEN_VERIFY_FAIL por más intentos de verificar el token y llamar a las APIs. Lo mismo se aplica si nunca se obtuvo o recibió un token.

Si es exitoso, el controlador recibirá un mensaje de tipo OAUTH_TOKEN_VALID con un token JWT como respuesta. A continuación, se muestra un ejemplo de una respuesta exitosa:

En caso de un fallo de autenticación debido a un mal clientID o secretID, el controlador recibirá un mensaje de tipo OAUTH_TOKEN_INVALID.

Parámetros

• context – Un objeto Contexto de la clase que llama (Actividad o Servicio).

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getEloOAuthToken(context, "clientID", "secret", handler);
    Log.d(TAG, "OK: getEloOAuthToken result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getEloOAuthToken", e);
}

unregisterAccountManagerListener

public void unregisterAccountManagerListener(android.content.Context context)

Este método se utiliza para anular el registro del receptor de difusión registrado mientras se utilizan cualquiera de las APIs de AccountManager. Asegúrese de llamar a esto en los métodos onPause y onDestroy de su actividad si utilizó cualquiera de las APIs de AccountManager. Esto garantiza que el receptor no se filtre.

Parámetros

• context – Contexto en el cual se utilizaron las APIs del sistema.
• context – Contexto de Android utilizado para cancelar el registro del listener del administrador de cuentas.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.unregisterAccountManagerListener(context);
    Log.d(TAG, "OK: unregisterAccountManagerListener result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: unregisterAccountManagerListener", e);
}

setDefaultEnvironment

public void setDefaultEnvironment(android.content.Context ctx)

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.setDefaultEnvironment(context);
    Log.d(TAG, "OK: setDefaultEnvironment result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: setDefaultEnvironment", e);
}

selectEnvironment

public void selectEnvironment(android.content.Context ctx, java.lang.String prop, boolean isSealed)

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.selectEnvironment(context, "prop", true);
    Log.d(TAG, "OK: selectEnvironment result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: selectEnvironment", e);
}

isPolarisLocked

public boolean isPolarisLocked(android.content.Context context)

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.isPolarisLocked(context);
    Log.d(TAG, "OK: isPolarisLocked result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: isPolarisLocked", e);
}

getEnvironment

public java.lang.String getEnvironment(android.content.Context ctx)

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getEnvironment(context);
    Log.d(TAG, "OK: getEnvironment result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getEnvironment", e);
}

getSecurityType

public java.lang.String getSecurityType(android.content.Context ctx)

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getSecurityType(context);
    Log.d(TAG, "OK: getSecurityType result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getSecurityType", e);
}

isPolaris

public boolean isPolaris(android.content.Context context)

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.isPolaris(context);
    Log.d(TAG, "OK: isPolaris result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: isPolaris", e);
}

TokenListener

TokenListener escucha eventos de verificación del AuthenticationToken y, sobre un token válido, proporciona la respuesta de éxito para llevar a cabo más operaciones.

No se documentan métodos para este tipo.

APIs del Sistema

ServiceConnectionCallback

onServiceConnected

void onServiceConnected()

Este método se llama cuando el servicio está conectado después de llamar a bindService.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.onServiceConnected();
    Log.d(TAG, "OK: onServiceConnected result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: onServiceConnected", e);
}

onServiceDisconnected

void onServiceDisconnected()

Este método se llama cuando el servicio se desconecta. Esto no se llamará si el servicio es desvinculado usando unbindService.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.onServiceDisconnected();
    Log.d(TAG, "OK: onServiceDisconnected result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: onServiceDisconnected", e);
}

Sistema

La clase Sistema proporciona las siguientes operaciones:

• Obtener un token de autenticación usando getEloAccessToken.
• Capturar la pantalla del dispositivo usando captureScreenShot.
• Establecer la orientación del dispositivo (vertical, paisaje, reversa-vertical, reversa-paisaje) usando setOrientation.
• Obtener la orientación del dispositivo usando getOrientation.
• Restablecer de fábrica el dispositivo usando factoryReset.
• Reiniciar silenciosamente el dispositivo usando silentReboot.
• Habilitar o deshabilitar la Barra de Navegación usando setNavigationBarEnabled.
• Habilitar o deshabilitar la Barra de Estado usando setStatusBarEnabled.
• Otorgar todos los permisos de tiempo de ejecución usando setGrantAllAppPermissionEnabled.
• Obtener el estado de la Barra de Navegación usando getNavigationBarEnabled.
• Obtener el estado de la Barra de Estado usando getStatusBarEnabled.
• Obtener el estado de Permiso de Concesión Total usando getGrantAllAppPermissionEnabled.
• Establecer y obtener el Tiempo de Espera del Retroiluminado usando setBacklightTimeOut y getBacklightTimeOut.
• Establecer y cambiar la contraseña de la pantalla de bloqueo usando setLockScreenPassword y changeLockScreenPassword.
• Permitir automáticamente permisos USB usando autoAllowUSBPermission.
• Bloquear o desbloquear el firmware del procesador seguro usando setFirmwareStatusLockEnabled.
• Establecer y cambiar el PIN del dispositivo usando setLockScreenPin y changeLockScreenPin.
• Habilitar o deshabilitar WiFi usando setWifiEnabled y obtener el estado usando getWifiEnabled.
• Limpiar caché y datos de la aplicación usando clearAllAppCacheUserData y clearAppCacheUserData.
• Habilitar ADB usando setAdbEnabled y configurar el puerto personalizado usando customPortAdb.
• Habilitar o deshabilitar el botón de Inicio usando setHomeButtonEnabled.
• Habilitar o deshabilitar el botón de Encendido usando setPowerButtonEnabled.
• Habilitar o deshabilitar el menú de asistencia del Editor de Texto usando setTextEditorAssistMenuEnabled.
• Habilitar o deshabilitar la opción "Mostrar más" en el panel de volumen usando setVolumePanelShowMoreEnabled.
• Habilitar o deshabilitar el escáner de código de barras Zebra usando setBarcodeReaderEnabled.
• Activar el escaneo de código de barras usando setScanBarcodeReaderEnabled.
• Habilitar o deshabilitar el registro Elo usando setEloLoggingEnabled.
• Habilitar o deshabilitar la dirección MAC WiFi aleatoria usando setRandomWifiMacAddressEnabled.
• Habilitar o deshabilitar el acceso a WebView de la impresora Star usando setStarPeripheralConnectEnabled.
• Comprobar el estado de auto-allow USB utilizando getAutoAllowUSBPermission.
• Establecer, eliminar y consultar el propietario del dispositivo utilizando setDeviceOwner, removeDeviceOwner y getDeviceOwnerStatus.
• Establecer y obtener la DPI de visualización usando setDpi y getDpi.
• Establecer y obtener el idioma usando setLanguage y getLanguage.
• Establecer y obtener el tipo de bloqueo usando setLockType y getLockType.
• Habilitar o deshabilitar IME Multi Cliente usando setMultiClientImeEnabled y getMultiClientImeEnabled.
• Establecer y obtener el servidor NTP usando setNtpServerUrl y getNtpServerUrl.
• Establecer y obtener el intervalo de encuestas NTP usando setNtpPollInterval y getNtpPollInterval.
• Controlar permisos de instalación usando setInstallPermissionToSpecificApp, setInstallAllAppPermissionEnabled y getInstallPermissionToSpecificApp.
• Establecer y obtener el tamaño de pantalla usando setScreenSize y getScreenSize.
• Establecer y obtener el ancho de píxel más pequeño usando setSmallestPixelWidth y getSmallestPixelWidth.
• Establecer y obtener la zona horaria usando setTimeZone y getTimeZone.
• Habilitar o deshabilitar servicios de accesibilidad usando setAccessibilityService.
• Habilitar o deshabilitar la fecha y la hora automática usando setAutoDateTimeEnabled.
• Habilitar o deshabilitar la confirmación de emparejamiento de dispositivos Bluetooth usando setBluetoothDevicePairingConfirmationEnabled.
• Establecer la fecha y la hora usando setDateTime.
• Establecer el tamaño de visualización usando setDisplaySize.
• Configurar WiFi utilizando CSV con setEloNetworkConf.
• Establecer el tamaño de fuente usando setFontSize.
• Habilitar o deshabilitar el Modo Inactivo usando setIdleModeEnabled.
• Habilitar o deshabilitar la ubicación usando setLocationEnabled.
• Silenciar o activar el micrófono usando setMicrophoneMuteEnabled.
• Habilitar o deshabilitar la visibilidad de la contraseña usando setPasswordEnabled.
• Habilitar o deshabilitar Play Protect usando setPlayProtect.
• Establecer y obtener espacio de registro reservado usando setReservedLogSpace y getReservedLogSpace.
• Establecer el formato de tiempo usando setTimeFormatEnabled.
• Habilitar o deshabilitar sonidos táctiles usando setTouchSoundEnabled.
• Establecer niveles de volumen usando setVolumeLevel.
• Habilitar o deshabilitar el menú de compartir selección de texto usando setShowTextEditorShareMenuEnabled.
• Apagar el dispositivo silenciosamente usando silentShutDown.
• Establecer el launcher predeterminado de forma silenciosa usando setSilentDefaultLauncher.
• Obtener el estado de bloqueo de firmware usando getFirmwareStatusLockEnabled.
• Actualizar el firmware del procesador seguro usando spFirmwareUpgrade.
• Iniciar actividad desde un servicio en primer plano usando startActivityFromForegroundService.
• Habilitar o deshabilitar el Modo Oscuro usando setDarkModeEnabled.
• Despertar la pantalla usando wakeupScreen.
• Habilitar o deshabilitar sonido y vibración de carga usando setChargingSoundAndVibrationEnabled.
• Habilitar o deshabilitar sonido de bloqueo de pantalla usando setScreenLockSoundEnabled.
• Habilitar o deshabilitar el mosaico de Modo Inactivo usando setIdleModeTileEnabled.
• Obtener y establecer el nombre del host usando getHostName y setHostName.
• Habilitar o deshabilitar la accesibilidad de hotspot usando setHotspotAccessibilityEnabled y getHotspotAccessibilityEnabled.
• Obtener checksum MD5 usando getMD5Checksum.
• Vincular y desvincular el servicio del Sistema usando bindService y unbindService.

isM60Device

public static boolean isM60Device()

Este método se utiliza para obtener la orientación del dispositivo.

Retorna

Orientación del dispositivo, por ejemplo, vertical o apaisada.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.isM60Device();
    Log.d(TAG, "OK: isM60Device result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: isM60Device", e);
}

isM50Device

public static boolean isM50Device()

Este método se utiliza para obtener la orientación del dispositivo.

Retorna

Orientación del dispositivo, por ejemplo, vertical o apaisada.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.isM50Device();
    Log.d(TAG, "OK: isM50Device result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: isM50Device", e);
}

isM100Device

public static boolean isM100Device()

Este método se utiliza para obtener la orientación del dispositivo.

Retorna

Orientación del dispositivo, por ejemplo, vertical o apaisada.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.isM100Device();
    Log.d(TAG, "OK: isM100Device result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: isM100Device", e);
}

is7PayDevice

public static boolean is7PayDevice()

Este método se utiliza para obtener la orientación del dispositivo.

Retorna

Orientación del dispositivo, por ejemplo, vertical o apaisada.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.is7PayDevice();
    Log.d(TAG, "OK: is7PayDevice result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: is7PayDevice", e);
}

isM51Device

public boolean isM51Device()

Este método se utiliza para obtener la orientación del dispositivo.

Retorna

Orientación del dispositivo, por ejemplo, vertical o apaisada.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.isM51Device();
    Log.d(TAG, "OK: isM51Device result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: isM51Device", e);
}

bindService

public void bindService(android.content.Context context, ServiceConnectionCallback callback, java.lang.String accessToken)

Este método se utiliza para enlazar el servicio para acceder a las APIs del Sistema. Use este método para enlazarse al servicio antes de usar las APIs del Sistema.

Parámetros

• context – Contexto de la aplicación

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.bindService(context, callback, "accessToken");
    Log.d(TAG, "OK: bindService result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: bindService", e);
}

unbindService

public void unbindService(android.content.Context context)

Este método se utiliza para desvincular el servicio de la aplicación. Use este método para desvincularse del servicio al limpiar recursos.

Parámetros

• context – Contexto de la aplicación

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.unbindService(context);
    Log.d(TAG, "OK: unbindService result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: unbindService", e);
}

captureScreenShot

public boolean captureScreenShot(java.lang.String fileName)

Este método se utiliza para capturar una captura de pantalla. La captura de pantalla será almacenada en la ubicación "/sdcard/elo/screenshot", y el mensaje de retorno también contiene la ruta de la captura de pantalla.

Parámetros

• fileName – Un nombre de archivo en formato PNG, por ejemplo "screenshot.png".

Retorna

true si la captura de pantalla se capturó con éxito, false en caso contrario.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.captureScreenShot("fileName");
    Log.d(TAG, "OK: captureScreenShot result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: captureScreenShot", e);
}

setAccessibilityService

public void setAccessibilityService(java.lang.String packageName, boolean enableAccessibilityService)

Este método se utiliza para habilitar o deshabilitar servicios de accesibilidad.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.setAccessibilityService("packageName", true);
    Log.d(TAG, "OK: setAccessibilityService result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: setAccessibilityService", e);
}

setMultiClientImeEnabled

public boolean setMultiClientImeEnabled(boolean enable, boolean reboot)

Este método se utiliza para habilitar o deshabilitar el IME Multi-Cliente. Después de aplicar, el dispositivo se reiniciará para reflejar los cambios.

Parámetros

• enable – Si debe habilitarse o deshabilitarse la función.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.setMultiClientImeEnabled(true, true);
    Log.d(TAG, "OK: setMultiClientImeEnabled result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: setMultiClientImeEnabled", e);
}

setWifiScanning

public void setWifiScanning(boolean enable)

Este método se utiliza para habilitar o deshabilitar el escaneo de WiFi.

Parámetros

• enable – Si se debe habilitar o deshabilitar el escaneo de WiFi.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.setWifiScanning(true);
    Log.d(TAG, "OK: setWifiScanning result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: setWifiScanning", e);
}

setBluetoothScanning

public void setBluetoothScanning(boolean enable)

Este método se utiliza para habilitar o deshabilitar el escaneo de Bluetooth.

Parámetros

• enable – Si se debe habilitar o deshabilitar el escaneo de Bluetooth.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.setBluetoothScanning(true);
    Log.d(TAG, "OK: setBluetoothScanning result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: setBluetoothScanning", e);
}

setKeyListener

public boolean setKeyListener(java.lang.String packageName, java.lang.String receiverName, java.util.ArrayList<java.lang.Integer> keys, java.util.ArrayList<java.lang.Boolean> intercept)

Este método se utiliza para registrar un oyente de eventos de teclas que puede ejecutarse en un hilo en segundo plano.

Parámetros

• packageName – Nombre del paquete al que pertenece el componente del oyente de teclas.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.setKeyListener("packageName", "receiverName", 0, 0);
    Log.d(TAG, "OK: setKeyListener result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: setKeyListener", e);
}

getMultiClientImeEnabled

public boolean getMultiClientImeEnabled()

Este método se utiliza para obtener el estado habilitado del IME Multi-Cliente.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getMultiClientImeEnabled();
    Log.d(TAG, "OK: getMultiClientImeEnabled result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getMultiClientImeEnabled", e);
}

setDpi

public boolean setDpi(int DPI)

Este método se utiliza para establecer la DPI de visualización. Se requiere un reinicio para que los cambios tengan efecto.

Parámetros

• DPI – Valor entero para la densidad de pantalla (160, 240, 320, 480 o 640).

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.setDpi(0);
    Log.d(TAG, "OK: setDpi result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: setDpi", e);
}

getDpi

public int getDpi()

Este método se utiliza para obtener la DPI de visualización.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getDpi();
    Log.d(TAG, "OK: getDpi result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getDpi", e);
}

getEnvironmental

public java.lang.String getEnvironmental()

Este método se utiliza para obtener detallitos ambientales.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getEnvironmental();
    Log.d(TAG, "OK: getEnvironmental result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getEnvironmental", e);
}

getRAMFree

public long getRAMFree()

Este método se utiliza para obtener la RAM libre actual.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getRAMFree();
    Log.d(TAG, "OK: getRAMFree result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getRAMFree", e);
}

Personality APIs

Personalidad

La clase Personality proporciona información sobre la personalidad.

Puede interactuar y personalizar comportamientos entre las APIs del Sistema y del Dispositivo.

---

getPersonality

public java.lang.String getPersonality()

Este método se utiliza para obtener la personalidad actual del dispositivo.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.getPersonality();
    Log.d(TAG, "OK: getPersonality result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: getPersonality", e);
}

setPersonality

public void setPersonality(java.lang.String personality)

Este método se utiliza para establecer una personalidad para el dispositivo.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.setPersonality("personality");
    Log.d(TAG, "OK: setPersonality result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: setPersonality", e);
}

isIPPersonality

public boolean isIPPersonality()

Este método se utiliza para verificar si la personalidad actual es IP.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.isIPPersonality();
    Log.d(TAG, "OK: isIPPersonality result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: isIPPersonality", e);
}

setPersonalidad

public void setPersonalidad(java.lang.String personalidad)

Este método se utiliza para establecer una personalización.

Ejemplo

try {
    // TODO: asegurar que el servicio esté enlazado antes de llamar a las APIs del SDK
    Object result = sdk.setPersonalidad("personalidad");
    Log.d(TAG, "OK: setPersonalidad result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: setPersonalidad", e);
}