Plataformas Compatibles: Dispositivos Elo con Android 12 y Android 14, incluidos Backpack 4 (Standard/Value), I-Series 4 (Standard/Value), I-Series Standard, M50, Elo Pay M60, Elo Pay 7”, Elo Pay 22", M100, M100C.

Referencia Completa (Base de Conocimientos + Javadoc SDK)

Las API 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 vincule al servicio antes de llamar a cualquier API.
   No invoque métodos hasta que se reciba onServiceConnected().

2. Suponga que la política del dispositivo puede anular la configuración local.
   Esto es especialmente cierto para la hora, zona horaria, USB, modo quiosco e instalación de aplicaciones.

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

4. Entienda 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 a su estado original.

5. Registre el resultado de cada llamada API.
   Esto es crítico para la solución de problemas y escalamiento.

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 del reinicio, 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: Configuración segura del modo quiosco de una sola aplicación

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

Advertencia: Valide siempre un camino de escape administrativo antes de habilitar el modo quiosco en producción.

Plantilla de Vinculación del 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 deben invocarse solo después de que se llame a onServiceConnected().

Núcleo / APIs de Vinculación del Servicio

EloView

La clase EloView proporciona las siguientes operaciones:

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

bindService

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

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

Parámetros

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

try {
    // TODO: asegúrese de 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 el servicio de la aplicación al liberar recursos.

Parámetros

• context – Contexto

Ejemplo

try {
    // TODO: asegúrese de 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);
}