Mesin Armada

class publik FleetEngine memperluas Object

Klien untuk Fleet Engine Google.

Class ini memungkinkan pemanggil untuk enable dan disableLocationTracking() menonaktifkan pelacakan lokasi. Frekuensi update dapat dikontrol dengan setLocationReportingInterval(long, TimeUnit).

Class ini tidak aman untuk thread.

Ringkasan Class Bertingkat

antarmuka FleetEngine.AuthTokenFactory Instance antarmuka ini akan diminta untuk memberikan token otorisasi saat berbagai operasi dilakukan. 
class FleetEngine.ErrorListener Klien Fleet Engine akan menggunakan instance antarmuka ini untuk memberi tahu developer jika terjadi pengecualian penting. 
antarmuka FleetEngine.FleetEngineConfig Antarmuka ini tidak digunakan lagi. hook lama
antarmuka FleetEngine.StatusListener Pemroses pembaruan status. 
enum FleetEngine.VehicleState Menunjukkan apakah kendaraan menerima perjalanan baru. 

Ringkasan Metode Publik

void statis
clearInstance()
clearInstance menghentikan pelacakan lokasi, membersihkan status internal, dan mereset singleton FleetEngine ke null.
void statis
createInstance(Aplikasi aplikasi, String providerId, String vehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)
Membuat singleton FleetEngine, yang dapat digunakan untuk mengakses layanan Google Fleet Engine.
void statis
createInstance(Aplikasi aplikasi, String providerId, String kendaraanId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)
Membuat singleton FleetEngine, yang dapat digunakan untuk mengakses layanan Google Fleet Engine.
void
disableLocationTracking()
Menghentikan pelacakan lokasi.
void
enableLocationTracking()
Mulai mengupload laporan posisi ke backend Fleet Engine.
statis FleetEngine
getInstance()
Menampilkan singleton FleetEngine.
long
getLocationReportingIntervalMs()
Menampilkan interval pelaporan lokasi saat ini, dalam milidetik.
boolean
isLocationTrackingEnabled()
Menampilkan apakah pelacakan lokasi diaktifkan.
void statis
void
setLocationReportingInterval(interval panjang, TimeUnit intervalUnits)
Menetapkan interval minimum saat laporan lokasi akan dikirim ke backend Fleet Engine.
void statis
setNavigator(navigator Navigator)
void
setVehicleState(status FleetEngine.VehicleState)
Menetapkan VehicleState.

Ringkasan Metode Turunan

Metode Publik

public static void clearInstance ()

clearInstance menghentikan pelacakan lokasi, membersihkan status internal, dan mereset singleton FleetEngine ke null.

public static void createInstance (Application application, String providerId, String vehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)

Membuat singleton FleetEngine, yang dapat digunakan untuk mengakses layanan Google Fleet Engine. Secara internal, metode ini mendapatkan RoadSnappedLocationProvider menggunakan getRoadSnappedLocationProvider(Application), sehingga Navigator harus berhasil diperoleh sebelum memanggil metode ini; jika tidak, metode tersebut akan menghasilkan IllegalStateException. Memanggil createInstance() dua kali akan menghasilkan IllegalStateException.

Parameter
aplikasi Application saat ini, tidak boleh null
providerId ID penyedia
vehicleId ID kendaraan yang akan dihubungkan ke Fleet Engine
authTokenFactory factory yang menyediakan token otorisasi Fleet Engine
errorListener listener yang akan diberi tahu saat terjadi error klien Fleet Engine
Menampilkan
IllegalStateException jika ID penyedia tidak ditentukan di AndroidManifest.xml

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

Membuat singleton FleetEngine, yang dapat digunakan untuk mengakses layanan Google Fleet Engine. Secara internal, metode ini mendapatkan RoadSnappedLocationProvider menggunakan getRoadSnappedLocationProvider(Application), sehingga Navigator harus berhasil diperoleh sebelum memanggil metode ini; jika tidak, metode tersebut akan menghasilkan IllegalStateException. Memanggil createInstance() dua kali akan menghasilkan IllegalStateException.

Parameter
aplikasi Application saat ini, tidak boleh null.
providerId ID penyedia.
vehicleId ID kendaraan yang akan dihubungkan ke Fleet Engine
authTokenFactory factory yang menyediakan token otorisasi Fleet Engine.
statusListener pemroses untuk pembaruan status.
errorListener listener yang akan diberi tahu saat terjadi error klien Fleet Engine.
Menampilkan
IllegalStateException jika ID penyedia tidak ditentukan dalam AndroidManifest.xml.

public void disableLocationTracking ()

Menghentikan pelacakan lokasi. Tidak ada upaya yang dilakukan untuk menghentikan laporan yang sudah berlangsung, tetapi tidak ada laporan posisi baru yang akan dibuat atau dikirim.

Pelacakan dapat dilanjutkan setelah berhenti dengan memanggil enableLocationTracking() lagi.

Menampilkan
IllegalStateException jika pelacakan lokasi sudah dihentikan

public void enableLocationTracking ()

Mulai mengupload laporan posisi ke backend Fleet Engine. Laporan dibuat secara berkala, secara default setiap 5 detik. Laporan dapat dibuat lebih jarang jika masalah sementara, seperti hilangnya konektivitas jaringan, mencegah pengiriman laporan.

Laporan posisi dibuat di thread latar belakang, panggilan ini langsung ditampilkan.

Pelacakan lokasi dapat dinonaktifkan dengan memanggil disableLocationTracking().

Interval pelaporan dapat diubah dengan setLocationReportingInterval(long, TimeUnit).

Menampilkan
IllegalStateException jika pelacakan lokasi sudah diaktifkan

public static FleetEngine getInstance ()

Menampilkan singleton FleetEngine. createInstance() harus dipanggil sebelum getInstance(), jika tidak, null akan ditampilkan.

publik panjang getLocationReportingIntervalMs ()

Menampilkan interval pelaporan lokasi saat ini, dalam milidetik.

public boolean isLocationTrackingEnabled ()

Menampilkan apakah pelacakan lokasi diaktifkan.

public static void setFleetEngineConfig (Konfigurasi FleetEngine.FleetEngineConfig)

Parameter
config

public void setLocationReportingInterval (interval panjang, TimeUnit intervalUnits)

Menetapkan interval minimum saat laporan lokasi akan dikirim ke backend Fleet Engine. Interval pelaporan default adalah 10 detik. Interval update minimum yang didukung adalah 5 detik. Update yang lebih sering dapat menyebabkan permintaan dan error yang lebih lambat.

Parameter
interval
intervalUnits

public static void setNavigator (Navigator navigator)

Parameter
navigator

public void setVehicleState (FleetEngine.VehicleState state)

Menetapkan VehicleState. Jika pembaruan lokasi diaktifkan, nilai akan diterapkan pada pembaruan lokasi berikutnya. Jika pembaruan lokasi dinonaktifkan, pembaruan akan segera diaktifkan.

Pembaruan VehicleState dibuat di thread latar belakang, panggilan ini segera ditampilkan.

Parameter
state
Menampilkan
IllegalStateException jika VehicleState ditetapkan ONLINE saat pelacakan lokasi belum diaktifkan.