Cet article s'applique au SDK EloView Home 6.23.14. Les développeurs sont encouragés à utiliser EloView Home SDK 6.25.520 pour tous les nouveaux projets de développement et les intégrations futures.
Cliquez ici pour découvrir les nouveautés d'EloView Home SDK 6.25.520.
Cliquez ici pour le Guide de référence du SDK EloView Home 6.25.520.
EloView Home SDK 6.23.14
Plateformes prises en charge : Dispositifs Elo Android 12 et 14 y compris Backpack 4 (Standard/Value), I-Series 4 (Standard/Value), I-Series Standard, M50, M60 Pay, M100, et 7-Inch Pay.
Référence complète (Base de connaissances + SDK Javadoc)
Les API sont organisées par classe fonctionnelle (Système, Réseau, Package, etc.) pour simplifier la découverte et accélérer la mise en œuvre.
Meilleures pratiques mondiales (de la KB)
-
Toujours se lier au service avant d'appeler toute API.
Ne pas invoquer de méthodes jusqu'à ce queonServiceConnected()soit reçu. -
Supposer que la politique de l'appareil peut remplacer les réglages locaux.
Cela est particulièrement vrai pour le temps, le fuseau horaire, l'USB, le mode kiosque et l'installation d'applications. -
Utilisez NTP pour la synchronisation du temps en production.
Évitez la configuration manuelle du temps 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 d'API.
Cela est critique pour le dépannage et l'escalade.
❗ Notes importantes d'utilisation
Certaines API du 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 des politiques de l'appareil peut remplacer les réglages appliqués localement. Les développeurs doivent valider l'état du mode de l'appareil et de l'autorisation avant d'invoquer les API dans les applications de production.
Le SDK EloView Home est un SDK Android basé sur un service et exige une liaison de service réussie avant que tout appel d'API puisse être exécuté. Les méthodes peuvent retourner null ou aucun résultat si :
- Le service n'est pas encore connecté
- L'appareil n'est pas dans un état compatible avec EloView
- Des restrictions politiques bloquent l'opération
Ce guide se concentre sur les modèles pris en charge et couramment utilisés. Il ne répertorie pas chaque autorisation Android, chaque cas de bord du cycle de vie ou chaque état de retour interne documenté dans le SDK Javadoc brut. La gestion et la vérification d'erreur standard du cycle de vie des services Android doivent être mises en œuvre dans les applications de production.
Scénarios courants du monde réel (de la KB)
Scénario : Fuseau horaire incorrect après l'enregistrement 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);
Conseils : Si le fuseau horaire revient après un redémarrage, vérifiez que la zone horaire automatique Android est activée 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 administratif avant d'activer le mode kiosque en production.
Modèle de liaison de service (de la KB)
eloView.bindService(context, callback, accessToken);
// Sûr d'appeler les API SDK à l'intérieur de callback.onServiceConnected()
eloView.unbindService(context);
Note importante : bindService() et unbindService() ne retournent pas de valeurs. Les API SDK ne doivent être invoquées qu'après l'appel de onServiceConnected().
API de liaison de service / noyau
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 l'état 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().
- Basculer le Wi-Fi dans Elo QuickSettings et le mode Android Home en utilisant toggleWifi().
- Basculer 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 appeler cela avant d'invoquer les API EloView.
Paramètres
- context – Contexte dans lequel les APIs EloView sont utilisées.
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.bindService(context, callback, "accessToken");
Log.d(TAG, "OK : le 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 se dissocier du service de l'application. Utilisez cette méthode pour vous dissocier du service lors du nettoyage des ressources.
Paramètres
- context – Contexte
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.unbindService(context);
Log.d(TAG, "OK : le 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 le contenu sur l'appareil en mode EloView Control lorsque l'appareil est hors ligne ou non enregistré à un compte. Si l'appareil revient en ligne et que le contenu est défini via EloView, il remplacera 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 API SDK
Object result = sdk.setOfflinePlayContent("packageName");
Log.d(TAG, "OK : le 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 fonctionne uniquement en mode EloView Control.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.getPlayContent();
Log.d(TAG, "OK : le résultat de getPlayContent=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : getPlayContent", e);
}
getPlayContentStatus
public java.lang.String getPlayContentStatus()
Cette méthode renvoie l'état du contenu de lecture sur l'appareil en mode Control. L'état 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 API SDK
Object result = sdk.getPlayContentStatus();
Log.d(TAG, "OK : le résultat de getPlayContentStatus=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : getPlayContentStatus", e);
}
getDeviceCloudStatus
public java.lang.String getDeviceCloudStatus()
Cette méthode renvoie l'état en ligne ou hors ligne de l'appareil. L'état peut être l'une des chaînes suivantes : "En ligne", "Hors ligne", "Connexion", "Reconnaissance", "En ligne (Non provisionné)".
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.getDeviceCloudStatus();
Log.d(TAG, "OK : le 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 – Booléen pour activer ou désactiver le Wi-Fi dans QuickSettings.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.toggleWifi(true);
Log.d(TAG, "OK : le résultat de toggleWifi=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : toggleWifi", e);
}
toggleBT
public int toggleBT(boolean isEnableBT)
Cette méthode est utilisée pour basculer le Bluetooth dans QuickSettings (mode EloView). Elle peut également être utilisée pour basculer le Bluetooth en mode Android Home.
Paramètres
- isEnableBT – Booléen pour activer ou désactiver le Bluetooth dans QuickSettings.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.toggleBT(true);
Log.d(TAG, "OK : le résultat de toggleBT=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : toggleBT", e);
}
APIs des coins utilisateurs
AccountManager
La classe AccountManager fournit les opérations suivantes :
1. Fournir un jeton d'authentification depuis un EloServer basé sur les identifiants fournis par l'utilisateur (adresse email/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 d'assistance Elo.
3. Toutes les APIs 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é ou depuis un fichier local sur l'appareil, le jeton hors ligne peut être utilisé.
Par exemple, pour obtenir un jeton d'authentification :
1. Utilisez emailId et mot de passe, appelez getEloAccessToken. 2. Utilisez clientID et clé secrète, appelez getEloOAuthToken. Après une authentification réussie, ces méthodes retourneront un jeton.
Le jeton récupéré depuis le serveur ou l'équipe d'assistance est vérifié en utilisant la méthode verifyEloToken.
Désinscrivez les récepteurs de diffusion utilisés par ces APIs de AccountManager en utilisant la méthode unregisterAccountManagerListener dans les méthodes onPause et onDestroy des activités où vous utilisez ces APIs 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 API SDK
Object result = sdk.getProperty();
Log.d(TAG, "OK : le 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 API SDK
Object result = sdk.setProperty("property");
Log.d(TAG, "OK : le 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 API SDK
Object result = sdk.getClientId();
Log.d(TAG, "OK : le 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 API SDK
Object result = sdk.getBaseUri();
Log.d(TAG, "OK : le 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 API SDK
Object result = sdk.getEloAccessToken(context, "userEmail", "password", handler);
Log.d(TAG, "OK : le 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 API SDK
Object result = sdk.configureOAuthHostedUI(activity, handler);
Log.d(TAG, "OK : le résultat de configureOAuthHostedUI=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : configureOAuthHostedUI", e);
}
stopOAuth
public void stopOAuth()
Appelez stopOAuth dans la méthode de remplacement onStop() de l'activité.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.stopOAuth();
Log.d(TAG, "OK : le résultat de stopOAuth=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : stopOAuth", e);
}
destroyOAuth
public void destroyOAuth()
Appelez destroyOAuth dans la méthode de remplacement onStop() de l'activité.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.destroyOAuth();
Log.d(TAG, "OK : le 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 API SDK
Object result = sdk.logoutOAuth();
Log.d(TAG, "OK : le 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é. Lors de la 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 API SDK
Object result = sdk.verifyEloToken(context, "accessToken", handler);
Log.d(TAG, "OK : le 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 jeton OAuth au portail EloView. Après une authentification réussie, un jeton sera envoyé à l'appareil. Ce jeton est valable à utiliser pendant 24 heures après son émission. Lorsque le jeton expire, toute tentative de vérification du jeton et d'appel d'API obtiendra la réponse TOKEN_VERIFY_FAIL. Il en va de même si un jeton n'a jamais été obtenu ou reçu.
Si elle réussit, le gestionnaire recevra un message de type OAUTH_TOKEN_VALID avec un jeton JWT en réponse. Voici un exemple de réponse réussie :
"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IlJQTSJ9.eyJ1ZW1haWwiOiJwcmF0YXBlbG8rUHJvZEBnbWFpbC5jb20iLCJvdGl0bGUiOiJwcmF0YXBlbG8rUHJvZEBnbWFpbC5jb20iLCJjYXAiOnsiY3JjIjoiSDIvb2RnIiwicGVybSI6ImZmZmZmZmYwMCJ9LCJpYXQiOjE1MjUxMTc4NDgsIm5iZiI6MTUyNTExNzg0OCwiZXhwIjoxNTI1MjA0MjQ4LCJpc3MiOiIxNTAyIiwic3ViIjoiZWVhNDRkY2JkMjU5YzQyOWY4NTA3YWZhNTQyY2Q3M2YiLCJqdGkiOiJ2ZE14N1ppUGVnWT0ifQ.b2e-F1mVh0ummkBJk3m8pT2qSCceRxuS_A9GAKtYBeo"
En cas d'échec d'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 API SDK
Object result = sdk.getEloOAuthToken(context, "clientID", "secret", handler);
Log.d(TAG, "OK : le 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ésinscrire le récepteur de diffusion enregistré lors de l'utilisation de n'importe laquelle des APIs de AccountManager. Veuillez vous assurer de l'appeler dans les méthodes onPause et onDestroy de votre cycle de vie d'activité si vous avez utilisé l'une des APIs de AccountManager. Cela garantit que le récepteur n'est pas fuité.
Paramètres
- context – Contexte dans lequel les APIs de l'AccountManager ont été utilisées.
- context – Contexte Android utilisé pour désinscrire le récepteur du gestionnaire de comptes.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.unregisterAccountManagerListener(context);
Log.d(TAG, "OK : le 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 API SDK
Object result = sdk.setDefaultEnvironment(context);
Log.d(TAG, "OK : le 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 API SDK
Object result = sdk.selectEnvironment(context, "prop", true);
Log.d(TAG, "OK : le 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 API SDK
Object result = sdk.isPolarisLocked(context);
Log.d(TAG, "OK : le 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 API SDK
Object result = sdk.getEnvironment(context);
Log.d(TAG, "OK : le 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 API SDK
Object result = sdk.isPolaris(context);
Log.d(TAG, "OK : le 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, lors d'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 du 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 API SDK
Object result = sdk.onServiceConnected();
Log.d(TAG, "OK : le 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 dissocié en utilisant unbindService.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.onServiceDisconnected();
Log.d(TAG, "OK : le 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 :
-
Obtenez un jeton d'authentification en utilisant
getEloAccessToken. -
Capturez 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. -
Obtenez l'orientation de l'appareil en utilisant
getOrientation. -
Réinitialisez l'appareil en utilisant
factoryReset. -
Redémarrez l'appareil silencieusement en utilisant
silentReboot. -
Activez ou désactivez la barre de navigation en utilisant
setNavigationBarEnabled. -
Activez ou désactivez la barre d'état en utilisant
setStatusBarEnabled. -
Accordez toutes les autorisations d'exécution en utilisant
setGrantAllAppPermissionEnabled. -
Obtenez l'état de la barre de navigation en utilisant
getNavigationBarEnabled. -
Obtenez l'état de la barre d'état en utilisant
getStatusBarEnabled. -
Obtenez l'état de l'accès à la permission de toutes les applications en utilisant
getGrantAllAppPermissionEnabled. -
Définissez et obtenez le délai de rétroéclairage en utilisant
setBacklightTimeOutetgetBacklightTimeOut. -
Définissez et changez le mot de passe de l'écran de verrouillage en utilisant
setLockScreenPasswordetchangeLockScreenPassword. -
Activez automatiquement les autorisations USB en utilisant
autoAllowUSBPermission. -
Verrouillez ou déverrouillez le firmware du processeur sécurisé en utilisant
setFirmwareStatusLockEnabled. -
Définissez et changez le code PIN de l'appareil en utilisant
setLockScreenPinetchangeLockScreenPin. -
Activez ou désactivez le WiFi en utilisant
setWifiEnabledet obtenez l'état en utilisantgetWifiEnabled. -
Effacez le cache et les données des applications en utilisant
clearAllAppCacheUserDataetclearAppCacheUserData. -
Activez ADB en utilisant
setAdbEnabledet configurez le port personnalisé en utilisantcustomPortAdb. -
Activez ou désactivez le bouton Accueil en utilisant
setHomeButtonEnabled. -
Activez ou désactivez le bouton d'alimentation en utilisant
setPowerButtonEnabled. -
Activez ou désactivez le menu d'assistance de l'éditeur de texte en utilisant
setTextEditorAssistMenuEnabled. -
Activez ou désactivez le panneau de volume "Afficher plus" en utilisant
setVolumePanelShowMoreEnabled. -
Activez ou désactivez le scanner de codes-barres Zebra en utilisant
setBarcodeReaderEnabled. -
Déclenchez une numérisation de code-barres en utilisant
setScanBarcodeReaderEnabled. -
Activez ou désactivez l'enregistrement Elo en utilisant
setEloLoggingEnabled. -
Activez ou désactivez l'adresse MAC WiFi aléatoire en utilisant
setRandomWifiMacAddressEnabled. -
Activez ou désactivez l'accès WebView du périphérique Star en utilisant
setStarPeripheralConnectEnabled. -
Vérifiez l'état d'auto-autorisation USB en utilisant
getAutoAllowUSBPermission. -
Définissez, supprimez et interrogez le propriétaire de l'appareil en utilisant
setDeviceOwner,removeDeviceOwner, etgetDeviceOwnerStatus. -
Définissez et obtenez DPI d'affichage en utilisant
setDpietgetDpi. -
Définissez et obtenez la langue en utilisant
setLanguageetgetLanguage. -
Définissez et obtenez le type de verrouillage en utilisant
setLockTypeetgetLockType. -
Activez ou désactivez l'IME Client Multiclient en utilisant
setMultiClientImeEnabledetgetMultiClientImeEnabled. -
Définissez et obtenez le serveur NTP en utilisant
setNtpServerUrletgetNtpServerUrl. -
Définissez et obtenez l'intervalle de sondage NTP en utilisant
setNtpPollIntervaletgetNtpPollInterval. -
Contrôlez les autorisations d'installation en utilisant
setInstallPermissionToSpecificApp,setInstallAllAppPermissionEnabled, etgetInstallPermissionToSpecificApp. -
Définissez et obtenez la taille de l'écran en utilisant
setScreenSizeetgetScreenSize. -
Définissez et obtenez la plus petite largeur de pixel en utilisant
setSmallestPixelWidthetgetSmallestPixelWidth. -
Définissez et obtenez le fuseau horaire en utilisant
setTimeZoneetgetTimeZone. -
Activez ou désactivez les services d'accessibilité en utilisant
setAccessibilityService. -
Activez ou désactivez la date et l'heure automatiques en utilisant
setAutoDateTimeEnabled. -
Activez ou désactivez la confirmation de couplage Bluetooth en utilisant
setBluetoothDevicePairingConfirmationEnabled. -
Définissez la date et l'heure en utilisant
setDateTime. -
Définissez la taille d'affichage en utilisant
setDisplaySize. -
Configurez WiFi en utilisant CSV avec
setEloNetworkConf. -
Définissez la taille de la police en utilisant
setFontSize. -
Activez ou désactivez le mode Idle en utilisant
setIdleModeEnabled. -
Activez ou désactivez la localisation en utilisant
setLocationEnabled. -
Coupez ou réactivez le microphone en utilisant
setMicrophoneMuteEnabled. -
Activez ou désactivez la visibilité du mot de passe en utilisant
setPasswordEnabled. -
Activez ou désactivez Play Protect en utilisant
setPlayProtect. -
Définissez et obtenez l'espace réservé aux journaux en utilisant
setReservedLogSpaceetgetReservedLogSpace. -
Définissez le format de temps en utilisant
setTimeFormatEnabled. -
Activez ou désactivez les sons tactiles en utilisant
setTouchSoundEnabled. -
Définissez les niveaux de volume en utilisant
setVolumeLevel. -
Activez ou désactivez le menu de partage de sélection de texte en utilisant
setShowTextEditorShareMenuEnabled. -
Éteignez silencieusement l'appareil en utilisant
silentShutDown. -
Définissez le lanceur par défaut en utilisant
setSilentDefaultLauncher. -
Obtenez le statut de verrouillage du firmware en utilisant
getFirmwareStatusLockEnabled. -
Mettez à niveau le firmware du processeur sécurisé en utilisant
spFirmwareUpgrade. -
Démarrez une activité depuis un service d'arrière-plan en utilisant
startActivityFromForegroundService. -
Activez ou désactivez le mode sombre en utilisant
setDarkModeEnabled. -
Réveillez l'écran en utilisant
wakeupScreen. -
Activez ou désactivez le son et la vibration de charge en utilisant
setChargingSoundAndVibrationEnabled. -
Activez ou désactivez le son de verrouillage d'écran en utilisant
setScreenLockSoundEnabled. -
Activez ou désactivez la tuile de mode Idle en utilisant
setIdleModeTileEnabled. -
Obtenez et définissez le nom d'hôte en utilisant
getHostNameetsetHostName. -
Activez ou désactivez l'accessibilité du point d'accès en utilisant
setHotspotAccessibilityEnabledetgetHotspotAccessibilityEnabled. -
Obtenez la somme de contrôle MD5 en utilisant
getMD5Checksum. -
Liez et déliez 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.
Retourne
L'orientation de l'appareil, par exemple portrait ou paysage.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.isM60Device();
Log.d(TAG, "OK : le 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.
Retourne
L'orientation de l'appareil, par exemple portrait ou paysage.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.isM50Device();
Log.d(TAG, "OK : le 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.
Retourne
L'orientation de l'appareil, par exemple portrait ou paysage.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.isM100Device();
Log.d(TAG, "OK : le 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.
Retourne
L'orientation de l'appareil, par exemple portrait ou paysage.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.is7PayDevice();
Log.d(TAG, "OK : le 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.
Retourne
L'orientation de l'appareil, par exemple portrait ou paysage.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.isM51Device();
Log.d(TAG, "OK : le 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 API SDK
Object result = sdk.bindService(context, callback, "accessToken");
Log.d(TAG, "OK : le 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 se dissocier du service de l'application. Utilisez cette méthode pour vous dissocier du service lorsque vous nettoyez les ressources.
Paramètres
- context – Contexte de l'application
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.unbindService(context);
Log.d(TAG, "OK : le 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 capturer une capture d'écran. La capture d'écran sera stockée dans 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".
Retourne
true si la capture d'écran est réussie, false sinon.
Exemple
try {
// TODO : assurez-vous que le service est lié avant d'appeler les API SDK
Object result = sdk.captureScreenShot("fileName");
Log.d(TAG, "OK : le 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 API SDK
Object result = sdk.setAccessibilityService("packageName", true);
Log.d(TAG, "OK : le résultat de setAccessibilityService=" + result);
} catch (Exception e) {
Log.e(TAG, "ÉCHEC : setAccessibilityService", e);
}
Please report any broken links by emailing support@elotouch.com and include a link to the knowledge article