Plateformes supportées : Appareils Elo sous Android 12 et Android 14, y compris le Backpack 4 (Standard/Value), I-Series 4 (Standard/Value), I-Series Standard, M50, Elo Pay M60, Elo Pay 7”, Elo Pay 22", M100, M100C.
Référence complète (Base de connaissances + Javadoc SDK)
Les API sont organisées par classe fonctionnelle (Système, Réseau, Paquet, etc.) pour simplifier la découverte et accélérer la mise en œuvre.
Meilleures pratiques globales (issu de la KB)
-
Toujours s'associer au service avant d'appeler une API.
Ne pas invoquer les méthodes jusqu'à ce queonServiceConnected()soit reçu. -
Supposer que la politique de l'appareil peut remplacer les paramètres locaux.
Cela est particulièrement vrai pour le temps, le fuseau horaire, l'USB, le mode kiosque et l'installation d'applications. -
Utiliser NTP pour la synchronisation horaire en production.
Évitez la configuration manuelle de l'heure sauf pour les tests. -
Comprendre le comportement de réinitialisation.
-
Réinitialisation d'entreprise efface la configuration Elo et l'état d'inscription.
-
Réinitialisation d'usine efface toutes les données utilisateur et ramène l'appareil à l'état d'origine.
-
-
Journaliser le résultat de chaque appel API.
Cela est essentiel pour le dépannage et l'escalade.
❗ Notes d'utilisation importantes
Certaines API SDK nécessitent des autorisations Android spécifiques et peuvent se comporter différemment selon que l'appareil est en mode EloView ou en mode Android Home. L'application de la politique de l'appareil peut remplacer les paramètres appliqués localement. Les développeurs doivent valider le mode de l'appareil et l'état des autorisations avant d'invoquer des API dans des applications de production.
Le SDK EloView Home est un SDK Android basé sur des services et nécessite un liaison de service réussie avant que des appels API puissent être exécutés. Les méthodes peuvent renvoyer null ou aucun résultat si :
- Le service n'est pas encore connecté
- L'appareil n'est pas dans un état EloView compatible
- Des restrictions politiques bloquent l'opération
Ce guide se concentre sur les modèles supportés et couramment utilisés. Il ne répertorie pas chaque autorisation Android, cas limite de cycle de vie ou état de retour interne documenté dans le Javadoc brut du SDK. La gestion standard des cycles de vie de service Android et la vérification des erreurs doivent être mises en œuvre dans les applications de production.
Scénarios courants du monde réel (issue de la KB)
Scénario : Fuseau horaire incorrect après l'inscription de l'appareil
system.setNtpEnabled(true);
system.setNtpServer("time.aws.com");
system.setTimeZone("US/Central");
system.syncTimeNow();
// Vérifiez
String tz = system.getTimeZone();
Log.d(TAG, "Fuseau horaire=" + tz);
Astuce : Si le fuseau horaire revient après le redémarrage, vérifiez que le fuseau horaire automatique Android est activé et que la politique de l'appareil ne réapplique pas une région différente.
Scénario : Configurer en toute sécurité le mode kiosque à application unique
pkg.setKioskApp("com.example.kiosk");
pkg.setKioskModeEnabled(true);
pkg.launchApp("com.example.kiosk");
Avertissement : Toujours valider un chemin d'évasion administrative avant d'activer le mode kiosque en production.
Modèle de liaison de service (issu de la KB)
eloView.bindService(context, callback, accessToken);
// Sûr d'appeler les API SDK à l'intérieur de callback.onServiceConnected()
eloView.unbindService(context);
Remarque importante : bindService() et unbindService() ne renvoient pas de valeurs. Les API SDK ne doivent être invoquées qu'après que onServiceConnected() est appelé.
Core / APIs de liaison de service
EloView
La classe EloView fournit les opérations suivantes :
- Définir le contenu à lire sur l'appareil en mode EloView Control lorsque l'appareil est hors ligne ou non enregistré à un compte en utilisant setOfflinePlayContent().
- Récupérer le type de contenu (APK ou WebView) et le nom du contenu actuellement défini en mode EloView Control en utilisant getPlayContent().
- Obtenir le statut de lecture actuel du contenu configuré en mode EloView Control en utilisant getPlayContentStatus().
- Vérifier si l'appareil est actuellement connecté à EloView Cloud (en ligne ou hors ligne) en utilisant getDeviceCloudStatus().
- Activer/désactiver le Wi-Fi dans Elo QuickSettings et le mode Android Home en utilisant toggleWifi().
- Activer/désactiver le Bluetooth dans Elo QuickSettings et le mode Android Home en utilisant toggleBT().
bindService
public void bindService(android.content.Context context, ServiceConnectionCallback callback, java.lang.String accessToken)
Cette méthode lie le service EloView à l'application. Vous devez l'appeler avant d'invoquer n'importe quelle API EloView.
Paramètres
- context – Contexte dans lequel les API EloView sont utilisées.
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.bindService(context, callback, "accessToken");
Log.d(TAG, "OK : résultat de bindService=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : bindService", e);
}
unbindService
public void unbindService(android.content.Context context)
Cette méthode est utilisée pour détacher le service de l'application. Utilisez cette méthode pour détacher le service de l'application lors de la libération des ressources.
Paramètres
- context – Contexte
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.unbindService(context);
Log.d(TAG, "OK : résultat de unbindService=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : unbindService", e);
}
setOfflinePlayContent
public java.lang.String setOfflinePlayContent(java.lang.String packageName)
Cette méthode est utilisée pour définir du contenu sur l'appareil en mode EloView Control lorsque l'appareil est hors ligne ou non enregistré à un compte. Si l'appareil se connecte et que du contenu est défini via EloView, cela écrasera le contenu défini via cette API.
Paramètres
- packageName – Package à définir comme contenu par défaut sur l'appareil.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setOfflinePlayContent("packageName");
Log.d(TAG, "OK : résultat de setOfflinePlayContent=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setOfflinePlayContent", e);
}
getPlayContent
public java.lang.String getPlayContent()
Cette méthode renvoie le type de contenu et le nom du contenu défini sur l'appareil. Cette méthode ne fonctionne que dans le mode EloView Control.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.getPlayContent();
Log.d(TAG, "OK : résultat de getPlayContent=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : getPlayContent", e);
}
getPlayContentStatus
public java.lang.String getPlayContentStatus()
Cette méthode renvoie le statut du contenu joué sur l'appareil en mode Control. Le statut peut être l'une des chaînes suivantes :
YET_TO_DOWNLOAD, DOWNLOADING, DOWNLOADED, INSTALLING, INSTALLED, DOWNLOAD_FAILED, INSTALL_FAILED, UNKNOWN_STATUS
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.getPlayContentStatus();
Log.d(TAG, "OK : résultat de getPlayContentStatus=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : getPlayContentStatus", e);
}
getDeviceCloudStatus
public java.lang.String getDeviceCloudStatus()
Cette méthode renvoie le statut en ligne ou hors ligne de l'appareil. Le statut peut être l'une des chaînes suivantes : "En ligne", "Hors ligne", "Connexion", "Reconnecté", "En ligne (non provisionné)".
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.getDeviceCloudStatus();
Log.d(TAG, "OK : résultat de getDeviceCloudStatus=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : getDeviceCloudStatus", e);
}
toggleWifi
void toggleWifi(boolean isEnableWifi)
Active ou désactive le Wi-Fi sur l'appareil. Cela s'applique à la fois en mode EloView et en mode Android Home.
Paramètres
- isEnableWifi – Boolean pour activer ou désactiver le WiFi dans QuickSettings.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.toggleWifi(true);
Log.d(TAG, "OK : résultat de toggleWifi=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : toggleWifi", e);
}
switchToAndroidHomeMode
void switchToAndroidHomeMode() void switchToAndroidHomeMode(boolean isRebootNeeded, boolean isAndroidHomeMode)
Cette méthode est utilisée pour passer au mode Android Home à partir du mode EloView. C'est la même chose que switchToAndroidHomeMode() sauf qu'elle accepte deux paramètres boolean. Il n'y a pas moyen de revenir au mode EloView sans une réinitialisation d'usine, alors utilisez-la avec précaution.
Paramètres
- Change l'appareil du mode EloView au mode Android Home.
- Si isRebootNeeded est défini sur vrai, l'appareil redémarrera pour appliquer le changement de mode.
- Remarque importante : Passer en mode Android Home peut désactiver les restrictions et politiques gérées par EloView.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.switchToAndroidHomeMode(true, true);
Log.d(TAG, "OK : résultat de switchToAndroidHomeMode=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : switchToAndroidHomeMode", e);
}
toggleBT
public int toggleBT(boolean isEnableBT)
Cette méthode est utilisée pour activer/désactiver Bluetooth dans QuickSettings (mode EloView). Elle peut également être utilisée pour basculer le Bluetooth en mode Android Home.
Paramètres
- isEnableBT – Boolean pour activer ou désactiver le Bluetooth dans QuickSettings.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.toggleBT(true);
Log.d(TAG, "OK : résultat de toggleBT=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : toggleBT", e);
}
APIs de compte
AccountManager
La classe AccountManager fournit les opérations suivantes :
1. Fournir un jeton d'authentification d'un EloServer basé sur les informations d'identification fournies par l'utilisateur (emailId/mot de passe ou clientId/clé secrète).
2. Vérifiez si un jeton d'authentification donné est valide ou a expiré. Le jeton d'authentification peut être soit le jeton obtenu du serveur EloView, soit un jeton JWT hors ligne fourni par l'équipe de support Elo. (Le jeton hors ligne est généré à l'aide du nom de package de votre application et ne peut être utilisé qu'avec le package pour lequel il a été généré.)
3. Toutes les API nécessitent un jeton hors ligne pour fonctionner et ne fonctionneront pas avec un jeton en ligne. La seule exception est les API OTA. Les API OTA nécessitent le jeton en ligne lors de l'application de l'OTA depuis un serveur EloView. Pour appliquer l'OTA via une URL de serveur personnalisée ou à partir d'un fichier local sur l'appareil, le jeton hors ligne peut être utilisé.
Par exemple, pour obtenir un jeton d'authentification :
1. À l'aide de emailId et mot de passe, appelez getEloAccessToken. 2. En utilisant clientId et clé secrète, appelez getEloOAuthToken. Après une authentification réussie, ces méthodes renverront un jeton. 3. Pour le jeton JWT hors ligne, contactez l'équipe de support Elo.
Le jeton récupéré depuis le serveur ou l'équipe de support est vérifié à l'aide de la méthode verifyEloToken.
Désenregistrez les récepteurs de diffusion utilisés par ces API AccountManager à l'aide de la méthode unregisterAccountManagerListener dans les méthodes onPause et onDestroy des activités dans lesquelles vous utilisez ces API pour éviter les fuites.
getProperty
public static java.lang.String getProperty()
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.getProperty();
Log.d(TAG, "OK : résultat de getProperty=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : getProperty", e);
}
setProperty
public void setProperty(java.lang.String property)
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setProperty("property");
Log.d(TAG, "OK : résultat de setProperty=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setProperty", e);
}
getClientId
public static java.lang.String getClientId()
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.getClientId();
Log.d(TAG, "OK : résultat de getClientId=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : getClientId", e);
}
getBaseUri
public static android.net.Uri getBaseUri()
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.getBaseUri();
Log.d(TAG, "OK : résultat de getBaseUri=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : getBaseUri", e);
}
getEloAccessToken
public void getEloAccessToken(android.content.Context context, java.lang.String userEmail, java.lang.String password, android.os.Handler handler)
Cette méthode est utilisée pour obtenir un jeton d'accès depuis le serveur Elo.
Paramètres
- context – Un objet Context de la classe appelante (Activité ou Service).
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.getEloAccessToken(context, "userEmail", "password", handler);
Log.d(TAG, "OK : résultat de getEloAccessToken=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : getEloAccessToken", e);
}
configureOAuthHostedUI
public void configureOAuthHostedUI(android.app.Activity activity, android.os.Handler handler)
Cette méthode est utilisée pour initialiser l'UI hébergée OAuth.
Paramètres
- activity – Une instance d'Activity de la classe appelante.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.configureOAuthHostedUI(activity, handler);
Log.d(TAG, "OK : résultat de configureOAuthHostedUI=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : configureOAuthHostedUI", e);
}
stopOAuth
public void stopOAuth()
Appelez stopOAuth dans la méthode onStop() de l'activité.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.stopOAuth();
Log.d(TAG, "OK : résultat de stopOAuth=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : stopOAuth", e);
}
destroyOAuth
public void destroyOAuth()
Appelez destroyOAuth dans la méthode onStop() de l'activité.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.destroyOAuth();
Log.d(TAG, "OK : résultat de destroyOAuth=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : destroyOAuth", e);
}
logoutOAuth
public void logoutOAuth()
Appelez logoutOAuth pour mettre fin à la session de connexion actuelle.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.logoutOAuth();
Log.d(TAG, "OK : résultat de logoutOAuth=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : logoutOAuth", e);
}
verifyEloToken
public void verifyEloToken(android.content.Context context, java.lang.String accessToken, android.os.Handler handler)
Cette fonction demande au serveur Elo de vérifier le jeton donné. Après une vérification réussie, le gestionnaire recevra un message de type TOKEN_VERIFY_SUCCESS. En cas d'échec, TOKEN_VERIFY_FAIL sera reçu.
Paramètres
- context – Un objet Context de la classe appelante (Activité ou Service).
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.verifyEloToken(context, "accessToken", handler);
Log.d(TAG, "OK : résultat de verifyEloToken=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : verifyEloToken", e);
}
getEloOAuthToken
public void getEloOAuthToken(android.content.Context context, java.lang.String clientID, java.lang.String secret, android.os.Handler handler)
Cette méthode est utilisée pour demander un nouveau token OAuth au portail EloView. Après une authentification réussie, un token sera envoyé à l'appareil. Ce token est valide pendant 24 heures après sa délivrance. Lorsque le token expire, toute tentative de vérification du token et d'appels API donnera la réponse TOKEN_VERIFY_FAIL. Il en va de même si un token n'a jamais été acquis ou reçu.
Si réussi, le gestionnaire recevra un message de type OAUTH_TOKEN_VALID avec un token JWT en réponse. Ci-dessous se trouve un exemple de réponse réussie :
"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IlJQTSJ9.eyJ1ZW1haWwiOiJwcmF0YXBlbG8rUHJvZEBnbWFpbC5jb20iLCJvdGl0bGUiOiJwcmF0YXBlbG8rUHJvZEBnbWFpbC5jb20iLCJjYXAiOnsiY3JjIjoiSDIvb2RnIiwicGVybSI6ImZmZmZmZmYwMCJ9LCJpYXQiOjE1MjUxMTc4NDgsIm5iZiI6MTUyNTExNzg0OCwiZXhwIjoxNTI1MjA0MjQ4LCJpc3MiOiIxNTAyIiwic3ViIjoiZWVhNDRkY2JkMjU5YzQyOWY4NTA3YWZhNTQyY2Q3M2YiLCJqdGkiOiJ2ZE14N1ppUGVnWT0ifQ.b2e-F1mVh0ummkBJk3m8pT2qSCceRxuS_A9GAKtYBeo"
En cas d'échec de l'authentification en raison d'un mauvais clientID ou secretID, le gestionnaire recevra un message de type OAUTH_TOKEN_INVALID.
Paramètres
- context – Un objet Context de la classe appelante (Activité ou Service).
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.getEloOAuthToken(context, "clientID", "secret", handler);
Log.d(TAG, "OK : résultat de getEloOAuthToken=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : getEloOAuthToken", e);
}
unregisterAccountManagerListener
public void unregisterAccountManagerListener(android.content.Context context)
Cette méthode est utilisée pour désenregistrer le récepteur de diffusion enregistré lors de l'utilisation de n'importe laquelle des API AccountManager. Veuillez vous assurer d'appeler cela dans les méthodes onPause et onDestroy de votre cycle de vie d'activité si vous avez utilisé n'importe laquelle des API AccountManager. Cela garantit que le récepteur n'est pas perdu.
Paramètres
- context – Contexte dans lequel les APIs de système ont été utilisées.
- context – Contexte Android utilisé pour désenregistrer l'écouteur du gestionnaire de compte.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.unregisterAccountManagerListener(context);
Log.d(TAG, "OK : résultat de unregisterAccountManagerListener=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : unregisterAccountManagerListener", e);
}
setDefaultEnvironment
public void setDefaultEnvironment(android.content.Context ctx)
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setDefaultEnvironment(context);
Log.d(TAG, "OK : résultat de setDefaultEnvironment=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setDefaultEnvironment", e);
}
selectEnvironment
public void selectEnvironment(android.content.Context ctx, java.lang.String prop, boolean isSealed)
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.selectEnvironment(context, "prop", true);
Log.d(TAG, "OK : résultat de selectEnvironment=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : selectEnvironment", e);
}
isPolarisLocked
public boolean isPolarisLocked(android.content.Context context)
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.isPolarisLocked(context);
Log.d(TAG, "OK : résultat de isPolarisLocked=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : isPolarisLocked", e);
}
getEnvironment
public java.lang.String getEnvironment(android.content.Context ctx)
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.getEnvironment(context);
Log.d(TAG, "OK : résultat de getEnvironment=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : getEnvironment", e);
}
isPolaris
public boolean isPolaris(android.content.Context context)
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.isPolaris(context);
Log.d(TAG, "OK : résultat de isPolaris=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : isPolaris", e);
}
TokenListener
TokenListener écoute les événements de vérification du jeton d'authentification et, sur un jeton valide, fournit la réponse de succès pour effectuer d'autres opérations.
Aucune méthode n'est documentée pour ce type.
APIs système
ServiceConnectionCallback
onServiceConnected
void onServiceConnected()
Cette méthode est appelée lorsque le service est connecté après avoir appelé bindService.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.onServiceConnected();
Log.d(TAG, "OK : résultat de onServiceConnected=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : onServiceConnected", e);
}
onServiceDisconnected
void onServiceDisconnected()
Cette méthode est appelée lorsque le service est déconnecté. Cela ne sera pas appelé si le service est désenregistré à l'aide de unbindService.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.onServiceDisconnected();
Log.d(TAG, "OK : résultat de onServiceDisconnected=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : onServiceDisconnected", e);
}
Système
La classe Système fournit les opérations suivantes :
-
Obtenir un jeton d'authentification en utilisant
getEloAccessToken. -
Capturer la capture d'écran de l'appareil en utilisant
captureScreenShot. -
Définir l'orientation de l'appareil (portrait, paysage, portrait inversé, paysage inversé)
en utilisant
setOrientation. -
Obtenir l'orientation de l'appareil en utilisant
getOrientation. -
Réinitialiser l'appareil en usine en utilisant
factoryReset. -
Redémarrer silencieusement l'appareil en utilisant
silentReboot. -
Activer ou désactiver la barre de navigation en utilisant
setNavigationBarEnabled. -
Activer ou désactiver la barre d'état en utilisant
setStatusBarEnabled. -
Accorder toutes les autorisations d'exécution en utilisant
setGrantAllAppPermissionEnabled. -
Obtenir le statut de la barre de navigation en utilisant
getNavigationBarEnabled. -
Obtenir le statut de la barre d'état en utilisant
getStatusBarEnabled. -
Obtenir le statut de l'autorisation de toutes les applications via
getGrantAllAppPermissionEnabled. -
Définir et obtenir le temps d'attente de rétroéclairage en utilisant
setBacklightTimeOutetgetBacklightTimeOut. -
Définir et changer le mot de passe de l'écran de verrouillage en utilisant
setLockScreenPasswordetchangeLockScreenPassword. -
Autoriser automatiquement les autorisations USB en utilisant
autoAllowUSBPermission. -
Verrouiller ou déverrouiller le micrologiciel du processeur sécurisé en utilisant
setFirmwareStatusLockEnabled. -
Définir et changer le code PIN de l'appareil en utilisant
setLockScreenPinetchangeLockScreenPin. -
Activer ou désactiver le WiFi en utilisant
setWifiEnabledet obtenir le statut en utilisantgetWifiEnabled. -
Effacer le cache et les données de l'application en utilisant
clearAllAppCacheUserDataetclearAppCacheUserData. -
Activer ADB en utilisant
setAdbEnabledet configurer le port personnalisé en utilisantcustomPortAdb. -
Activer ou désactiver le bouton d'accueil en utilisant
setHomeButtonEnabled. -
Activer ou désactiver le bouton d'alimentation en utilisant
setPowerButtonEnabled. -
Activer ou désactiver le menu d'assistance de l'éditeur de texte en utilisant
setTextEditorAssistMenuEnabled. -
Activer ou désactiver le panneau de volume "Afficher plus" en utilisant
setVolumePanelShowMoreEnabled. -
Activer ou désactiver le scanner de code à barres Zebra en utilisant
setBarcodeReaderEnabled. -
Déclencher le scan de codes à barres en utilisant
setScanBarcodeReaderEnabled. -
Activer ou désactiver la journalisation Elo en utilisant
setEloLoggingEnabled. -
Activer ou désactiver le MAC WiFi aléatoire en utilisant
setRandomWifiMacAddressEnabled. -
Activer ou désactiver l'accès WebView de l'imprimante Star en utilisant
setStarPeripheralConnectEnabled. -
Vérifier le statut de l'autorisation d'auto-autorisation USB en utilisant
getAutoAllowUSBPermission. -
Définir, supprimer et interroger le propriétaire de l'appareil en utilisant
setDeviceOwner,removeDeviceOwneretgetDeviceOwnerStatus. -
Définir et obtenir la DPI d'affichage en utilisant
setDpietgetDpi. -
Définir et obtenir la langue en utilisant
setLanguageetgetLanguage. -
Définir et obtenir le type de verrouillage en utilisant
setLockTypeetgetLockType. -
Activer ou désactiver Multi Client IME en utilisant
setMultiClientImeEnabledetgetMultiClientImeEnabled. -
Définir et obtenir le serveur NTP en utilisant
setNtpServerUrletgetNtpServerUrl. -
Définir et obtenir l'intervalle de sondage NTP en utilisant
setNtpPollIntervaletgetNtpPollInterval. -
Contrôler les autorisations d'installation en utilisant
setInstallPermissionToSpecificApp,setInstallAllAppPermissionEnabledetgetInstallPermissionToSpecificApp. -
Définir et obtenir la taille de l'écran en utilisant
setScreenSizeetgetScreenSize. -
Définir et obtenir la plus petite largeur de pixel en utilisant
setSmallestPixelWidthetgetSmallestPixelWidth. -
Définir et obtenir le fuseau horaire en utilisant
setTimeZoneetgetTimeZone. -
Activer ou désactiver les services d'accessibilité en utilisant
setAccessibilityService. -
Activer ou désactiver la date et l'heure automatiques en utilisant
setAutoDateTimeEnabled. -
Activer ou désactiver la confirmation d'apairage Bluetooth en utilisant
setBluetoothDevicePairingConfirmationEnabled. -
Définir la date et l'heure en utilisant
setDateTime. -
Définir la taille d'affichage en utilisant
setDisplaySize. -
Configurer le WiFi en utilisant CSV avec
setEloNetworkConf. -
Définir la taille de la police en utilisant
setFontSize. -
Activer ou désactiver le mode inactif en utilisant
setIdleModeEnabled. -
Activer ou désactiver l'emplacement en utilisant
setLocationEnabled. -
Couper ou rétablir le microphone en utilisant
setMicrophoneMuteEnabled. -
Activer ou désactiver la visibilité des mots de passe en utilisant
setPasswordEnabled. -
Activer ou désactiver Play Protect en utilisant
setPlayProtect. -
Définir et obtenir l'espace de log réservé en utilisant
setReservedLogSpaceetgetReservedLogSpace. -
Définir le format de l'heure en utilisant
setTimeFormatEnabled. -
Activer ou désactiver les sons de contact en utilisant
setTouchSoundEnabled. -
Définir les niveaux de volume en utilisant
setVolumeLevel. -
Activer ou désactiver le menu partage de sélection de texte en utilisant
setShowTextEditorShareMenuEnabled. -
Éteindre l'appareil silencieusement en utilisant
silentShutDown. -
Définir le lanceur par défaut en utilisant
setSilentDefaultLauncher. -
Obtenir le statut de verrouillage du microphone en utilisant
getFirmwareStatusLockEnabled. -
Mettre à niveau le micrologiciel du processeur sécurisé en utilisant
spFirmwareUpgrade. -
Démarrer une activité depuis un service en premier plan en utilisant
startActivityFromForegroundService. -
Activer ou désactiver le mode sombre en utilisant
setDarkModeEnabled. -
Réveiller l'écran en utilisant
wakeupScreen. -
Activer ou désactiver l'alerte sonore et la vibration de charge en utilisant
setChargingSoundAndVibrationEnabled. -
Activer ou désactiver le son de verrouillage de l'écran en utilisant
setScreenLockSoundEnabled. -
Activer ou désactiver la tuile du mode inactif en utilisant
setIdleModeTileEnabled. -
Obtenir et définir le nom d'hôte en utilisant
getHostNameetsetHostName. -
Activer ou désactiver l'accessibilité de point d'accès en utilisant
setHotspotAccessibilityEnabledetgetHotspotAccessibilityEnabled. -
Obtenir le contrôle de vérification du checksum MD5 en utilisant
getMD5Checksum. -
Lier et détacher le service système en utilisant
bindServiceetunbindService.
isM60Device
public static boolean isM60Device()
Cette méthode est utilisée pour obtenir l'orientation de l'appareil.
Retours
Orientation de l'appareil, par exemple en mode portrait ou paysage.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.isM60Device();
Log.d(TAG, "OK : résultat de isM60Device=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : isM60Device", e);
}
isM50Device
public static boolean isM50Device()
Cette méthode est utilisée pour obtenir l'orientation de l'appareil.
Retours
Orientation de l'appareil, par exemple en mode portrait ou paysage.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.isM50Device();
Log.d(TAG, "OK : résultat de isM50Device=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : isM50Device", e);
}
isM100Device
public static boolean isM100Device()
Cette méthode est utilisée pour obtenir l'orientation de l'appareil.
Retours
Orientation de l'appareil, par exemple en mode portrait ou paysage.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.isM100Device();
Log.d(TAG, "OK : résultat de isM100Device=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : isM100Device", e);
}
is7PayDevice
public static boolean is7PayDevice()
Cette méthode est utilisée pour obtenir l'orientation de l'appareil.
Retours
Orientation de l'appareil, par exemple en mode portrait ou paysage.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.is7PayDevice();
Log.d(TAG, "OK : résultat de is7PayDevice=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : is7PayDevice", e);
}
isM51Device
public boolean isM51Device()
Cette méthode est utilisée pour obtenir l'orientation de l'appareil.
Retours
Orientation de l'appareil, par exemple en mode portrait ou paysage.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.isM51Device();
Log.d(TAG, "OK : résultat de isM51Device=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : isM51Device", e);
}
bindService
public void bindService(android.content.Context context, ServiceConnectionCallback callback, java.lang.String accessToken)
Cette méthode est utilisée pour lier le service afin d'accéder aux APIs Système. Utilisez cette méthode pour lier le service avant d'utiliser les APIs Système.
Paramètres
- context – Contexte de l'application
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.bindService(context, callback, "accessToken");
Log.d(TAG, "OK : résultat de bindService=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : bindService", e);
}
unbindService
public void unbindService(android.content.Context context)
Cette méthode est utilisée pour détacher le service de l'application. Utilisez cette méthode pour vous détacher du service lors du nettoyage des ressources.
Paramètres
- context – Contexte de l'application
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.unbindService(context);
Log.d(TAG, "OK : résultat de unbindService=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : unbindService", e);
}
captureScreenShot
public boolean captureScreenShot(java.lang.String fileName)
Cette méthode est utilisée pour prendre une capture d'écran. La capture d'écran sera stockée à l'emplacement "/sdcard/elo/screenshot", et le message de retour contient également le chemin de la capture d'écran.
Paramètres
- fileName – Un nom de fichier au format PNG, par exemple "screenshot.png".
Retours
true si la capture d'écran est prise avec succès, false sinon.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.captureScreenShot("fileName");
Log.d(TAG, "OK : résultat de captureScreenShot=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : captureScreenShot", e);
}
setAccessibilityService
public void setAccessibilityService(java.lang.String packageName, boolean enableAccessibilityService)
Cette méthode est utilisée pour activer ou désactiver les services d'accessibilité.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setAccessibilityService("packageName", true);
Log.d(TAG, "OK : résultat de setAccessibilityService=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setAccessibilityService", e);
}
setMultiClientImeEnabled
public boolean setMultiClientImeEnabled(boolean enable, boolean reboot)
Cette méthode est utilisée pour activer ou désactiver Multi-Client IME. Après application, l'appareil redémarrera pour refléter les changements.
Paramètres
- enable – Que ce soit pour activer ou désactiver la fonctionnalité.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setMultiClientImeEnabled(true, true);
Log.d(TAG, "OK : résultat de setMultiClientImeEnabled=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setMultiClientImeEnabled", e);
}
setWifiScanning
public void setWifiScanning(boolean enable)
Cette méthode est utilisée pour activer ou désactiver la recherche WiFi.
Paramètres
- enable – Que ce soit pour activer ou désactiver la recherche WiFi.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setWifiScanning(true);
Log.d(TAG, "OK : résultat de setWifiScanning=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setWifiScanning", e);
}
setBluetoothScanning
public void setBluetoothScanning(boolean enable)
Cette méthode est utilisée pour activer ou désactiver la recherche Bluetooth.
Paramètres
- enable – Que ce soit pour activer ou désactiver la recherche Bluetooth.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setBluetoothScanning(true);
Log.d(TAG, "OK : résultat de setBluetoothScanning=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : 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)
Cette méthode est utilisée pour enregistrer un écouteur d'événements de touche qui peut s'exécuter dans un thread en arrière-plan.
Paramètres
- packageName – Nom du package auquel appartient le composant de l'écouteur de touches.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setKeyListener("packageName", "receiverName", 0, 0);
Log.d(TAG, "OK : résultat de setKeyListener=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setKeyListener", e);
}
getMultiClientImeEnabled
public boolean getMultiClientImeEnabled()
Cette méthode est utilisée pour obtenir l'état d'activation de Multi-Client IME.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.getMultiClientImeEnabled();
Log.d(TAG, "OK : résultat de getMultiClientImeEnabled=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : getMultiClientImeEnabled", e);
}
setDpi
public boolean setDpi(int DPI)
Cette méthode est utilisée pour définir la DPI d'affichage. Un redémarrage est requis pour que le changement prenne effet.
Paramètres
- DPI – Valeur entière pour la densité d'écran (160, 240, 320, 480 ou 640).
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setDpi(0);
Log.d(TAG, "OK : résultat de setDpi=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setDpi", e);
}
setCFDDpi
public boolean setCFDDpi(int DPI)
Cette méthode est utilisée pour définir la DPI de l'affichage externe.
Paramètres
- DPI – Valeur entière pour la densité d'écran (160, 240, 320, 480 ou 640).
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setCFDDpi(0);
Log.d(TAG, "OK : résultat de setCFDDpi=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setCFDDpi", e);
}
setScreenSize
public boolean setScreenSize(int width, int height)
Cette méthode est utilisée pour définir la résolution d'affichage.
Paramètres
- width – Largeur de l'écran en pixels.
- height – Hauteur de l'écran en pixels.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setScreenSize(0, 0);
Log.d(TAG, "OK : résultat de setScreenSize=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setScreenSize", e);
}
setDisplaySize
public boolean setDisplaySize(java.lang.String size)
Cette méthode est utilisée pour définir la taille d'affichage.
Paramètres
- size – Valeur string représentant la taille de l'affichage.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setDisplaySize("size");
Log.d(TAG, "OK : résultat de setDisplaySize=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setDisplaySize", e);
}
setFontSize
public boolean setFontSize(java.lang.String size)
Cette méthode est utilisée pour définir la taille de la police.
Paramètres
- size – Valeur string représentant la taille de la police.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setFontSize("size");
Log.d(TAG, "OK : résultat de setFontSize=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setFontSize", e);
}
setSmallestPixelWidth
public boolean setSmallestPixelWidth(int smallestWidth)
Cette méthode est utilisée pour définir la plus petite largeur de pixel affichée dans les options pour développeurs.
Paramètres
- smallestWidth – Valeur entière pour la plus petite largeur en pixels.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setSmallestPixelWidth(0);
Log.d(TAG, "OK : résultat de setSmallestPixelWidth=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setSmallestPixelWidth", e);
}
getSmallestPixelWidth
public int getSmallestPixelWidth()
Cette méthode est utilisée pour obtenir la plus petite largeur de pixel affichée dans les options pour développeurs.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.getSmallestPixelWidth();
Log.d(TAG, "OK : résultat de getSmallestPixelWidth=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : getSmallestPixelWidth", e);
}
setSilentDefaultLauncher
public boolean setSilentDefaultLauncher(java.lang.String packageName)
Cette méthode est utilisée pour définir silencieusement l'application de lancement par défaut.
Paramètres
- packageName – Nom du package de l'application de lancement.
Retours
true si le lanceur par défaut est défini avec succès, false sinon.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.setSilentDefaultLauncher("packageName");
Log.d(TAG, "OK : résultat de setSilentDefaultLauncher=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setSilentDefaultLauncher", e);
}
clearAppCacheUserData
public boolean clearAppCacheUserData(java.lang.String packageNames)
Cette méthode est utilisée pour effacer le cache et les données utilisateur des applications spécifiées.
Paramètres
- packageNames – Liste séparée par des virgules des noms de paquets.
Retours
true si le cache et les données utilisateur sont effacés avec succès, false sinon.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIs SDK
Object result = sdk.clearAppCacheUserData("packageNames");
Log.d(TAG, "OK : résultat de clearAppCacheUserData=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : clearAppCacheUserData", e);
}
clearAllAppCacheUserData
public boolean clearAllAppCacheUserData(java.lang.String packageNames)
Cette méthode est utilisée pour effacer le cache et les données utilisateur de toutes les applications, sauf celles spécifiées.
Paramètres
- packageNames – Liste séparée par des virgules des noms de paquets à exclure.
Retours
true si le cache et les données utilisateur sont effacés avec succès, false sinon.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les APIsPlease report any broken links by emailing support@elotouch.com and include a link to the knowledge article