Эта статья относится к EloView Home SDK 6.23.14. Разработчиков призывают использовать EloView Home SDK 6.25.520 для всех новых разработок и будущих интеграций.
Нажмите здесь, чтобы узнать, что нового в EloView Home SDK 6.25.520.
Нажмите здесь, чтобы получить справочное руководство по EloView Home SDK 6.25.520.
EloView Home SDK 6.23.14
Поддерживаемые платформы: Android 12 и Android 14 устройства Elo, включая Backpack 4 (Standard/Value), I-Series 4 (Standard/Value), I-Series Standard, M50, M60 Pay, M100 и 7-Inch Pay.
Полное руководство (База знаний + SDK Javadoc)
API организованы по функциональным классам (Система, Сеть, Пакет и т. д.), чтобы упростить обнаружение и ускорить внедрение.
Глобальные лучшие практики (из БЗ)
-
Всегда привязывайтесь к службе перед вызовом любого API.
Не вызывайте методы, покаonServiceConnected()не будет получен. -
Предположите, что политика устройства может переопределять локальные настройки.
Это особенно верно для времени, часового пояса, USB, киоска и установки приложений. -
Используйте NTP для синхронизации времени в производственных условиях.
Избегайте ручной настройки времени, кроме как для тестирования. -
Понять поведение сброса.
-
Сброс для предприятия очищает конфигурацию Elo и состояние регистрации.
-
Сброс до заводских настроек удаляет все пользовательские данные и возвращает устройство в состояние «из коробки».
-
-
Записывайте результат каждого вызова API.
Это критично для устранения неполадок и эскалации.
❗ Важные примечания по использованию
Некоторые API SDK требуют специфических разрешений Android и могут поведать себя по-разному в зависимости от того, находится ли устройство в режиме EloView или в режиме Android Home. Принуждение политики устройства может переопределить локально примененные настройки. Разработчики должны проверить режим устройства и состояние разрешений перед вызовом API в производственных приложениях.
EloView Home SDK это служебный Android SDK и требует успешного привязывания службы перед выполнением любых вызовов API. Методы могут вернуть null или не иметь результата, если:
- Служба еще не подключена
- Устройство не находится в совместимом состоянии EloView
- Политические ограничения блокируют операцию
Это руководство сосредоточено на поддерживаемых и часто используемых шаблонах. Оно не перечисляет каждое разрешение Android, крайний случай жизни или внутреннее возвращаемое состояние, документированное в простом SDK Javadoc. Стандартная обработка жизненного цикла службы Android и проверка ошибок должны быть реализованы в производственных приложениях.
Распространенные сценарии из реальной практики (из БЗ)
Сценарий: Неправильный часовой пояс после регистрации устройства
system.setNtpEnabled(true);
system.setNtpServer("time.aws.com");
system.setTimeZone("US/Central");
system.syncTimeNow();
// Подтвердите
String tz = system.getTimeZone();
Log.d(TAG, "Timezone=" + tz);
Совет: Если часовой пояс возвращается после перезагрузки, проверьте, включена ли автоматическая настройка часового пояса Android и то, что политическая политика не переопределяет другой регион.
Сценарий: Безопасно настроить киоск с единственным приложением
pkg.setKioskApp("com.example.kiosk");
pkg.setKioskModeEnabled(true);
pkg.launchApp("com.example.kiosk");
Предупреждение: Всегда проверяйте административный путь обхода перед включением режима киоска в производственной среде.
Шаблон привязки службы (из БЗ)
eloView.bindService(context, callback, accessToken);
// Безопасно вызывать API SDK внутри callback.onServiceConnected()
eloView.unbindService(context);
Важно: bindService() и unbindService() не возвращают значения. API SDK должны вызываться только после вызова onServiceConnected().
Основные / API привязки службы
EloView
Класс EloView предоставляет следующие операции:
- Установите контент, который будет воспроизводиться на устройстве в режиме EloView Control, когда устройство не подключено к сети или не зарегистрировано в учетной записи, с помощью setOfflinePlayContent().
- Получите тип содержимого (APK или WebView) и имя содержимого, которое в настоящее время установлено в режиме EloView Control, используя getPlayContent().
- Получите текущий статус воспроизведения сконфигурированного контента в режиме EloView Control с помощью getPlayContentStatus().
- Проверьте, подключено ли устройство в данный момент к облаку EloView (онлайн или офлайн) с помощью getDeviceCloudStatus().
- Переключите Wi-Fi в настройках QuickSettings Elo и Android Home Mode с помощью toggleWifi().
- Переключите Bluetooth в настройках QuickSettings Elo и Android Home Mode с помощью toggleBT().
bindService
public void bindService(android.content.Context context, ServiceConnectionCallback callback, java.lang.String accessToken)
Этот метод связывает службу EloView с приложением. Вы должны вызвать этот метод перед вызовом любых API EloView.
Параметры
- context – Контекст, в котором используются API EloView.
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.bindService(context, callback, "accessToken");
Log.d(TAG, "OK: bindService result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: bindService", e);
}
unbindService
public void unbindService(android.content.Context context)
Этот метод используется для отвязки службы от приложения. Используйте этот метод для отвязки службы от приложения при очистке ресурсов.
Параметры
- context – Контекст
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.unbindService(context);
Log.d(TAG, "OK: unbindService result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: unbindService", e);
}
setOfflinePlayContent
public java.lang.String setOfflinePlayContent(java.lang.String packageName)
Этот метод используется для установки контента на устройстве в режиме EloView Control когда устройство находится в оффлайне или не зарегистрировано в учетной записи. Если устройство выходит в онлайн режим и содержимое устанавливается через EloView, оно переопределит содержимое, установленное через этот API.
Параметры
- packageName – Пакет, который будет установлен в качестве содержимого по умолчанию на устройстве.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.setOfflinePlayContent("packageName");
Log.d(TAG, "OK: setOfflinePlayContent result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setOfflinePlayContent", e);
}
getPlayContent
public java.lang.String getPlayContent()
Этот метод возвращает тип содержимого и имя содержимого, установленного на устройстве. Этот метод работает только в режиме управления EloView.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.getPlayContent();
Log.d(TAG, "OK: getPlayContent result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getPlayContent", e);
}
getPlayContentStatus
public java.lang.String getPlayContentStatus()
Этот метод возвращает статус воспроизведения содержимого на устройстве в режиме управления. Статус может быть одной из следующих строк:
YET_TO_DOWNLOAD, DOWNLOADING, DOWNLOADED, INSTALLING, INSTALLED, DOWNLOAD_FAILED, INSTALL_FAILED, UNKNOWN_STATUS
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.getPlayContentStatus();
Log.d(TAG, "OK: getPlayContentStatus result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getPlayContentStatus", e);
}
getDeviceCloudStatus
public java.lang.String getDeviceCloudStatus()
Этот метод возвращает состояние устройства в облаке – онлайн или оффлайн. Статус может быть одной из следующих строк: "Online", "Offline", "Connecting", "Reconnecting", "Online (Not Provisioned)".
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.getDeviceCloudStatus();
Log.d(TAG, "OK: getDeviceCloudStatus result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getDeviceCloudStatus", e);
}
toggleWifi
void toggleWifi(boolean isEnableWifi)
Включает или отключает Wi-Fi на устройстве. Это применимо как в режиме EloView, так и в режиме Android Home.
Параметры
- isEnableWifi – Булевый параметр для включения или отключения Wi-Fi в настройках QuickSettings.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.toggleWifi(true);
Log.d(TAG, "OK: toggleWifi result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: toggleWifi", e);
}
switchToAndroidHomeMode
void switchToAndroidHomeMode() void switchToAndroidHomeMode(boolean isRebootNeeded, boolean isAndroidHomeMode)
Этот метод используется для переключения на режим Android Home из режима EloView. Это то же самое, что switchToAndroidHomeMode(), за исключением того, что он принимает два булевых параметра. Вернуться к режиму EloView нельзя без сброса до заводских настроек, поэтому используйте с осторожностью.
Параметры
- Переключает устройство с режима EloView на режим Android Home.
- Если isRebootNeeded установлен в true, устройство перезагрузится, чтобы применить изменение режима.
- Важное примечание: переключение в режим Android Home может отключить ограничения и политики, управляемые EloView.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.switchToAndroidHomeMode(true, true);
Log.d(TAG, "OK: switchToAndroidHomeMode result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: switchToAndroidHomeMode", e);
}
toggleBT
public int toggleBT(boolean isEnableBT)
Этот метод используется для переключения Bluetooth в QuickSettings (режим EloView). Его также можно использовать для переключения Bluetooth в режиме Android Home.
Параметры
- isEnableBT – Булевый параметр для включения или отключения Bluetooth в QuickSettings.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.toggleBT(true);
Log.d(TAG, "OK: toggleBT result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: toggleBT", e);
}
Account APIs
AccountManager
Класс AccountManager предоставляет следующие операции:
1. Предоставить токен аутентификации от EloServer на основе учетных данных, предоставленных пользователем (emailId/parol или clientId/secretKey).
2. Проверьте, действителен ли данный токен аутентификации или истек. Токен аутентификации может быть как токен, полученный с сервера EloView, так и оффлайн JWT токен, предоставленный командой поддержки Elo (Оффлайн токен создается с использованием имени пакета вашего приложения и может использоваться только с пакетом, для которого он был сгенерирован).
3. Все API требуют оффлайн токен для работы и не будут работать с онлайн токеном. Единственное исключение - OTA API. OTA API требуют онлайн токен при применении OTA с сервера EloView. При применении OTA через пользовательский URL сервера или из локального файла на устройстве может быть использован оффлайн токен.
Для примера получения токена аутентификации:
1. Используя emailId и пароль, вызовите getEloAccessToken. 2. Используя clientId и secretKey, вызовите getEloOAuthToken. При успешной аутентификации эти методы вернут токен. 3. Для оффлайн JWT токена свяжитесь с командой поддержки Elo.
Токен, полученный с сервера или команды поддержки, проверяется с помощью метода verifyEloToken.
Отмените регистрацию широковещательных приема, используемых этими API AccountManager, с помощью метода unregisterAccountManagerListener в методах onPause и onDestroy активностей, в которых вы используете эти API, чтобы избежать утечек.
getProperty
public static java.lang.String getProperty()
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.getProperty();
Log.d(TAG, "OK: getProperty result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getProperty", e);
}
setProperty
public void setProperty(java.lang.String property)
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.setProperty("property");
Log.d(TAG, "OK: setProperty result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setProperty", e);
}
getClientId
public static java.lang.String getClientId()
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.getClientId();
Log.d(TAG, "OK: getClientId result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getClientId", e);
}
getBaseUri
public static android.net.Uri getBaseUri()
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.getBaseUri();
Log.d(TAG, "OK: getBaseUri result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getBaseUri", e);
}
getEloAccessToken
public void getEloAccessToken(android.content.Context context, java.lang.String userEmail, java.lang.String password, android.os.Handler handler)
Этот метод используется для получения токена доступа от сервера Elo.
Параметры
- context – Объект контекста вызываемого класса (Activity или Service).
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.getEloAccessToken(context, "userEmail", "password", handler);
Log.d(TAG, "OK: getEloAccessToken result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getEloAccessToken", e);
}
configureOAuthHostedUI
public void configureOAuthHostedUI(android.app.Activity activity, android.os.Handler handler)
Этот метод используется для инициализации интерфейса OAuth Hosted UI.
Параметры
- activity – Экземпляр Activity вызываемого класса.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.configureOAuthHostedUI(activity, handler);
Log.d(TAG, "OK: configureOAuthHostedUI result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: configureOAuthHostedUI", e);
}
stopOAuth
public void stopOAuth()
Вызовите stopOAuth в переопределенном методе onStop() активности.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.stopOAuth();
Log.d(TAG, "OK: stopOAuth result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: stopOAuth", e);
}
destroyOAuth
public void destroyOAuth()
Вызовите destroyOAuth в переопределенном методе onStop() активности.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.destroyOAuth();
Log.d(TAG, "OK: destroyOAuth result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: destroyOAuth", e);
}
logoutOAuth
public void logoutOAuth()
Вызовите logoutOAuth, чтобы завершить текущую сессию входа.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.logoutOAuth();
Log.d(TAG, "OK: logoutOAuth result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: logoutOAuth", e);
}
verifyEloToken
public void verifyEloToken(android.content.Context context, java.lang.String accessToken, android.os.Handler handler)
Эта функция запрашивает у сервера Elo проверку данного токена. При успешной проверке обработчик получит сообщение типа TOKEN_VERIFY_SUCCESS. В случае ошибки будет получено TOKEN_VERIFY_FAIL.
Параметры
- context – Объект контекста вызываемого класса (Activity или Service).
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.verifyEloToken(context, "accessToken", handler);
Log.d(TAG, "OK: verifyEloToken result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: verifyEloToken", e);
}
getEloOAuthToken
public void getEloOAuthToken(android.content.Context context, java.lang.String clientID, java.lang.String secret, android.os.Handler handler)
Этот метод используется для запроса нового токена OAuth у портала EloView. После успешной аутентификации токен будет отправлен на устройство. Этот токен действителен в течение 24 часов после его выдачи. По истечении срока действия токена дальнейшие попытки проверить токен и вызвать API вернут ответ TOKEN_VERIFY_FAIL. То же самое касается случая, если токен никогда не был получен или получен.
Если успешно, обработчик получит сообщение типа OAUTH_TOKEN_VALID с JWT токеном в качестве ответа. Ниже приведен пример успешного ответа:
"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IlJQTSJ9.eyJ1ZW1haWwiOiJwcmF0YXBlbG8rUHJvZEBnbWFpbC5jb20iLCJvdGl0bGUiOiJwcmF0YXBlbG8rUHJvZEBnbWFpbC5jb20iLCJjYXAiOnsiY3JjIjoiSDIvb2RnIiwicGVybSI6ImZmZmZmZmYwMCJ9LCJpYXQiOjE1MjUxMTc4NDgsIm5iZiI6MTUyNTExNzg0OCwiZXhwIjoxNTI1MjA0MjQ4LCJpc3MiOiIxNTAyIiwic3ViIjoiZWVhNDRkY2JkMjU5YzQyOWY4NTA3YWZhNTQyY2Q3M2YiLCJqdGkiOiJ2ZE14N1ppUGVnWT0ifQ.b2e-F1mVh0ummkBJk3m8pT2qSCceRxuS_A9GAKtYBeo"
В случае ошибки аутентификации из-за неверного clientID или secretID обработчик получит сообщение типа OAUTH_TOKEN_INVALID.
Параметры
- context – Объект контекста вызываемого класса (Activity или Service).
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.getEloOAuthToken(context, "clientID", "secret", handler);
Log.d(TAG, "OK: getEloOAuthToken result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getEloOAuthToken", e);
}
unregisterAccountManagerListener
public void unregisterAccountManagerListener(android.content.Context context)
Этот метод используется для отмены регистрации широковещательного приема, зарегистрированного при использовании любого из API AccountManager. Пожалуйста, убедитесь, что вы вызываете это в методах onPause и onDestroy в вашем жизненном цикле активности, если вы использовали любой из API AccountManager. Это гарантирует отсутствие утечек.
Параметры
- context – Контекст, в котором использовались системные API.
- context – Контекст Android, используемый для отмены регистрации слушателя менеджера учетных записей.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.unregisterAccountManagerListener(context);
Log.d(TAG, "OK: unregisterAccountManagerListener result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: unregisterAccountManagerListener", e);
}
setDefaultEnvironment
public void setDefaultEnvironment(android.content.Context ctx)
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.setDefaultEnvironment(context);
Log.d(TAG, "OK: setDefaultEnvironment result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setDefaultEnvironment", e);
}
selectEnvironment
public void selectEnvironment(android.content.Context ctx, java.lang.String prop, boolean isSealed)
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.selectEnvironment(context, "prop", true);
Log.d(TAG, "OK: selectEnvironment result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: selectEnvironment", e);
}
isPolarisLocked
public boolean isPolarisLocked(android.content.Context context)
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.isPolarisLocked(context);
Log.d(TAG, "OK: isPolarisLocked result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: isPolarisLocked", e);
}
getEnvironment
public java.lang.String getEnvironment(android.content.Context ctx)
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.getEnvironment(context);
Log.d(TAG, "OK: getEnvironment result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getEnvironment", e);
}
isPolaris
public boolean isPolaris(android.content.Context context)
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.isPolaris(context);
Log.d(TAG, "OK: isPolaris result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: isPolaris", e);
}
TokenListener
TokenListener прослушивает события верификации AuthenticationToken и, при действительном токене, предоставляет успешный ответ для выполнения дальнейших операций.
Методы для этого типа не задокументированы.
Системные API
ServiceConnectionCallback
onServiceConnected
void onServiceConnected()
Этот метод вызывается, когда служба подключена после вызова bindService.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.onServiceConnected();
Log.d(TAG, "OK: onServiceConnected result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: onServiceConnected", e);
}
onServiceDisconnected
void onServiceDisconnected()
Этот метод вызывается, когда служба отключена. Это не будет вызвано, если служба была отвязана с помощью unbindService.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.onServiceDisconnected();
Log.d(TAG, "OK: onServiceDisconnected result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: onServiceDisconnected", e);
}
Система
Класс Система предоставляет следующие операции:
-
Получите токен аутентификации с помощью
getEloAccessToken. -
Захватите скриншот устройства с помощью
captureScreenShot. -
Установите ориентацию устройства (портретная, ландшафтная, реверсная портретная, реверсная ландшафтная) с помощью
setOrientation. -
Получите ориентацию устройства с помощью
getOrientation. -
Выполните сброс устройства до заводских настроек с помощью
factoryReset. -
Перезагрузите устройство без звука с помощью
silentReboot. -
Включите или отключите навигационную панель с помощью
setNavigationBarEnabled. -
Включите или отключите строку состояния с помощью
setStatusBarEnabled. -
Предоставьте все разрешения во время выполнения с помощью
setGrantAllAppPermissionEnabled. -
Получите статус строки навигации с помощью
getNavigationBarEnabled. -
Получите статус строки состояния с помощью
getStatusBarEnabled. -
Получите статус разрешений «Предоставить все разрешения приложения» с помощью
getGrantAllAppPermissionEnabled. -
Установите и получите время подсветки с помощью
setBacklightTimeOutиgetBacklightTimeOut. -
Установите и измените пароль экрана блокировки с помощью
setLockScreenPasswordиchangeLockScreenPassword. -
Автоматически разрешайте USB-разрешения с помощью
autoAllowUSBPermission. -
Заблокируйте или разблокируйте прошивку безопасного процессора с помощью
setFirmwareStatusLockEnabled. -
Установите и измените PIN-код устройства с помощью
setLockScreenPinиchangeLockScreenPin. -
Включите или отключите WiFi с помощью
setWifiEnabledи получите статус с помощьюgetWifiEnabled. -
Очистите кеш и данные приложений с помощью
clearAllAppCacheUserDataиclearAppCacheUserData. -
Включите ADB с помощью
setAdbEnabledи настройте пользовательский порт с помощьюcustomPortAdb. -
Включите или отключите кнопку «Домой» с помощью
setHomeButtonEnabled. -
Включите или отключите кнопку питания с помощью
setPowerButtonEnabled. -
Включите или отключите меню помощи редактора текста с помощью
setTextEditorAssistMenuEnabled. -
Включите или отключите панель громкости «Показать больше» с помощью
setVolumePanelShowMoreEnabled. -
Включите или отключите сканер штрих-кодов Zebra с помощью
setBarcodeReaderEnabled. -
Запустите сканирование штрих-кода с помощью
setScanBarcodeReaderEnabled. -
Включите или отключите ведение журнала Elo с помощью
setEloLoggingEnabled. -
Включите или отключите случайный WiFi MAC-адрес с помощью
setRandomWifiMacAddressEnabled. -
Включите или отключите доступ веб-доступа Star-принтеров с помощью
setStarPeripheralConnectEnabled. -
Проверьте статус автоматического разрешения USB с помощью
getAutoAllowUSBPermission. -
Установите, удалите и запросите владельца устройства с помощью
setDeviceOwner,removeDeviceOwnerиgetDeviceOwnerStatus. -
Установите и получите разрешение дисплея с помощью
setDpiиgetDpi. -
Установите и получите язык с помощью
setLanguageиgetLanguage. -
Установите и получите тип блокировки с помощью
setLockTypeиgetLockType. -
Включите или отключите Multi Client IME с помощью
setMultiClientImeEnabledиgetMultiClientImeEnabled. -
Установите и получите сервер NTP с помощью
setNtpServerUrlиgetNtpServerUrl. -
Установите и получите интервал опроса NTP с помощью
setNtpPollIntervalиgetNtpPollInterval. -
Установите настройки установки с помощью
setInstallPermissionToSpecificApp,setInstallAllAppPermissionEnabledиgetInstallPermissionToSpecificApp. -
Установите и получите размер экрана с помощью
setScreenSizeиgetScreenSize. -
Установите и получите наименьшую ширину пикселя с помощью
setSmallestPixelWidthиgetSmallestPixelWidth. -
Установите и получите часовой пояс с помощью
setTimeZoneиgetTimeZone. -
Включите или отключите службы доступности с помощью
setAccessibilityService. -
Включите или отключите автоматическую дату и время с помощью
setAutoDateTimeEnabled. -
Включите или отключите подтверждение парировки Bluetooth с помощью
setBluetoothDevicePairingConfirmationEnabled. -
Установите дату и время с помощью
setDateTime. -
Установите размер дисплея с помощью
setDisplaySize. -
Настройте WiFi через CSV с помощью
setEloNetworkConf. -
Установите размер шрифта с помощью
setFontSize. -
Включите или отключите режим простоя с помощью
setIdleModeEnabled. -
Включите или отключите местоположение с помощью
setLocationEnabled. -
Включите или отключите микрофон с помощью
setMicrophoneMuteEnabled. -
Включите или отключите видимость пароля с помощью
setPasswordEnabled. -
Включите или отключите Play Protect с помощью
setPlayProtect. -
Установите и получите резервное пространство журнала с помощью
setReservedLogSpaceиgetReservedLogSpace. -
Установите формат времени с помощью
setTimeFormatEnabled. -
Включите или отключите звуки нажатий с помощью
setTouchSoundEnabled. -
Установите уровни громкости с помощью
setVolumeLevel. -
Включите или отключите меню общего доступа для выбора текста с помощью
setShowTextEditorShareMenuEnabled. -
Выключите устройство без звука с помощью
silentShutDown. -
Установите лаунчер по умолчанию с помощью
setSilentDefaultLauncher. -
Получите статус блокировки прошивки с помощью
getFirmwareStatusLockEnabled. -
Обновите прошивку защищенного процессора с помощью
spFirmwareUpgrade. -
Запустите действие от переднего плана с помощью
startActivityFromForegroundService. -
Включите или отключите темный режим с помощью
setDarkModeEnabled. -
Разбудите экран с помощью
wakeupScreen. -
Включите или отключите звук и вибрацию при зарядке с помощью
setChargingSoundAndVibrationEnabled. -
Включите или отключите звук блокировки экрана с помощью
setScreenLockSoundEnabled. -
Включите или отключите плитку режима простоя с помощью
setIdleModeTileEnabled. -
Получите и установите имя хоста с помощью
getHostNameиsetHostName. -
Включите или отключите доступ к хотспоту с помощью
setHotspotAccessibilityEnabledиgetHotspotAccessibilityEnabled. -
Получите контрольный код MD5 с помощью
getMD5Checksum. -
Свяжите и отвяжите системную службу с помощью
bindServiceиunbindService.
isM60Device
public static boolean isM60Device()
Этот метод используется для получения ориентации устройства.
Возвращает
Ориентация устройства, например портретная или ландшафтная.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.isM60Device();
Log.d(TAG, "OK: isM60Device result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: isM60Device", e);
}
isM50Device
public static boolean isM50Device()
Этот метод используется для получения ориентации устройства.
Возвращает
Ориентация устройства, например портретная или ландшафтная.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.isM50Device();
Log.d(TAG, "OK: isM50Device result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: isM50Device", e);
}
isM100Device
public static boolean isM100Device()
Этот метод используется для получения ориентации устройства.
Возвращает
Ориентация устройства, например портретная или ландшафтная.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.isM100Device();
Log.d(TAG, "OK: isM100Device result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: isM100Device", e);
}
is7PayDevice
public static boolean is7PayDevice()
Этот метод используется для получения ориентации устройства.
Возвращает
Ориентация устройства, например портретная или ландшафтная.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.is7PayDevice();
Log.d(TAG, "OK: is7PayDevice result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: is7PayDevice", e);
}
isM51Device
public boolean isM51Device()
Этот метод используется для получения ориентации устройства.
Возвращает
Ориентация устройства, например портретная или ландшафтная.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.isM51Device();
Log.d(TAG, "OK: isM51Device result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: isM51Device", e);
}
bindService
public void bindService(android.content.Context context, ServiceConnectionCallback callback, java.lang.String accessToken)
Этот метод используется для привязки службы, чтобы получить доступ к системным API. Используйте этот метод, чтобы привязать службу перед использованием системных API.
Параметры
- context – Контекст приложения
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.bindService(context, callback, "accessToken");
Log.d(TAG, "OK: bindService result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: bindService", e);
}
unbindService
public void unbindService(android.content.Context context)
Этот метод используется для отвязки службы от приложения. Используйте этот метод, чтобы отвязать службу от приложения при очистке ресурсов.
Параметры
- context – Контекст приложения
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.unbindService(context);
Log.d(TAG, "OK: unbindService result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: unbindService", e);
}
captureScreenShot
public boolean captureScreenShot(java.lang.String fileName)
Этот метод используется для захвата скриншота. Скриншот будет сохранен в расположении "/sdcard/elo/screenshot", и возвращаемое сообщение также содержит путь к скриншоту.
Параметры
- fileName – Имя файла в формате PNG, например "screenshot.png".
Возвращает
true, если скриншот успешно захвачен, в противном случае false.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.captureScreenShot("fileName");
Log.d(TAG, "OK: captureScreenShot result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: captureScreenShot", e);
}
setAccessibilityService
public void setAccessibilityService(java.lang.String packageName, boolean enableAccessibilityService)
Этот метод используется для включения или отключения доступных услуг.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.setAccessibilityService("packageName", true);
Log.d(TAG, "OK: setAccessibilityService result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setAccessibilityService", e);
}
setMultiClientImeEnabled
public boolean setMultiClientImeEnabled(boolean enable, boolean reboot)
Этот метод используется для включения или отключения многопользовательского IME. После применения устройство перезагрузится, чтобы отобразить изменения.
Параметры
- enable – Включить или отключить функцию.
Пример
try {
// TODO: убедитесь, что служба привязана перед вызовом API SDK
Object result = sdk.setMultiClientImeEnabled(true, true);
Log.d(TAG, "OK: setMultiClientImeEnabled result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setMultiClientImeEnabled", e);
}
Please report any broken links by emailing support@elotouch.com and include a link to the knowledge article