EloView Home SDK 6.23.14

Piattaforme supportate: Android 12 e dispositivi Elo 14 inclusi Backpack 4 (Standard/Value), I-Series 4 (Standard/Value), I-Series Standard, M50, M60 Pay, M100, e 7-Inch Pay.

Riferimento completo (Knowledge Base + SDK Javadoc)

Le API sono organizzate per classe funzionale (Sistema, Rete, Pacchetto, ecc.) per semplificare la scoperta e accelerare l'implementazione.

---

Best Practices Globali (da KB)

1. Collegati sempre al servizio prima di chiamare qualsiasi API.
   Non invocare metodi fino a quando onServiceConnected() viene ricevuto.

2. Presumi che la politica del dispositivo possa sovrascrivere le impostazioni locali.
   Questo è particolarmente vero per l'ora, il fuso orario, USB, la modalità chiosco e l'installazione delle applicazioni.

3. Utilizza NTP per la sincronizzazione dell'orario in produzione.
   Evita la configurazione manuale dell'ora, eccetto per il testing.

4. Comprendi il comportamento di reset.

   • Reset Aziendale cancella la configurazione Elo e lo stato di registrazione.

   • Reset di Fabbrica cancella tutti i dati utente e restituisce il dispositivo allo stato originale.

5. Registra il risultato di ogni chiamata API.
   Questo è fondamentale per la risoluzione dei problemi e l'escalation.

---

Scenari comuni del mondo reale (da KB)

Scenario: Fuso orario non corretto dopo la registrazione del dispositivo

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

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

Suggerimento: Se il fuso orario torna indietro dopo il riavvio, verifica che la configurazione automatica del fuso orario di Android sia attivata e che la politica del dispositivo non stia riapplicando una regione diversa.

Scenario: Configurare in modo sicuro la modalità chiosco a singola app

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

Avviso: Valida sempre un percorso di fuga amministrativo prima di abilitare la modalità chiosco in produzione.

Modello di Collegamento al Servizio (da KB)

eloView.bindService(context, callback, accessToken);
// Sicuro chiamare le API SDK dentro callback.onServiceConnected()
eloView.unbindService(context);

Nota importante: bindService() e unbindService() non restituiscono valori. Le API SDK devono essere chiamate solo dopo che onServiceConnected() è stata chiamata.

API di Collegamento / Servizio fondamentali

EloView

La classe EloView fornisce le seguenti operazioni:

• Imposta il contenuto da riprodurre sul dispositivo in modalità EloView Control quando il dispositivo è offline o non registrato a un account utilizzando setOfflinePlayContent().
• Recupera il tipo di contenuto (APK o WebView) e il nome del contenuto attualmente impostato in modalità EloView Control utilizzando getPlayContent().
• Ottieni lo stato di riproduzione corrente del contenuto configurato in EloView Control utilizzando getPlayContentStatus().
• Verifica se il dispositivo è attualmente connesso a EloView Cloud (online o offline) utilizzando getDeviceCloudStatus().
• Attiva o disattiva il Wi-Fi nelle Impostazioni rapide Elo e in modalità Android Home utilizzando toggleWifi().
• Attiva o disattiva il Bluetooth nelle Impostazioni rapide Elo e in modalità Android Home utilizzando toggleBT().

bindService

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

Questo metodo collega il servizio EloView all'applicazione. Devi chiamare questo prima di invocare qualsiasi API EloView.

Parametri

• context – Contesto in cui vengono utilizzate le API EloView.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per scollegare il servizio dall'applicazione. Usa questo metodo per scollegare il servizio dall' applicazione quando si liberano risorse.

Parametri

• context – Contesto

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per impostare il contenuto sul dispositivo in modalità EloView Control quando il dispositivo è offline o non registrato a un account. Se il dispositivo torna online e il contenuto viene impostato tramite EloView, sovrascriverà il contenuto impostato tramite questa API.

Parametri

• packageName – Pacchetto da impostare come contenuto predefinito sul dispositivo.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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()

Questo metodo restituisce il tipo di contenuto e il nome del contenuto impostato sul dispositivo. Questo metodo funziona solo in modalità EloView Control.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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()

Questo metodo restituisce lo stato del contenuto riprodotto sul dispositivo in modalità Control. Lo stato può essere una delle seguenti stringhe:

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

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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()

Questo metodo restituisce lo stato online o offline del dispositivo. Lo stato può essere una delle seguenti stringhe: "Online", "Offline", "Connecting", "Reconnecting", "Online (Not Provisioned)".

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Abilita o disabilita il Wi-Fi sul dispositivo. Questo si applica sia in modalità EloView che in modalità Android Home.

Parametri

• isEnableWifi – Booleano per abilitare o disabilitare il Wi-Fi nelle Impostazioni rapide.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per passare dalla modalità EloView alla modalità Android Home. Questa è la stessa cosa di switchToAndroidHomeMode() eccetto che accetta due parametri booleani. Non c'è modo di tornare in modalità EloView senza un ripristino di fabbrica, quindi usalo con cautela.

Parametri

• Passa il dispositivo dalla modalità EloView alla modalità Android Home.
• Se isRebootNeeded è impostato su true, il dispositivo verrà riavviato per applicare la modifica della modalità.
• Nota importante: Passare alla modalità Android Home può disabilitare le restrizioni e le politiche gestite da EloView.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per attivare o disattivare il Bluetooth nel Menu delle Impostazioni rapide (modalità EloView). Può anche essere utilizzato per attivare il Bluetooth in modalità Android Home.

Parametri

• isEnableBT – Booleano per abilitare o disabilitare il Bluetooth nel Menu delle Impostazioni rapide.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API SDK
    Object result = sdk.toggleBT(true);
    Log.d(TAG, "OK: toggleBT result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: toggleBT", e);
}

API Account

AccountManager

La classe AccountManager fornisce le seguenti operazioni:

1. Fornire un token di autenticazione da un EloServer in base alle credenziali fornite dall'utente (emailId/password o clientId/secretKey).

2. Verifica se un dato token di autenticazione è valido o è scaduto. Il token di autenticazione può essere il token ottenuto dal server EloView oppure può essere un token JWT offline fornito dal team di supporto Elo. (Il token offline è generato utilizzando il nome del pacchetto della tua applicazione e può essere utilizzato solo con il pacchetto per cui è stato generato.)

3. Tutte le API richiedono un token offline per funzionare e non funzioneranno con un token online. L'unica eccezione è le API OTA. Le API OTA richiedono il token online quando si applica l'OTA da un server EloView. Per applicare l'OTA tramite un URL di server personalizzato o da un file locale sul dispositivo, il token offline può essere utilizzato.

Ad esempio, per ottenere un token di autenticazione:

1. Utilizzando emailId e password, chiama getEloAccessToken. 2. Utilizzando clientId e secretKey, chiama getEloOAuthToken. Una volta autenticato con successo, questi metodi restituiranno un token. 3. Per il token JWT offline, contatta il team di supporto Elo.

Il token recuperato dal server o dal team di supporto viene verificato utilizzando il metodo verifyEloToken.

Annulla la registrazione dei receiver di broadcast utilizzati da queste API AccountManager utilizzando il metodo unregisterAccountManagerListener nei metodi onPause e onDestroy delle attività in cui utilizzi queste API per evitare perdite.

getProperty

public static java.lang.String getProperty()

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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()

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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()

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per ottenere un token di accesso dal server Elo.

Parametri

• context – Un oggetto Context della classe chiamante (Attività o Servizio).

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per inizializzare l'OAuth Hosted UI.

Parametri

• activity – Un'istanza Activity della classe chiamante.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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()

Chiama stopOAuth nel metodo di override onStop() dell'attività.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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()

Chiama destroyOAuth nel metodo di override onStop() dell'attività.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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()

Chiama logoutOAuth per terminare l'attuale sessione di accesso.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questa funzione chiede al server Elo di verificare il token fornito. Una volta verificato con successo, il gestore riceverà un messaggio di tipo TOKEN_VERIFY_SUCCESS. In caso di errore, TOKEN_VERIFY_FAIL verrà ricevuto.

Parametri

• context – Un oggetto Context della classe chiamante (Attività o Servizio).

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per chiedere al Portale EloView un nuovo token OAuth. Una volta autenticato con successo, un token verrà inviato al dispositivo. Questo token è valido per l'uso per 24 ore dopo la sua emissione. Quando il token scade, ulteriori tentativi di verificare il token e chiamare le API riceveranno la risposta TOKEN_VERIFY_FAIL. Lo stesso vale se un token non è mai stato ottenuto o ricevuto.

Se ha avuto successo, il gestore riceverà un messaggio di tipo OAUTH_TOKEN_VALID con un token JWT come risposta. Di seguito è riportato un esempio di una risposta di successo:

In caso di errore di autenticazione a causa di un bad clientID o secretID, il gestore riceverà un messaggio di tipo OAUTH_TOKEN_INVALID.

Parametri

• context – Un oggetto Context della classe chiamante (Attività o Servizio).

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per annullare la registrazione dei receiver di broadcast registrati mentre si utilizza qualsiasi delle API AccountManager. Assicurati di chiamare questo nei metodi onPause e onDestroy della tua attività ciclo di vita se hai fatto uso di qualsiasi delle API AccountManager. Questo garantisce che il receiver non venga perduto.

Parametri

• context – Contesto in cui sono state utilizzate le API di sistema.
• context – Contesto Android utilizzato per annullare la registrazione del listener del gestore account.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API SDK
    Object result = sdk.isPolaris(context);
    Log.d(TAG, "OK: isPolaris result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: isPolaris", e);
}

TokenListener

TokenListener ascolta eventi di verifica del token AuthenticationToken e, su un token valido, fornisce la risposta di successo per eseguire ulteriori operazioni.

Nessun metodo è documentato per questo tipo.

API di Sistema

ServiceConnectionCallback

onServiceConnected

void onServiceConnected()

Questo metodo viene chiamato quando il servizio è connesso dopo aver chiamato bindService.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API SDK
    Object result = sdk.onServiceConnected();
    Log.d(TAG, "OK: onServiceConnected result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: onServiceConnected", e);
}

onServiceDisconnected

void onServiceDisconnected()

Questo metodo viene chiamato quando il servizio è disconnesso. Questo non verrà chiamato se il servizio è scollegato utilizzando unbindService.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API SDK
    Object result = sdk.onServiceDisconnected();
    Log.d(TAG, "OK: onServiceDisconnected result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: onServiceDisconnected", e);
}

System

La classe System fornisce le seguenti operazioni:

• Ottieni un token di autenticazione utilizzando getEloAccessToken.
• Cattura uno screenshot del dispositivo utilizzando captureScreenShot.
• Imposta l'orientamento del dispositivo (verticale, orizzontale, verticale inverso, orizzontale inverso) utilizzando setOrientation.
• Ottieni l'orientamento del dispositivo utilizzando getOrientation.
• Esegui un ripristino di fabbrica del dispositivo utilizzando factoryReset.
• Riavvia silenziosamente il dispositivo utilizzando silentReboot.
• Abilita o disabilita la Barra di Navigazione utilizzando setNavigationBarEnabled.
• Abilita o disabilita la Barra di Stato utilizzando setStatusBarEnabled.
• Concedi tutte le autorizzazioni di runtime utilizzando setGrantAllAppPermissionEnabled.
• Ottieni lo stato della Barra di Navigazione utilizzando getNavigationBarEnabled.
• Ottieni lo stato della Barra di Stato utilizzando getStatusBarEnabled.
• Ottieni lo stato di Grant All App Permission utilizzando getGrantAllAppPermissionEnabled.
• Imposta e ottieni il Timeout della Retroilluminazione utilizzando setBacklightTimeOut e getBacklightTimeOut.
• Imposta e cambia la password dello schermo di blocco utilizzando setLockScreenPassword e changeLockScreenPassword.
• Consenti automaticamente i permessi USB utilizzando autoAllowUSBPermission.
• Blocca o sblocca il firmware del processore sicuro utilizzando setFirmwareStatusLockEnabled.
• Imposta e cambia il PIN del dispositivo utilizzando setLockScreenPin e changeLockScreenPin.
• Abilita o disabilita il WiFi utilizzando setWifiEnabled e ottieni lo stato utilizzando getWifiEnabled.
• Cancella la cache e i dati dell'app utilizzando clearAllAppCacheUserData e clearAppCacheUserData.
• Abilita ADB utilizzando setAdbEnabled e configura la porta personalizzata utilizzando customPortAdb.
• Abilita o disabilita il pulsante Home utilizzando setHomeButtonEnabled.
• Abilita o disabilita il pulsante di accensione utilizzando setPowerButtonEnabled.
• Abilita o disabilita il menu di assistenza del Text Editor utilizzando setTextEditorAssistMenuEnabled.
• Abilita o disabilita il pannello del volume "Mostra di più" utilizzando setVolumePanelShowMoreEnabled.
• Abilita o disabilita lo scanner di codici a barre Zebra utilizzando setBarcodeReaderEnabled.
• Attiva la scansione del codice a barre utilizzando setScanBarcodeReaderEnabled.
• Abilita o disabilita il logging Elo utilizzando setEloLoggingEnabled.
• Abilita o disabilita il MAC WiFi casuale utilizzando setRandomWifiMacAddressEnabled.
• Abilita o disabilita l'accesso WebView della stampante Star utilizzando setStarPeripheralConnectEnabled.
• Controlla lo stato di auto-consentimento USB utilizzando getAutoAllowUSBPermission.

isM60Device

public static boolean isM60Device()

Questo metodo viene utilizzato per ottenere l'orientamento del dispositivo.

Restituisce

L'orientamento del dispositivo, ad esempio verticale o orizzontale.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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()

Questo metodo viene utilizzato per ottenere l'orientamento del dispositivo.

Restituisce

L'orientamento del dispositivo, ad esempio verticale o orizzontale.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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()

Questo metodo viene utilizzato per ottenere l'orientamento del dispositivo.

Restituisce

L'orientamento del dispositivo, ad esempio verticale o orizzontale.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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()

Questo metodo viene utilizzato per ottenere l'orientamento del dispositivo.

Restituisce

L'orientamento del dispositivo, ad esempio verticale o orizzontale.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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()

Questo metodo viene utilizzato per ottenere l'orientamento del dispositivo.

Restituisce

L'orientamento del dispositivo, ad esempio verticale o orizzontale.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo è utilizzato per collegare il servizio per accedere alle API di Sistema. Usa questo metodo per collegarti al servizio prima di utilizzare le API di Sistema.

Parametri

• context – Contesto dell'applicazione

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per scollegare il servizio dall'applicazione. Usa questo metodo per disconnetterti dal servizio quando liberi le risorse.

Parametri

• context – Contesto dell'applicazione

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per catturare uno screenshot. Lo screenshot verrà memorizzato nella posizione "/sdcard/elo/screenshot", e il messaggio di ritorno contiene anche il percorso dello screenshot.

Parametri

• fileName – Un nome file in formato PNG, ad esempio "screenshot.png".

Restituisce

true se lo screenshot è stato catturato con successo, false altrimenti.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per abilitare o disabilitare i servizi di accessibilità.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per abilitare o disabilitare Multi-Client IME. Dopo l'applicazione, il dispositivo verrà riavviato per riflettere le modifiche.

Parametri

• enable – Se abilitare o disabilitare la funzionalità.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per abilitare o disabilitare la scansione WiFi.

Parametri

• enable – Se abilitare o disabilitare la scansione WiFi.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per abilitare o disabilitare la scansione Bluetooth.

Parametri

• enable – Se abilitare o disabilitare la scansione Bluetooth.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per registrare un ascoltatore di eventi di tasti che può essere eseguito in un thread in background.

Parametri

• packageName – Nome del pacchetto a cui appartiene il componente dell'ascoltatore di tasti.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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()

Questo metodo viene utilizzato per ottenere lo stato abilitato del Multi-Client IME.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato для impostare la densità dello schermo. È necessario un riavvio affinché la modifica abbia effetto.

Parametri

• DPI – Valore intero per la densità dello schermo (160, 240, 320, 480 o 640).

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per impostare la densità del display esterno.

Parametri

• DPI – Valore intero per la densità dello schermo (160, 240, 320, 480 o 640).

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per impostare la risoluzione del display.

Parametri

• width – Larghezza dello schermo in pixel.
• height – Altezza dello schermo in pixel.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per impostare la dimensione del display.

Parametri

• size – Valore stringa che rappresenta la dimensione del display.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per impostare la dimensione del carattere.

Parametri

• size – Valore stringa che rappresenta la dimensione del carattere.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per impostare la più piccola larghezza di pixel visualizzata nelle Opzioni Sviluppatore.

Parametri

• smallestWidth – Valore intero per la più piccola larghezza in pixel.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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()

Questo metodo viene utilizzato per ottenere la più piccola larghezza di pixel mostrata nelle Opzioni Sviluppatore.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API 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)

Questo metodo viene utilizzato per impostare silenziosamente l'applicazione del launcher predefinito.

Parametri

• packageName – Nome del pacchetto dell'applicazione launcher.

Restituisce

true se il launcher predefinito è stato impostato con successo, false altrimenti.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API SDK
    Object result = sdk.setSilentDefaultLauncher("packageName");
    Log.d(TAG, "OK: setSilentDefaultLauncher result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: setSilentDefaultLauncher", e);
}

clearAppCacheUserData

public boolean clearAppCacheUserData(java.lang.String packageNames)

Questo metodo è utilizzato per cancellare la cache e i dati dell'utente delle applicazioni specifiche.

Parametri

• packageNames – Elenco separato da virgole dei nomi dei pacchetti.

Restituisce

true se la cache e i dati dell'utente vengono cancellati con successo, false altrimenti.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API SDK
    Object result = sdk.clearAppCacheUserData("packageNames");
    Log.d(TAG, "OK: clearAppCacheUserData result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: clearAppCacheUserData", e);
}

clearAllAppCacheUserData

public boolean clearAllAppCacheUserData(java.lang.String packageNames)

Questo metodo viene utilizzato per cancellare la cache e i dati dell'utente di tutte le applicazioni ad eccezione di quelle specificate.

Parametri

• packageNames – Elenco separato da virgole dei nomi dei pacchetti da escludere.

Restituisce

true se la cache e i dati dell'utente vengono cancellati con successo, false altrimenti.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API SDK
    Object result = sdk.clearAllAppCacheUserData("packageNames");
    Log.d(TAG, "OK: clearAllAppCacheUserData result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: clearAllAppCacheUserData", e);
}

setRandomWifiMacAddressEnabled

public void setRandomWifiMacAddressEnabled(boolean mac)

Questo metodo viene utilizzato per abilitare o disabilitare l'indirizzamento casuale MAC WiFi.

Parametri

• mac – true per abilitare MAC casualizzato, false per utilizzare un MAC fisso.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API SDK
    Object result = sdk.setRandomWifiMacAddressEnabled(true);
    Log.d(TAG, "OK: setRandomWifiMacAddressEnabled result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: setRandomWifiMacAddressEnabled", e);
}

setIdleModeEnabled

public void setIdleModeEnabled(boolean IdleMode)

Questo metodo viene utilizzato per abilitare o disabilitare la modalità Idle Automatica.

Parametri

• IdleMode – Valore booleano per abilitare o disabilitare la modalità Idle.

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API SDK
    Object result = sdk.setIdleModeEnabled(true);
    Log.d(TAG, "OK: setIdleModeEnabled result=" + result);
} catch (Exception e) {
    Log.e(TAG, "FAIL: setIdleModeEnabled", e);
}

setIdleModeTileEnabled

public int setIdleModeTileEnabled(boolean enable)

Questo metodo viene utilizzato per abilitare o disabilitare il Tile della modalità Idle. Funziona solo in modalità Android Home, modalità GMS, e modalità EloView Connect.

Parametri

• enable – Valore booleano per abilitare o disabilitare il Tile della modalità Idle. Per impostazione predefinita, il Tile è abilitato.

Restituisce

IdleModeTileStatus (int): 0 = successo, 1 = errore, -1 = non supportato

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API SDK
    Object result = sdk.setIdleModeTile