Piattaforme Supportate: Dispositivi Elo con Android 12 e Android 14, inclusi Backpack 4 (Standard/Value), I-Series 4 (Standard/Value), I-Series Standard, M50, Elo Pay M60, Elo Pay 7”, Elo Pay 22", M100, M100C.

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.

---

Migliori Pratiche Globali (da KB)

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

2. Assumi che la policy del dispositivo possa sovrascrivere le impostazioni locali.
   Questo è particolarmente vero per tempo, fuso orario, USB, modalità chiosco e installazione delle applicazioni.

3. Usa NTP per la sincronizzazione del tempo in produzione.
   Evita la configurazione manuale del tempo tranne per i test.

4. Comprendere il comportamento di ripristino.

   • Ripristino Aziendale resetta la configurazione e lo stato di registrazione di Elo.

   • Ripristino di Fabbrica cancella tutti i dati utente e riporta il dispositivo allo stato di fabbrica.

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 errato 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, "Fuso orario=" + tz);

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

Scenario: Configura in sicurezza la modalità chiosco con un'app singola

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

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

Modello di Collegamento del 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 invocate solo dopo che viene chiamato onServiceConnected().

Core / API di Collegamento del Servizio

EloView

La classe EloView fornisce le seguenti operazioni:

• Imposta il contenuto da riprodurre sul dispositivo in modalità Controllo Elo 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 nella modalità Controllo Elo utilizzando getPlayContent().
• Ottiene lo stato di riproduzione corrente del contenuto configurato in modalità Controllo Elo utilizzando getPlayContentStatus().
• Verifica se il dispositivo è attualmente connesso a EloView Cloud (online o offline) utilizzando getDeviceCloudStatus().
• Attiva o disattiva il Wi-Fi in Elo QuickSettings e in modalità Android Home utilizzando toggleWifi().
• Attiva o disattiva il Bluetooth in Elo QuickSettings 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: risultato di bindService=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: bindService", e);
}

unbindService

public void unbindService(android.content.Context context)

Questo metodo è utilizzato per disconnettere il servizio dall'applicazione. Usa questo metodo per disconnettere il servizio dalla 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: risultato di unbindService=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: unbindService", e);
}

setOfflinePlayContent

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

Questo metodo è utilizzato per impostare il contenuto sul dispositivo in modalità Controllo Elo quando il dispositivo è offline o non registrato a un account. Se il dispositivo si connette 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: risultato di setOfflinePlayContent=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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à Controllo Elo.

Esempio

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

getPlayContentStatus

public java.lang.String getPlayContentStatus()

Questo metodo restituisce lo stato del contenuto di riproduzione sul dispositivo in modalità Controllo. 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: risultato di getPlayContentStatus=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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 (Non Provisiorato)".

Esempio

try {
    // TODO: assicurati che il servizio sia collegato prima di chiamare le API SDK
    Object result = sdk.getDeviceCloudStatus();
    Log.d(TAG, "OK: risultato di getDeviceCloudStatus=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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 WiFi in QuickSettings.

Esempio

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

switchToAndroidHomeMode

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

Questo metodo viene utilizzato per passare dalla modalità EloView alla modalità Android Home. Questo è lo stesso di switchToAndroidHomeMode() eccetto per il fatto che accetta due parametri booleani. Non c'è modo di tornare a 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 si riavvierà per applicare il cambiamento della modalità.
• Nota importante: Passare alla modalità Android Home potrebbe disabilitare le restrizioni e le policy 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: risultato di switchToAndroidHomeMode=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: switchToAndroidHomeMode", e);
}

toggleBT

public int toggleBT(boolean isEnableBT)

Questo metodo viene utilizzato per attivare o disattivare il Bluetooth in QuickSettings (modalità EloView). Può anche essere utilizzato per attivare il Bluetooth in modalità Android Home.

Parametri

• isEnableBT – Booleano per abilitare o disabilitare il Bluetooth in QuickSettings.

Esempio

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

API di Account

AccountManager

La classe AccountManager fornisce le seguenti operazioni:

1. Fornire un token di autenticazione da un EloServer basato sulle credenziali fornite dall'utente (email/password o clientId/secretKey).

2. Verifica se un dato token di autenticazione è valido o è scaduto. Il token di autenticazione può essere sia il token ottenuto dal server Elo o può essere un token JWT offline fornito dal team di supporto Elo. (Il token offline viene 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 server personalizzato o da un file locale sul dispositivo, può essere utilizzato il token offline.

Per esempio, per ottenere un token di autenticazione:

1. Utilizzando emailId e password, chiama getEloAccessToken. 2. Utilizzando clientId e secretKey, chiama getEloOAuthToken. Dopo una corretta autenticazione, 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.

Disregistrati i ricevitori broadcast utilizzati da queste API dell'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: risultato di getProperty=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di setProperty=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di getClientId=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di getBaseUri=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di getEloAccessToken=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: getEloAccessToken", e);
}

configureOAuthHostedUI

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

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

Parametri

• activity – Un'istanza di Attività 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: risultato di configureOAuthHostedUI=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: configureOAuthHostedUI", e);
}

stopOAuth

public void stopOAuth()

Chiama stopOAuth nel metodo onStop() sovrascritto 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: risultato di stopOAuth=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: stopOAuth", e);
}

destroyOAuth

public void destroyOAuth()

Chiama destroyOAuth nel metodo onStop() sovrascritto 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: risultato di destroyOAuth=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di logoutOAuth=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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. Dopo la verifica riuscita, 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: risultato di verifyEloToken=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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. Dopo una corretta autenticazione, un token verrà inviato al dispositivo. Questo token è valido per l'uso per 24 ore dalla sua emissione. Quando il token scade, ulteriori tentativi di verificare il token e chiamare le API restituiranno la risposta TOKEN_VERIFY_FAIL. Lo stesso vale se un token non è mai stato ottenuto o ricevuto.

Se ha successo, il gestore riceverà un messaggio di tipo OAUTH_TOKEN_VALID con un token JWT come risposta. Qui di seguito un esempio di una risposta riuscita:

In caso di un errore di autenticazione a causa di un errore 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: risultato di getEloOAuthToken=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: getEloOAuthToken", e);
}

unregisterAccountManagerListener

public void unregisterAccountManagerListener(android.content.Context context)

Questo metodo è utilizzato per disregistrare il ricevitore broadcast registrato mentre si utilizzano le API AccountManager. Assicurati di chiamare questo nei metodi onPause e onDestroy nel tuo ciclo di vita dell'attività se hai utilizzato le API AccountManager. Questo garantisce che il ricevitore non venga perso.

Parametri

• context – Contesto in cui sono state utilizzate le API del sistema.
• context – Contesto Android utilizzato per disregistrare il ricevitore dell'account manager.

Esempio

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

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: risultato di getProperty=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di setProperty=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di getClientId=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di getBaseUri=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di getEloAccessToken=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: getEloAccessToken", e);
}

configureOAuthHostedUI

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

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

Parametri

• activity – Un'istanza di Attività 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: risultato di configureOAuthHostedUI=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: configureOAuthHostedUI", e);
}

stopOAuth

public void stopOAuth()

Chiama stopOAuth nel metodo onStop() sovrascritto 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: risultato di stopOAuth=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: stopOAuth", e);
}

destroyOAuth

public void destroyOAuth()

Chiama destroyOAuth nel metodo onStop() sovrascritto 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: risultato di destroyOAuth=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di logoutOAuth=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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. Dopo la verifica riuscita, 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: risultato di verifyEloToken=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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. Dopo una corretta autenticazione, un token verrà inviato al dispositivo. Questo token è valido per l'uso per 24 ore dalla sua emissione. Quando il token scade, ulteriori tentativi di verificare il token e chiamare le API restituiranno la risposta TOKEN_VERIFY_FAIL. Lo stesso vale se un token non è mai stato ottenuto o ricevuto.

Se ha successo, il gestore riceverà un messaggio di tipo OAUTH_TOKEN_VALID con un token JWT come risposta. Qui di seguito un esempio di una risposta riuscita:

In caso di un errore di autenticazione a causa di un errore 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: risultato di getEloOAuthToken=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: getEloOAuthToken", e);
}

unregisterAccountManagerListener

public void unregisterAccountManagerListener(android.content.Context context)

Questo metodo è utilizzato per disregistrare il ricevitore broadcast registrato mentre si utilizzano le API AccountManager. Assicurati di chiamare questo nei metodi onPause e onDestroy nel tuo ciclo di vita dell'attività se hai utilizzato le API AccountManager. Questo garantisce che il ricevitore non venga perso.

Parametri

• context – Contesto in cui sono state utilizzate le API del sistema.
• context – Contesto Android utilizzato per disregistrare il ricevitore dell'account manager.

Esempio

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

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: risultato di getProperty=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di setProperty=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di getClientId=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di getBaseUri=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di getEloAccessToken=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: getEloAccessToken", e);
}

configureOAuthHostedUI

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

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

Parametri

• activity – Un'istanza di Attività 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: risultato di configureOAuthHostedUI=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: configureOAuthHostedUI", e);
}

stopOAuth

public void stopOAuth()

Chiama stopOAuth nel metodo onStop() sovrascritto 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: risultato di stopOAuth=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: stopOAuth", e);
}

destroyOAuth

public void destroyOAuth()

Chiama destroyOAuth nel metodo onStop() sovrascritto 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: risultato di destroyOAuth=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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: risultato di logoutOAuth=" + result);
} catch (Exception e) {
    Log.e(TAG, "FALLIMENTO: 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. Dopo la verifica riuscita, il gestore riceverà un messaggio di tipo TOKEN_VERIFY_SUCCESS. In caso di errore, TOKEN_VERIFY_FAIL verrà ricevuto.