FleetEngine

מחלקה ציבורית FleetEngine מרחיב אובייקט

לקוח של Fleet Engine של Google.

המחלקה הזו מאפשרת למתקשר להשבית את מעקב המיקום באמצעות enable וגם disableLocationTracking(). אפשר לשלוט בתדירות העדכונים באמצעות setLocationReportingInterval(long, TimeUnit).

הכיתה הזו לא בטוחה לשרשורים.

סיכום של הכיתה המוצבת

משופר	FleetEngine.AuthTokenFactory		מופעים של הממשק הזה יתבקשו לספק אסימון הרשאה כשמתבצעות פעולות שונות.
מחלקה	FleetEngine.ErrorListener		הלקוח של Fleet Engine ישתמש במופעים של הממשק הזה כדי להודיע למפתח כאשר מתרחשים חריגות חשובות.
משופר	FleetEngine.FleetEngineConfig		הממשק הזה הוצא משימוש. הוק מדור קודם
משופר	FleetEngine.StatusListener		מאזינים לעדכוני סטטוס.
טיפוסים בני מנייה (enum)	FleetEngine.VehicleState		התנאי מציין אם ניתן לקבל נסיעות חדשות ברכב מסוים.

סיכום אמצעי תשלום ציבורי

ריק סטטי	clearInstance() DeleteInstance מפסיק את מעקב המיקום, מנקה מצב פנימי ומאפס את הסינגלטון של FleetEngine ל-null.
בטל סטטי	createInstance(אפליקציית Application, String providerId, String חודשי, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener שגיאה) יצירת הסינגלטון FleetEngine, שיכול לשמש לגישה לשירות Google Fleet Engine.
בטל סטטי	createInstance(Application application, String providerId, String vehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener) יצירת הסינגלטון FleetEngine, שיכול לשמש לגישה לשירות Google Fleet Engine.
void	disableLocationTracking() הפסקת המעקב אחר המיקום.
void	enableLocationTracking() מתחילים להעלות דוחות מיקום לקצה העורפי של Fleet Engine.
FleetEngine סטטי	getInstance() מחזירה את הסינגלטון של FleetEngine.
long	getLocationReportingIntervalMs() מחזירה את מרווח הזמן הנוכחי לדיווח על מיקום, באלפיות שנייה.
boolean	isLocationTrackingEnabled() מחזירה אם המעקב אחר המיקום מופעל.
בטל סטטי	setFleetEngineConfig(הגדרת FleetEngine.FleetEngineConfig)
void	setLocationReportingInterval(מרווח ארוך, יחידת זמן יחידת זמן) המדיניות הזו מגדירה את המרווח המינימלי שבו דוחות המיקום יישלחו לקצה העורפי של Fleet Engine.
בטל סטטי	setNavigator(ניווט Navigator)
void	setVehicleState(מצב FleetEngine.VehicleState) מגדיר את כלי הרכב.

סיכום שיטות שעברו בירושה

מכיתה java.lang.Object

boolean	equals(Object arg0)
סופי כיתה<?>	getClass()
int	hashCode()
סופי בטל	notify()
סופי בטל	notifyAll()
מחרוזת	toString()
סופי בטל	wait(long arg0, int arg1)
סופי בטל	wait(long arg0)
סופי בטל	wait()

שיטות ציבוריות

Public סטטי void clearInstance ()

DeleteInstance מפסיק את מעקב המיקום, מנקה מצב פנימי ומאפס את הסינגלטון של FleetEngine ל-null.

ציבורי סטטי void createInstance (Application application, String providerId, String AutomotiveId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)

יצירת הסינגלטון FleetEngine, שיכול לשמש לגישה לשירות Google Fleet Engine. באופן פנימי, השיטה הזו משיגה RoadSnappedLocationProvider באמצעות getRoadSnappedLocationProvider(Application), לכן יש להשיג Navigator בהצלחה לפני הקריאה לשיטה הזו, אחרת תתקבל הודעת IllegalStateException. קריאה ל-createInstance() פעמיים תוביל ל-IllegalStateException.

פרמטרים

יישום	ה-Application הנוכחי, לא יכול להיות null
providerId	המזהה של הספק
vehicleId	המזהה של הרכב שיהיה מחובר למנוע הצי
authTokenFactory	ה-factory שמספק את אסימוני ההרשאה של מנוע הצי
errorListener	ה-listener שיקבל התראה כשיקרו שגיאות לקוח של Fleet Engine

קליעות

IllegalStateException	אם מזהה הספק לא מצוין ב-AndroidManifest.xml

Public סטטי void createInstance (Application application, String providerId, String vehicleId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)

יצירת הסינגלטון FleetEngine, שיכול לשמש לגישה לשירות Google Fleet Engine. באופן פנימי, השיטה הזו משיגה RoadSnappedLocationProvider באמצעות getRoadSnappedLocationProvider(Application), לכן יש להשיג Navigator בהצלחה לפני הקריאה לשיטה הזו, אחרת תתקבל הודעת IllegalStateException. קריאה ל-createInstance() פעמיים תוביל ל-IllegalStateException.

פרמטרים

יישום	Application הנוכחי לא יכול להיות null.
providerId	המזהה של הספק.
vehicleId	המזהה של הרכב שיהיה מחובר למנוע הצי
authTokenFactory	ה-factory שמספק את אסימוני ההרשאה של מנוע הצי.
statusListener	מאזין לעדכוני סטטוס.
errorListener	ה-listener שיקבל התראה כשיקרו שגיאות לקוח של Fleet Engine.

קליעות

IllegalStateException	אם מזהה הספק לא מצוין ב-AndroidManifest.xml.

ציבורי void disableLocationTracking ()

הפסקת המעקב אחר המיקום. לא נעשה ניסיון להפסיק דוח שכבר נמצא בתהליך, אך לא יופקו ולא יועברו דוחות מיקום חדשים.

ניתן להמשיך את המעקב אחרי הפסקת המעקב על ידי התקשרות חוזרת אל enableLocationTracking().

קליעות

IllegalStateException	אם המעקב אחר המיקום כבר הופסק

ציבורי void enableLocationTracking ()

מתחילים להעלות דוחות מיקום לקצה העורפי של Fleet Engine. הדוחות נשלחים מדי פעם, כברירת מחדל כל 5 שניות. יכול להיות ששליחת הדיווחים תהיה נמוכה יותר אם בעיות זמניות, כמו אובדן החיבור לרשת, מונעות את שליחת הדוחות.

דוחות המיקום מבוצעים בשרשור ברקע, הקריאה הזו מוחזרת באופן מיידי.

ייתכן שהמעקב אחר המיקום יושבת על ידי התקשרות אל disableLocationTracking().

אפשר לשנות את מרווח הזמן לדיווח באמצעות setLocationReportingInterval(long, TimeUnit).

קליעות

IllegalStateException	אם המעקב אחר המיקום כבר היה מופעל

Public סטטי FleetEngine getInstance ()

הפונקציה מחזירה את ה-Singleton של FleetEngine. יש לקרוא ל-createInstance() לפני getInstance() , אחרת יוחזר null.

Public ארוך getLocationReportingIntervalMs ()

מחזירה את מרווח הזמן הנוכחי לדיווח על מיקום, באלפיות שנייה.

ציבורי בוליאני isLocationTrackingEnabled ()

מחזירה אם המעקב אחר המיקום מופעל.

ציבורי סטטי void setFleetEngineConfig (FleetEngine.FleetEngineConfig config)

פרמטרים

הגדרה

Public void setLocationReportingInterval (מרווח ארוך, מרווח זמן ביחידת זמן)

המדיניות הזו מגדירה את המרווח המינימלי שבו דוחות המיקום יישלחו לקצה העורפי של Fleet Engine. מרווח ברירת המחדל לדיווח הוא 10 שניות. המרווח המינימלי לעדכון הנתמך הוא 5 שניות. עדכונים תכופים יותר עלולים לגרום לבקשות ושגיאות איטיות יותר.

פרמטרים

interval
intervalUnits

Public סטטי void setNavigator (Navigator navigator)

פרמטרים

navigator, ניווט, נווט

Public void setVehicleState (FleetEngine.VehicleState)

מגדיר את כלי הרכב. אם עדכוני מיקום מופעלים, הערך יופץ בעדכון המיקום הבא. אם עדכוני המיקום מושבתים, העדכון יופעל באופן מיידי.

עדכון AutomotiveState מתבצע בשרשור ברקע, והקריאה הזו חוזרת באופן מיידי.

פרמטרים

state

קליעות

IllegalStateException	אם AutomotiveState מוגדר בתור 'באינטרנט' כשהמעקב אחר המיקום עדיין לא מופעל.