Artykuł ten dotyczy SDK 6.23.14 dla EloView Home. Programiści są zachęcani do korzystania z EloView Home SDK 6.25.520 we wszystkich nowych projektach deweloperskich i przyszłych integracjach.
Kliknij tutaj, aby dowiedzieć się, co nowego w SDK EloView Home 6.25.520.
Kliknij tutaj, aby zapoznać się z przewodnikiem referencyjnym SDK EloView Home 6.25.520.
EloView Home SDK 6.23.14
Obsługiwane platformy: Android 12 i Android 14 urządzenia Elo, w tym Plecak 4 (Standard/Value), I-Series 4 (Standard/Value), I-Series Standard, M50, M60 Pay, M100 i 7-Calowy Pay.
Pełna dokumentacja (Baza wiedzy + Javadoc SDK)
API są zorganizowane według klas funkcjonalnych (System, Sieć, Pakiet itp.), aby ułatwić odkrywanie i przyspieszyć wdrażanie.
Globalne najlepsze praktyki (z KB)
-
Zawsze powiąż z usługą przed wywołaniem jakiejkolwiek API.
Nie wywołuj metod, dopókionServiceConnected()nie zostanie odebrana. -
Zakładaj, że polityka urządzenia może nadpisywać lokalne ustawienia.
Dotyczy to szczególnie czasu, strefy czasowej, USB, trybu kiosku i instalacji aplikacji. -
Używaj NTP do synchronizacji czasu w produkcji.
Unikaj ręcznej konfiguracji czasu, z wyjątkiem testów. -
Zrozum zachowanie resetowania.
-
Resetowanie w przedsiębiorstwie czyści konfigurację Elo i stan rejestracji.
-
Reset fabryczny usuwa wszystkie dane użytkownika i przywraca urządzenie do stanu fabrycznego.
-
-
Rejestruj wynik każdego wywołania API.
Jest to kluczowe dla rozwiązywania problemów i eskalacji.
❗ Ważne uwagi dotyczące użytkowania
Niektóre API SDK wymagają specyficznych uprawnień Androida i mogą działać inaczej w zależności od tego, czy urządzenie jest w trybie EloView, czy w trybie domowym Androida. Ustanowienie polityki urządzenia może nadpisać lokalnie wprowadzone ustawienia. Programiści powinni zweryfikować tryb urządzenia i stan uprawnień przed wywołaniem API w aplikacjach produkcyjnych.
SDK EloView Home jest bazującym na usługach SDK Androida i wymaga pomyślnego połączenia z usługą przed wywoływaniem jakichkolwiek API SDK. Metody mogą zwracać null lub brak wyników, jeśli:
- Usługa nie jest jeszcze podłączona
- Urządzenie nie jest w zgodnym stanie EloView
- Ograniczenia polityki blokują operację
Ten przewodnik koncentruje się na wspieranych oraz powszechnie stosowanych wzorcach. Nie wymienia każdego uprawnienia Androida, przypadku brzegowego cyklu życia ani wewnętrznego stanu zwrotu, które są udokumentowane w surowym Javadoc SDK. Standardowa obsługa cyklu życia usług Androida oraz sprawdzanie błędów muszą być wdrożone w aplikacjach produkcyjnych.
Typowe scenariusze z życia (z KB)
Scenariusz: Niepoprawna strefa czasowa po rejestracji urządzenia
system.setNtpEnabled(true);
system.setNtpServer("time.aws.com");
system.setTimeZone("US/Central");
system.syncTimeNow();
// Weryfikacja
String tz = system.getTimeZone();
Log.d(TAG, "Strefa czasowa=" + tz);
Wskazówka: Jeśli strefa czasowa cofa się po ponownym uruchomieniu, upewnij się, że automatyczna strefa czasowa Androida jest włączona i że polityka urządzenia nie przywraca innego regionu.
Scenariusz: Bezpieczna konfiguracja trybu kiosku jednoaplikacyjnego
pkg.setKioskApp("com.example.kiosk");
pkg.setKioskModeEnabled(true);
pkg.launchApp("com.example.kiosk");
Ostrzeżenie: Zawsze weryfikuj administracyjną drogę ucieczki przed włączeniem trybu kiosku w produkcji.
Szablon powiązania usługi (z KB)
eloView.bindService(context, callback, accessToken);
// Bezpieczne do wywoływania API SDK wewnątrz callback.onServiceConnected()
eloView.unbindService(context);
Ważna uwaga: bindService() i unbindService() nie zwracają wartości. API SDK należy wywoływać tylko po wywołaniu onServiceConnected().
Główne / API powiązania usług
EloView
Klasa EloView oferuje następujące operacje:
- Ustaw content odtwarzany na urządzeniu w trybie Kontroli EloView, gdy urządzenie jest offline lub nie jest zarejestrowane na konto za pomocą setOfflinePlayContent().
- Pobierz typ contentu (APK lub WebView) i nazwę contentu obecnie ustawionego w trybie Kontroli EloView za pomocą getPlayContent().
- Uzyskaj aktualny status odtwarzania skonfigurowanego contentu w trybie Kontroli EloView za pomocą getPlayContentStatus().
- Sprawdź, czy urządzenie jest aktualnie połączone z chmurą EloView (online lub offline) za pomocą getDeviceCloudStatus().
- Przełącz Wi-Fi w Ustawieniach Elo i trybie Androida za pomocą toggleWifi().
- Przełącz Bluetooth w Ustawieniach Elo i trybie Androida za pomocą toggleBT().
bindService
public void bindService(android.content.Context context, ServiceConnectionCallback callback, java.lang.String accessToken)
Ta metoda powiązuje usługę EloView z aplikacją. Musisz wywołać to przed wywołaniem jakichkolwiek API EloView.
Parametry
- context – Kontekst, w którym używane są API EloView.
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Ta metoda służy do odłączenia usługi od aplikacji. Użyj tej metody, aby odłączyć usługę od aplikacji przy czyszczeniu zasobów.
Parametry
- context – Kontekst
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Ta metoda jest używana do ustawienia zawartości na urządzeniu w trybie Kontroli EloView, gdy urządzenie jest offline lub nie jest zarejestrowane na koncie. Jeśli urządzenie połączy się z siecią i zawartość zostanie ustawiona za pośrednictwem EloView, zastąpi to zawartość ustawioną przez to API.
Parametry
- packageName – Pakiet, który ma być ustawiony jako domyślny content na urządzeniu.
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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()
Ta metoda zwraca typ zawartości i nazwę zawartości ustawionej na urządzeniu. Ta metoda działa tylko w trybie Kontroli EloView.
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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()
Ta metoda zwraca status zawartości odtwarzanej na urządzeniu w trybie Kontroli. Status może być jednym z następujących ciągów:
YET_TO_DOWNLOAD, DOWNLOADING, DOWNLOADED, INSTALLING, INSTALLED, DOWNLOAD_FAILED, INSTALL_FAILED, UNKNOWN_STATUS
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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()
Ta metoda zwraca status online lub offline urządzenia. Status może być jednym z następujących ciągów: "Online", "Offline", "Connecting", "Reconnecting", "Online (Not Provisioned)".
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Włącza lub wyłącza Wi-Fi na urządzeniu. Dotyczy zarówno trybu EloView, jak i trybu domowego Androida.
Parametry
- isEnableWifi – Bool dla włączenia lub wyłączenia WiFi w Ustawieniach.
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Ta metoda służy do przełączenia do trybu domowego Androida z trybu EloView. To jest to samo co switchToAndroidHomeMode() z wyjątkiem tego, że akceptuje dwa parametry boolean. Nie ma możliwości powrotu do trybu EloView bez resetu fabrycznego, więc używaj z ostrożnością.
Parametry
- Przełącza urządzenie z trybu EloView do trybu domowego Androida.
- Jeśli isRebootNeeded jest ustawione na true, urządzenie się zrestartuje, aby zastosować zmiany trybu.
- Ważna uwaga: Przełączenie do trybu domowego Androida może wyłączyć ograniczenia i polityki zarządzane przez EloView.
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Ta metoda służy do przełączania Bluetooth w Ustawieniach Elo (tryb EloView). Może być również używana do przełączania Bluetooth w trybie domowym Androida.
Parametry
- isEnableBT – Bool, aby włączyć lub wyłączyć Bluetooth w Ustawieniach.
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem API SDK
Object result = sdk.toggleBT(true);
Log.d(TAG, "OK: toggleBT result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: toggleBT", e);
}
API Konta
AccountManager
Klasa AccountManager zapewnia następujące operacje:
1. Zapewnij token autoryzacji z serwera Elo na podstawie danych uwierzytelniających podanych przez użytkownika (emailId/hasło lub clientId/secretKey).
2. Weryfikacja, czy dany token autoryzacji jest ważny lub wygasł. Token autoryzacji może być zarówno tokenem uzyskanym z serwera Elo, jak i offline'owym tokenem JWT dostarczonym przez zespół wsparcia Elo. (Offline'owy token jest generowany za pomocą nazwy pakietu Twojej aplikacji i może być używany tylko z pakietem, dla którego został wygenerowany.)
3. Wszystkie API wymagają offline'owego tokenu do działania i nie będą działać z tokenem online. Jedynym wyjątkiem są API OTA. API OTA wymagają tokenu online podczas stosowania OTA z serwera Elo. Aby zastosować OTA przez niestandardowy URL serwera lub z lokalnego pliku na urządzeniu, można użyć offline'owego tokenu.
Na przykład, aby uzyskać token autoryzacji:
1. Korzystając z emailId i hasła, wywołaj getEloAccessToken. 2. Korzystając z clientId i secretKey, wywołaj getEloOAuthToken. Po pomyślnej autoryzacji te metody zwrócą token. 3. W przypadku offline'owego tokenu JWT skontaktuj się z zespołem wsparcia Elo.
Token uzyskany z serwera lub zespołu wsparcia jest weryfikowany przy użyciu metody verifyEloToken.
Wyrejestruj odbiorniki rozgłoszeniowe używane przez te API AccountManager za pomocą metody unregisterAccountManagerListener w metodach onPause i onDestroy aktywności, w których używasz tych API, aby uniknąć wycieków.
getProperty
public static java.lang.String getProperty()
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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()
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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()
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Ta metoda jest używana do uzyskania tokenu dostępu z serwera Elo.
Parametry
- context – Obiekt kontekstu wywołującej klasy (Aktywność lub Usługa).
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Ta metoda jest używana do inicjalizacji interfejsu użytkownika OAuth Hosted.
Parametry
- activity – Obiekt Activity wywołującej klasy.
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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()
Wywołaj stopOAuth w metodzie onStop() override klasy aktywności.
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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()
Wywołaj destroyOAuth w metodzie onStop() override klasy aktywności.
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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()
Wywołaj logoutOAuth, aby zakończyć bieżącą sesję logowania.
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Ta funkcja prosi serwer Elo o weryfikację danego tokenu. Po udanej weryfikacji, handler otrzyma wiadomość typu TOKEN_VERIFY_SUCCESS. W przypadku niepowodzenia, TOKEN_VERIFY_FAIL zostanie odebrana.
Parametry
- context – Obiekt kontekstu wywołującej klasy (Aktywność lub Usługa).
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Ta metoda jest używana do poproszenia Portalu EloView o nowy token OAuth. Po pomyślnej autoryzacji, token zostanie wysłany do urządzenia. Ten token jest ważny przez 24 godziny od momentu wydania. Gdy token wygaśnie, dalsze próby weryfikacji tokenu oraz wywoływania API będą skutkować odpowiedzią TOKEN_VERIFY_FAIL. To samo dotyczy, jeśli token nigdy nie został pozyskany ani odebrany.
Jeśli zakończenie działania będzie udane, handler otrzyma wiadomość o typie OAUTH_TOKEN_VALID z tokenem JWT jako odpowiedzi. Poniżej znajduje się przykład udanej odpowiedzi:
"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IlJQTSJ9.eyJ1ZW1haWwiOiJwcmF0YXBlbG8rUHJvZEBnbWFpbC5jb20iLCJvdGl0bGUiOiJwcmF0YXBlbG8rUHJvZEBnbWFpbC5jb20iLCJjYXAiOnsiY3JjIjoiSDIvb2RnIiwicGVybSI6ImZmZmZmZmYwMCJ9LCJpYXQiOjE1MjUxMTc4NDgsIm5iZiI6MTUyNTExNzg0OCwiZXhwIjoxNTI1MjA0MjQ4LCJpc3MiOiIxNTAyIiwic3ViIjoiZWVhNDRkY2JkMjU5YzQyOWY4NTA3YWZhNTQyY2Q3M2YiLCJqdGkiOiJ2ZE14N1ppUGVnWT0ifQ.b2e-F1mVh0ummkBJk3m8pT2qSCceRxuS_A9GAKtYBeo"
W przypadku niepowodzenia autoryzacji z powodu błędnego clientID lub secretID, handler otrzyma wiadomość o typie OAUTH_TOKEN_INVALID.
Parametry
- context – Obiekt kontekstu wywołującej klasy (Aktywność lub Usługa).
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Ta metoda jest używana do wyrejestrowania odbiornika rozgłoszeniowego zarejestrowanego podczas korzystania z jakiegokolwiek API AccountManager. Upewnij się, że wywołujesz to w metodach onPause i onDestroy w cyklu życia Twojej aktywności, jeśli korzystałeś z jakiegokolwiek z API AccountManager. Umożliwi to uniknięcie wycieków.
Parametry
- context – Kontekst, w którym używane były API systemowe.
- context – Kontekst Androida używany do wyrejestrowania słuchacza menedżera konta.
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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 nasłuchuje zdarzeń weryfikacyjnych AuthenticationToken i, przy ważnym tokenie, dostarcza pozytywną odpowiedź do przeprowadzenia dalszych operacji.
Brak udokumentowanych metod dla tego typu.
System APIs
ServiceConnectionCallback
onServiceConnected
void onServiceConnected()
Ta metoda jest wywoływana, gdy usługa jest połączona po wywołaniu bindService.
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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()
Ta metoda jest wywoływana, gdy usługa jest rozłączona. Nie zostanie wywołana, jeśli usługa zostanie odłączona za pomocą unbindService.
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem API SDK
Object result = sdk.onServiceDisconnected();
Log.d(TAG, "OK: onServiceDisconnected result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: onServiceDisconnected", e);
}
System
Klasa System zapewnia następujące operacje:
-
Uzyskaj token autoryzacji za pomocą
getEloAccessToken. -
Zrób zrzut ekranu urządzenia za pomocą
captureScreenShot. -
Ustaw orientację urządzenia (portret, krajobraz, odwrotny portret, odwrotny krajobraz)
za pomocą
setOrientation. -
Uzyskaj orientację urządzenia za pomocą
getOrientation. -
Przywróć urządzenie do ustawień fabrycznych za pomocą
factoryReset. -
Uruchom urządzenie w trybie cichym za pomocą
silentReboot. -
Włącz lub wyłącz pasek nawigacyjny za pomocą
setNavigationBarEnabled. -
Włącz lub wyłącz pasek powiadomień za pomocą
setStatusBarEnabled. -
Przyznaj wszystkie uprawnienia wykonywania za pomocą
setGrantAllAppPermissionEnabled. -
Uzyskaj status paska nawigacyjnego za pomocą
getNavigationBarEnabled. -
Uzyskaj status paska powiadomień za pomocą
getStatusBarEnabled. -
Uzyskaj status przyznawania wszystkich uprawnień aplikacji za pomocą
getGrantAllAppPermissionEnabled. -
Ustaw czas i wyłącz czas za pomocą
setBacklightTimeOutigetBacklightTimeOut. -
Ustaw i zmień hasło ekranu blokady za pomocą
setLockScreenPasswordichangeLockScreenPassword. -
Automatycznie przyznawaj uprawnienia USB za pomocą
autoAllowUSBPermission. -
Zablokuj lub odblokuj oprogramowanie układowe procesora zabezpieczeń za pomocą
setFirmwareStatusLockEnabled. -
Ustaw i zmień PIN do urządzenia za pomocą
setLockScreenPinichangeLockScreenPin. -
Włącz lub wyłącz WiFi za pomocą
setWifiEnabledi uzyskaj status za pomocągetWifiEnabled. -
Wyczyść pamięć podręczną i dane aplikacji za pomocą
clearAllAppCacheUserDataiclearAppCacheUserData. -
Włącz ADB za pomocą
setAdbEnabledi skonfiguruj niestandardowy port za pomocącustomPortAdb. -
Włącz lub wyłącz przycisk domowy za pomocą
setHomeButtonEnabled. -
Włącz lub wyłącz przycisk zasilania za pomocą
setPowerButtonEnabled. -
Włącz lub wyłącz menu asysty edytora tekstu za pomocą
setTextEditorAssistMenuEnabled. -
Włącz lub wyłącz dodatkowe "Pokaż więcej" w panelu głośności
za pomocą
setVolumePanelShowMoreEnabled. -
Włącz lub wyłącz skanowanie kodów kreskowych Zebra za pomocą
setBarcodeReaderEnabled. -
Wyzwól skanowanie kodów kreskowych za pomocą
setScanBarcodeReaderEnabled. -
Włącz lub wyłącz logowanie Elo za pomocą
setEloLoggingEnabled. -
Włącz lub wyłącz losowy adres MAC WiFi za pomocą
setRandomWifiMacAddressEnabled. -
Włącz lub wyłącz dostęp WebView do drukarki Star za pomocą
setStarPeripheralConnectEnabled. -
Sprawdź status auto-zezwolenia USB za pomocą
getAutoAllowUSBPermission. -
Ustaw, usuń i zapytaj właściciela urządzenia za pomocą
setDeviceOwner,removeDeviceOwnerigetDeviceOwnerStatus. -
Ustaw i uzyskaj DPI wyświetlacza za pomocą
setDpiigetDpi. -
Ustaw i uzyskaj język za pomocą
setLanguageigetLanguage. -
Ustaw i uzyskaj typ blokady za pomocą
setLockTypeigetLockType. -
Włącz lub wyłącz Multi Client IME za pomocą
setMultiClientImeEnabledigetMultiClientImeEnabled. -
Ustaw i uzyskaj serwer NTP za pomocą
setNtpServerUrligetNtpServerUrl. -
Ustaw i uzyskaj interwał sondowania NTP za pomocą
setNtpPollIntervaligetNtpPollInterval. -
Kontroluj uprawnienia instalacji za pomocą
setInstallPermissionToSpecificApp,setInstallAllAppPermissionEnabledigetInstallPermissionToSpecificApp. -
Ustaw i uzyskaj rozmiar ekranu za pomocą
setScreenSizeigetScreenSize. -
Ustaw i uzyskaj najszerszą szerokość piksela za pomocą
setSmallestPixelWidthigetSmallestPixelWidth. -
Ustaw i uzyskaj strefę czasową za pomocą
setTimeZoneigetTimeZone. -
Włącz lub wyłącz usługi dostępności za pomocą
setAccessibilityService. -
Włącz lub wyłącz automatyczną datę i godzinę za pomocą
setAutoDateTimeEnabled. -
Włącz lub wyłącz potwierdzenie parowania Bluetooth za pomocą
setBluetoothDevicePairingConfirmationEnabled. -
Ustaw datę i godzinę za pomocą
setDateTime. -
Ustaw rozmiar wyświetlacza za pomocą
setDisplaySize. -
Skonfiguruj WiFi za pomocą CSV za pomocą
setEloNetworkConf. -
Ustaw rozmiar czcionki za pomocą
setFontSize. -
Włącz lub wyłącz tryb Idle za pomocą
setIdleModeEnabled. -
Włącz lub wyłącz lokalizację za pomocą
setLocationEnabled. -
Wycisz lub przywróć mikrofon za pomocą
setMicrophoneMuteEnabled. -
Włącz lub wyłącz widoczność hasła za pomocą
setPasswordEnabled. -
Włącz lub wyłącz Play Protect za pomocą
setPlayProtect. -
Ustaw i uzyskaj zarezerwowaną przestrzeń logów za pomocą
setReservedLogSpaceigetReservedLogSpace. -
Ustaw format czasu za pomocą
setTimeFormatEnabled. -
Włącz lub wyłącz dźwięki dotyku za pomocą
setTouchSoundEnabled. -
Ustaw poziomy głośności za pomocą
setVolumeLevel. -
Włącz lub wyłącz menu udostępniania podczas wyboru tekstu za pomocą
setShowTextEditorShareMenuEnabled. -
Cicho wyłącz urządzenie za pomocą
silentShutDown. -
Ustaw domyślny launcher za pomocą
setSilentDefaultLauncher. -
Uzyskaj status blokady oprogramowania układowego za pomocą
getFirmwareStatusLockEnabled. -
Zaktualizuj oprogramowanie układowe procesora zabezpieczeń za pomocą
spFirmwareUpgrade. -
Rozpocznij aktywność z usługi w tle za pomocą
startActivityFromForegroundService. -
Włącz lub wyłącz tryb ciemny za pomocą
setDarkModeEnabled. -
Obudź ekran za pomocą
wakeupScreen. -
Włącz lub wyłącz dźwięk i wibracje podczas ładowania za pomocą
setChargingSoundAndVibrationEnabled. -
Włącz lub wyłącz dźwięk blokady ekranu za pomocą
setScreenLockSoundEnabled. -
Włącz lub wyłącz kafelek trybu Idle za pomocą
setIdleModeTileEnabled. -
Uzyskaj i ustaw nazwę hosta za pomocą
getHostNameisetHostName. -
Włącz lub wyłącz dostępność hotspotów za pomocą
setHotspotAccessibilityEnabledigetHotspotAccessibilityEnabled. -
Uzyskaj sumę kontrolną MD5 za pomocą
getMD5Checksum. -
Skopiuj i wyczyść plik za pomocą
copyFileiclearAppCacheUserData. -
Weryfikuj podpis pliku za pomocą
verifyFileSignature. -
Zapisz plik za pomocą
writeFile.
bindService
public void bindService(android.content.Context context, ServiceConnectionCallback callback, java.lang.String accessToken)
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem 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)
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem API SDK
Object result = sdk.unbindService(context);
Log.d(TAG, "OK: unbindService result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: unbindService", e);
}
readSystemProperty
public java.lang.String readSystemProperty(java.lang.String key)
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem API SDK
Object result = sdk.readSystemProperty("key");
Log.d(TAG, "OK: readSystemProperty result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: readSystemProperty", e);
}
Ustawienia / Opcje API
Ustawienia
Ta klasa zapewnia operacje dotyczące zarządzania ustawieniami urządzenia.
Opcje ustawień:
- Uzyskaj listę dostępnych opcji.
- Ustaw domyślną wartość.
- Resetuj wartość opcji.
getOptions
public java.util.List<java.lang.String> getOptions()
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem API SDK
Object result = sdk.getOptions();
Log.d(TAG, "OK: getOptions result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: getOptions", e);
}
setDefaultValue
public boolean setDefaultValue(java.lang.String option)
Resetuje wartość opcji.
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem API SDK
Object result = sdk.setDefaultValue("option");
Log.d(TAG, "OK: setDefaultValue result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: setDefaultValue", e);
}
resetOption
public boolean resetOption(java.lang.String option)
Resetuje wartość opcji do wartości domyślnej.
Przykład
try {
// TODO: upewnij się, że usługa jest powiązana przed wywołaniem API SDK
Object result = sdk.resetOption("option");
Log.d(TAG, "OK: resetOption result=" + result);
} catch (Exception e) {
Log.e(TAG, "FAIL: resetOption", e);
}
Informacje / Diagnostyka
Please report any broken links by emailing support@elotouch.com and include a link to the knowledge article