לקוח של 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()
מחזירה אם המעקב אחר המיקום מופעל.
|
בטל סטטי | |
void |
setLocationReportingInterval(מרווח ארוך, יחידת זמן יחידת זמן)
המדיניות הזו מגדירה את המרווח המינימלי שבו דוחות המיקום יישלחו לקצה העורפי של Fleet Engine.
|
בטל סטטי |
setNavigator(ניווט Navigator)
|
void |
סיכום שיטות שעברו בירושה
שיטות ציבוריות
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 ()
מחזירה אם המעקב אחר המיקום מופעל.
Public void setLocationReportingInterval (מרווח ארוך, מרווח זמן ביחידת זמן)
המדיניות הזו מגדירה את המרווח המינימלי שבו דוחות המיקום יישלחו לקצה העורפי של Fleet Engine. מרווח ברירת המחדל לדיווח הוא 10 שניות. המרווח המינימלי לעדכון הנתמך הוא 5 שניות. עדכונים תכופים יותר עלולים לגרום לבקשות ושגיאות איטיות יותר.
פרמטרים
interval | |
---|---|
intervalUnits |
Public void setVehicleState (FleetEngine.VehicleState)
מגדיר את כלי הרכב. אם עדכוני מיקום מופעלים, הערך יופץ בעדכון המיקום הבא. אם עדכוני המיקום מושבתים, העדכון יופעל באופן מיידי.
עדכון AutomotiveState מתבצע בשרשור ברקע, והקריאה הזו חוזרת באופן מיידי.
פרמטרים
state |
---|
קליעות
IllegalStateException | אם AutomotiveState מוגדר בתור 'באינטרנט' כשהמעקב אחר המיקום עדיין לא מופעל. |
---|