EloView Home SDK 6.23.14

Plataformas soportadas: Dispositivos Android 12 y Android 14 Elo incluyendo Backpack 4 (Standard/Value), I-Series 4 (Standard/Value), I-Series Standard, M50, M60 Pay, M100 y 7-Inch Pay.

Referencia completa (Base de Conocimientos + Javadoc del SDK)

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

---

Mejores prácticas generales (de KB)

1. Siempre vincule al servicio antes de llamar a cualquier API.
   No invocar métodos hasta que onServiceConnected() sea recibido.

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

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

4. Comprenda el comportamiento de restablecimiento.

   • Restablecimiento empresarial borra la configuración de Elo y el estado de inscripción.

   • Restablecimiento de fábrica borra todos los datos del usuario y devuelve el dispositivo a su estado original.

5. Registre el resultado de cada llamada a la API.
   Esto es crítico para la solució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();

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

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

Escenario: Configurar de manera segura el modo quiosco 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 quiosco en producción.

Plantilla de vinculación 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 devuelven valores. Las APIs del SDK solo deben invocarse después de que se llame a onServiceConnected().

APIs de núcleo / vinculación de servicio

EloView

La clase EloView proporciona las siguientes operaciones:

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

bindService

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

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

Parámetros

• context – Contexto en el que se utilizan las APIs de EloView.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 liberar recursos.

Parámetros

• context – Contexto

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 de control EloView cuando el dispositivo está fuera de línea o no registrado en una cuenta. Si el dispositivo vuelve a estar en línea y el contenido se establece a través de EloView, sobrescribirá 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é vinculado 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 solo funciona en modo de control EloView.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 de 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é vinculado 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 aprovisionado)".

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 QuickSettings.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 modo EloView sin un restablecimiento 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 desactivar las restricciones y políticas gestionadas por EloView.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 QuickSettings (modo EloView). También se puede utilizar para alternar Bluetooth en modo Android Home.

Parámetros

• isEnableBT – Booleano para habilitar o deshabilitar Bluetooth en QuickSettings.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 (correo electrónico/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 del paquete de su aplicación y solo se puede utilizar con el paquete para el cual fue generado).

3. Todas las API 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, se puede utilizar el token fuera de línea.

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

1. Usando el correo electrónico y la contraseña, llamar a getEloAccessToken. 2. Usando clientId y secretKey, llamar a getEloOAuthToken. Tras una autenticación exitosa, estos métodos devolverán un token. 3. Para el token JWT fuera de línea, contactar con el equipo de Soporte Elo.

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

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

getProperty

public static java.lang.String getProperty()

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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é vinculado 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é vinculado 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é vinculado 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 Context del tipo de clase que llama (Actividad o Servicio).

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 interfaz de usuario alojada de OAuth.

Parámetros

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

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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()

Llame a stopOAuth en el método onStop() anulado de la actividad.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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()

Llame a destroyOAuth en el método onStop() anulado de la actividad.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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()

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

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 manejador recibirá un mensaje de tipo TOKEN_VERIFY_SUCCESS. En caso de fallo, TOKEN_VERIFY_FAIL será recibido.

Parámetros

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

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 pedir al Portal EloView un nuevo token OAuth. Tras una autenticación exitosa, un token será enviado al dispositivo. Este token es válido para su uso durante 24 horas después de ser emitido. Cuando el token expira, nuevos intentos de verificar el token y llamar a las APIs recibirán la respuesta TOKEN_VERIFY_FAIL. Lo mismo es cierto si nunca se obtuvo o recibió un token.

Si tiene éxito, el manejador 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 manejador recibirá un mensaje de tipo OAUTH_TOKEN_INVALID.

Parámetros

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

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 cancelar el registro del receptor de transmisión registrado mientras se utiliza 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 asegura que el receptor no se filtrará.

Parámetros

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

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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é vinculado 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é vinculado 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é vinculado 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é vinculado 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);
}

isPolaris

public boolean isPolaris(android.content.Context context)

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 de AuthenticationToken y, en un token válido, proporciona la respuesta de éxito para realizar operaciones adicionales.

No se documentan métodos para este tipo.

APIs del sistema

ServiceConnectionCallback

onServiceConnected

void onServiceConnected()

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

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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. No se llamará si el servicio es desvinculado utilizando unbindService.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 utilizando getEloAccessToken.
• Capturar la captura de pantalla del dispositivo utilizando captureScreenShot.
• Establecer la orientación del dispositivo (vertical, horizontal, vertical invertido, horizontal invertido) utilizando setOrientation.
• Obtener la orientación del dispositivo utilizando getOrientation.
• Restablecer de fábrica el dispositivo utilizando factoryReset.
• Reiniciar el dispositivo en silencio utilizando silentReboot.
• Habilitar o deshabilitar la Barra de Navegación utilizando setNavigationBarEnabled.
• Habilitar o deshabilitar la Barra de Estado utilizando setStatusBarEnabled.
• Conceder todos los permisos en tiempo de ejecución utilizando setGrantAllAppPermissionEnabled.
• Obtener el estado de la Barra de Navegación utilizando getNavigationBarEnabled.
• Obtener el estado de la Barra de Estado utilizando getStatusBarEnabled.
• Obtener el estado de la propiedad Conceder Todos los Permisos de la aplicación utilizando getGrantAllAppPermissionEnabled.
• Establecer y obtener el Tiempo de Espera de Retroiluminación utilizando setBacklightTimeOut y getBacklightTimeOut.
• Establecer y cambiar la contraseña de la pantalla de bloqueo utilizando setLockScreenPassword y changeLockScreenPassword.
• Permitir automáticamente permisos USB utilizando autoAllowUSBPermission.
• Bloquear o desbloquear el firmware del procesador seguro utilizando setFirmwareStatusLockEnabled.
• Establecer y cambiar el PIN del dispositivo utilizando setLockScreenPin y changeLockScreenPin.
• Habilitar o deshabilitar WiFi utilizando setWifiEnabled y obtener el estado utilizando getWifiEnabled.
• Borrar el caché y los datos de la aplicación utilizando clearAllAppCacheUserData y clearAppCacheUserData.
• Habilitar ADB utilizando setAdbEnabled y configurar el puerto personalizado utilizando customPortAdb.
• Habilitar o deshabilitar el botón de Inicio utilizando setHomeButtonEnabled.
• Habilitar o deshabilitar el botón de Encendido utilizando setPowerButtonEnabled.
• Habilitar o deshabilitar el menú de asistencia del editor de texto utilizando setTextEditorAssistMenuEnabled.
• Habilitar o deshabilitar el panel de volumen "Mostrar más" utilizando setVolumePanelShowMoreEnabled.
• Habilitar o deshabilitar el escáner de código de barras Zebra utilizando setBarcodeReaderEnabled.
• Activar el escaneo de código de barras utilizando setScanBarcodeReaderEnabled.
• Habilitar o deshabilitar el registro Elo utilizando setEloLoggingEnabled.
• Habilitar o deshabilitar el MAC aleatorio de WiFi utilizando setRandomWifiMacAddressEnabled.
• Habilitar o deshabilitar el acceso a WebView de la impresora Star utilizando setStarPeripheralConnectEnabled.
• Comprobar el estado de auto-permitir USB utilizando getAutoAllowUSBPermission.
• Establecer, eliminar y consultar al propietario del dispositivo utilizando setDeviceOwner, removeDeviceOwner y getDeviceOwnerStatus.
• Establecer y obtener DPI de pantalla utilizando setDpi y getDpi.
• Establecer y obtener el idioma utilizando setLanguage y getLanguage.
• Establecer y obtener el tipo de bloqueo utilizando setLockType y getLockType.
• Habilitar o deshabilitar IME de Multi Cliente utilizando setMultiClientImeEnabled y getMultiClientImeEnabled.
• Establecer y obtener el servidor NTP utilizando setNtpServerUrl y getNtpServerUrl.
• Establecer y obtener el intervalo de sondeo NTP utilizando setNtpPollInterval y getNtpPollInterval.
• Controlar permisos de instalación utilizando setInstallPermissionToSpecificApp, setInstallAllAppPermissionEnabled y getInstallPermissionToSpecificApp.
• Establecer y obtener el tamaño de pantalla utilizando setScreenSize y getScreenSize.
• Establecer y obtener el ancho de píxel más pequeño utilizando setSmallestPixelWidth y getSmallestPixelWidth.
• Establecer y obtener la zona horaria utilizando setTimeZone y getTimeZone.
• Habilitar o deshabilitar servicios de accesibilidad utilizando setAccessibilityService.
• Habilitar o deshabilitar la fecha y hora automáticas utilizando setAutoDateTimeEnabled.
• Habilitar o deshabilitar la confirmación de emparejamiento Bluetooth utilizando setBluetoothDevicePairingConfirmationEnabled.
• Establecer la fecha y la hora utilizando setDateTime.
• Establecer el tamaño de pantalla utilizando setDisplaySize.
• Configurar WiFi utilizando CSV con setEloNetworkConf.
• Establecer el tamaño de fuente utilizando setFontSize.
• Habilitar o deshabilitar el Modo Inactivo utilizando setIdleModeEnabled.
• Habilitar o deshabilitar la ubicación utilizando setLocationEnabled.
• Silenciar o activar el micrófono utilizando setMicrophoneMuteEnabled.
• Habilitar o deshabilitar la visibilidad de la contraseña utilizando setPasswordEnabled.
• Habilitar o deshabilitar Play Protect utilizando setPlayProtect.
• Establecer y obtener espacio de registro reservado utilizando setReservedLogSpace y getReservedLogSpace.
• Establecer un formato de hora utilizando setTimeFormatEnabled.
• Habilitar o deshabilitar sonidos táctiles utilizando setTouchSoundEnabled.
• Establecer niveles de volumen utilizando setVolumeLevel.
• Habilitar o deshabilitar el menú de compartir en la selección de texto utilizando setShowTextEditorShareMenuEnabled.
• Apagar el dispositivo en silencio utilizando silentShutDown.
• Establecer el lanzador predeterminado utilizando setSilentDefaultLauncher.
• Obtener el estado de bloqueo de firmware utilizando getFirmwareStatusLockEnabled.
• Actualizar el firmware del procesador seguro utilizando spFirmwareUpgrade.
• Iniciar actividad desde un servicio en primer plano utilizando startActivityFromForegroundService.
• Habilitar o deshabilitar el Modo Oscuro utilizando setDarkModeEnabled.
• Despertar la pantalla utilizando wakeupScreen.
• Habilitar o deshabilitar el sonido y la vibración de carga utilizando setChargingSoundAndVibrationEnabled.
• Habilitar o deshabilitar el sonido de bloqueo de pantalla utilizando setScreenLockSoundEnabled.
• Habilitar o deshabilitar la baldosas del Modo Inactivo utilizando setIdleModeTileEnabled.
• Obtener y establecer el nombre del host utilizando getHostName y setHostName.
• Habilitar o deshabilitar la accesibilidad de punto de acceso utilizando setHotspotAccessibilityEnabled y getHotspotAccessibilityEnabled.
• Obtener la suma de comprobación MD5 utilizando getMD5Checksum.
• Vincular y desvincular el servicio del sistema utilizando bindService y unbindService.

isM60Device

public static boolean isM60Device()

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

Devuelve

Orientación del dispositivo, por ejemplo, vertical u horizontal.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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.

Devuelve

Orientación del dispositivo, por ejemplo, vertical u horizontal.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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.

Devuelve

Orientación del dispositivo, por ejemplo, vertical u horizontal.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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.

Devuelve

Orientación del dispositivo, por ejemplo, vertical u horizontal.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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.

Devuelve

Orientación del dispositivo, por ejemplo, vertical u horizontal.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 vincular el servicio para acceder a las APIs del sistema. Use este método para vincular el servicio antes de usar las APIs del sistema.

Parámetros

• context – Contexto de la aplicación

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 desvincular del servicio al limpiar recursos.

Parámetros

• context – Contexto de la aplicación

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 se almacenará 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".

Devuelve

verdadero si la captura de pantalla se captura con éxito, falso de otro modo.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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é vinculado 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 IME de Multi Cliente. Después de aplicarlo, el dispositivo se reiniciará para reflejar los cambios.

Parámetros

• enable – Si habilitar o deshabilitar la función.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 habilitar o deshabilitar el escaneo de WiFi.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 habilitar o deshabilitar el escaneo de Bluetooth.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 tecla 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é vinculado 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 de Multi-Cliente IME.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado 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 el DPI de visualización. Se requiere reiniciar para que el cambio entre en 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é vinculado 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);
}

setCFDDpi

public boolean setCFDDpi(int DPI)

Este método se utiliza para establecer el DPI de la pantalla externa.

Parámetros

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

Ejemplo

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

setScreenSize

public boolean setScreenSize(int width, int height)

Este método se utiliza para establecer la resolución de la pantalla.

Parámetros

• width – Ancho de la pantalla en píxeles.
• height – Altura de la pantalla en píxeles.

Ejemplo

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

setDisplaySize

public boolean setDisplaySize(java.lang.String size)

Este método se utiliza para establecer el tamaño de la pantalla.

Parámetros

• size – Valor de cadena que representa el tamaño de la pantalla.

Ejemplo

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

setFontSize

public boolean setFontSize(java.lang.String size)

Este método se utiliza para establecer el tamaño de la fuente.

Parámetros

• size – Valor de cadena que representa el tamaño de la fuente.

Ejemplo

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

setSmallestPixelWidth

public boolean setSmallestPixelWidth(int smallestWidth)

Este método se utiliza para establecer el ancho de píxel más pequeño que se muestra en Opciones de desarrollador.

Parámetros

• smallestWidth – Valor entero para el ancho más pequeño en píxeles.

Ejemplo

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

getSmallestPixelWidth

public int getSmallestPixelWidth()

Este método se utiliza para obtener el ancho de píxel más pequeño mostrado en Opciones de desarrollador.

Ejemplo

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

setSilentDefaultLauncher

public boolean setSilentDefaultLauncher(java.lang.String packageName)

Este método se utiliza para establecer silenciosamente la aplicación de lanzador predeterminada.

Parámetros

• packageName – Nombre del paquete de la aplicación de lanzador.

Devuelve

verdadero si el lanzador predeterminado se establece con éxito, falso de lo contrario.

Ejemplo

try {
    // TODO: asegurar que el servicio esté vinculado antes