FleetEngine

klasa publiczna FleetEngine rozszerza Object

Klient Fleet Engine firmy Google.

W ramach tej klasy rozmówca może enable i disableLocationTracking() wyłączyć śledzenie lokalizacji. Częstotliwość aktualizacji można kontrolować za pomocą setLocationReportingInterval(long, TimeUnit).

Te zajęcia nie są bezpieczne w wątku.

Podsumowanie zagnieżdżonych zajęć

interfejs,	FleetEngine.AuthTokenFactory		Instancje tego interfejsu będą prosić o podanie tokena autoryzacji podczas wykonywania różnych operacji.
klasa	FleetEngine.ErrorListener		Klient Fleet Engine będzie używać instancji tego interfejsu, aby informować dewelopera o ważnych wyjątkach.
interfejs,	FleetEngine.FleetEngineConfig		Ten interfejs został wycofany. starsza wersja webhooka
interfejs,	FleetEngine.StatusListener		Nasłuchujący aktualne informacje o stanie.
enum | typ wyliczeniowy	FleetEngine.VehicleState		Wskazuje, czy pojazd przyjmuje nowe przejazdy.

Podsumowanie metod publicznych

statyczny stan nieważny	clearInstance() Czyszczenie instancji zatrzymuje śledzenie lokalizacji, czyści wewnętrzny stan i resetuje singleton FleetEngine do wartości null.
statyczny stan nieważny	createInstance(aplikacja aplikacji, identyfikator dostawcy ciągu, identyfikator pojazdu w ciągu znaków, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener) Tworzy singleton FleetEngine, który umożliwia dostęp do usługi Google Fleet Engine.
statyczny stan nieważny	createInstance(aplikacja aplikacji, identyfikator dostawcy ciągu, identyfikator pojazdu w ciągu znaków, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener) Tworzy singleton FleetEngine, który umożliwia dostęp do usługi Google Fleet Engine.
void	disableLocationTracking() Przerywa śledzenie lokalizacji.
void	enableLocationTracking() Zacznij przesyłać raporty o pozycji do backendu Fleet Engine.
statyczny FleetEngine	getInstance() Zwraca singleton FleetEngine.
długi	getLocationReportingIntervalMs() Zwraca bieżący interwał raportowania lokalizacji w milisekundach.
boolean	isLocationTrackingEnabled() Wskazuje, czy śledzenie lokalizacji jest włączone.
statyczny stan nieważny	setFleetEngineConfig(konfiguracja FleetEngine.FleetEngineConfig)
void	setLocationReportingInterval(długi interwał, TimeUnit interUnits) Określa minimalny odstęp czasu, po którym raporty o lokalizacji będą dostarczane do backendu Fleet Engine.
statyczny stan nieważny	setNavigator(nawigator Navigator)
void	setVehicleState(FleetEngine.VehicleState) Ustawia wartość VehicleState.

Podsumowanie metod dziedziczonych

Z klasy java.lang.Object

boolean	równa się(obiekt arg0)
final Klasa<?>	getClass()
int	hashCode()
ostateczne unieważnienie	notify()
ostateczne unieważnienie	notifyAll()
Ciąg znaków	toString()
ostateczne unieważnienie	wait(long arg0, int arg1)
ostateczne unieważnienie	wait(long arg0)
ostateczne unieważnienie	wait()

Metody publiczne

public static void clearInstance ()

Czyszczenie instancji zatrzymuje śledzenie lokalizacji, czyści wewnętrzny stan i resetuje singleton FleetEngine do wartości null.

public static void createInstance (Aplikacja aplikacji, String providerId, StringVehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)

Tworzy singleton FleetEngine, który umożliwia dostęp do usługi Google Fleet Engine. Wewnętrznie ta metoda uzyskuje RoadSnappedLocationProvider za pomocą getRoadSnappedLocationProvider(Application), więc przed jej wywołaniem należy uzyskać Navigator. W przeciwnym razie otrzymana jest wartość IllegalStateException. Dwukrotne wywołanie metody createInstance() da wynik IllegalStateException.

Parametry

aplikacji ML	obecna wartość Application, nie może wynosić null
providerId	identyfikator dostawcy
vehicleId	identyfikator pojazdu, który zostanie połączony z Fleet Engine;
authTokenFactory	factory, który dostarcza tokeny autoryzacji Fleet Engine
errorListener	listener, który będzie otrzymywać powiadomienia o błędach klienta Fleet Engine

Rzuty

IllegalStateException	jeśli identyfikator dostawcy nie jest określony w AndroidManifest.xml

public static void createInstance (Application application, String providerId, StringużywaneId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)

Tworzy singleton FleetEngine, który umożliwia dostęp do usługi Google Fleet Engine. Wewnętrznie ta metoda uzyskuje RoadSnappedLocationProvider za pomocą getRoadSnappedLocationProvider(Application), więc przed jej wywołaniem należy uzyskać Navigator. W przeciwnym razie otrzymana jest wartość IllegalStateException. Dwukrotne wywołanie metody createInstance() da wynik IllegalStateException.

Parametry

aplikacji ML	aktualna wartość Application, nie może wynosić null.
providerId	identyfikator dostawcy.
vehicleId	identyfikator pojazdu, który zostanie połączony z Fleet Engine;
authTokenFactory	factory, który dostarcza tokeny autoryzacji Fleet Engine.
statusListener	odbiornik aktualizacji stanu.
errorListener	listener, który będzie powiadamiany o błędach klienta Fleet Engine.

Rzuty

IllegalStateException	jeśli identyfikator dostawcy nie jest określony w AndroidManifest.xml.

public void disableLocationTracking ()

Przerywa śledzenie lokalizacji. Nie podejmowana jest próba zatrzymania już utworzonego raportu, ale nie będą generowane ani przesyłane żadne nowe raporty o pozycji.

Śledzenie można wznowić po zatrzymaniu, ponownie wywołując metodę enableLocationTracking().

Rzuty

IllegalStateException	jeśli śledzenie lokalizacji zostało już zatrzymane.

public void enableLocationTracking ()

Zacznij przesyłać raporty o pozycji do backendu Fleet Engine. Raporty są tworzone okresowo, domyślnie co 5 sekund. Raporty mogą być generowane rzadziej, jeśli przejściowe problemy, takie jak utrata połączenia sieciowego, uniemożliwiają ich dostarczanie.

Raporty o pozycji są tworzone w wątku w tle. To połączenie jest zwracane natychmiast.

Śledzenie lokalizacji można wyłączyć, dzwoniąc pod numer disableLocationTracking().

Interwał raportowania można zmienić za pomocą funkcji setLocationReportingInterval(long, TimeUnit).

Rzuty

IllegalStateException	jeśli śledzenie lokalizacji było już włączone

public static FleetEngine getInstance ()

Zwraca singleton FleetEngine. Metoda createInstance() musi zostać wywołana przed getInstance(). W przeciwnym razie zostanie zwrócona wartość null.

public long getLocationReportingIntervalMs ()

Zwraca bieżący interwał raportowania lokalizacji w milisekundach.

public boolean isLocationTrackingEnabled ()

Wskazuje, czy śledzenie lokalizacji jest włączone.

public static void setFleetEngineConfig (konfiguracja FleetEngine.FleetEngineConfig)

Parametry

konfiguracja

public void setLocationReportingInterval (long interwał, TimeUnit interUnits)

Określa minimalny odstęp czasu, po którym raporty o lokalizacji będą dostarczane do backendu Fleet Engine. Domyślny interwał raportowania to 10 sekund. Minimalny obsługiwany interwał aktualizacji to 5 sekund. Częstsze aktualizacje mogą powodować wolniejsze żądania i błędy.

Parametry

interval
intervalUnits

public static void setNavigator (Navigator nawigator)

Parametry

nawigacja

public void setVehicleState (stan FleetEngine.VehicleState)

Ustawia wartość VehicleState. Jeśli masz włączone aktualizacje lokalizacji, wartość zostanie zastosowana przy następnej aktualizacji lokalizacji. Jeśli aktualizacje lokalizacji są wyłączone, aktualizacja jest uruchamiana natychmiast.

Aktualizacja VehicleState jest przeprowadzana w wątku w tle i jest zwracana natychmiast.

Parametry

state

Rzuty

IllegalStateException	jeśli parametr VehicleState jest ustawiony na ONLINE, gdy śledzenie lokalizacji nie jest jeszcze włączone.