ไคลเอ็นต์ของ Fleet Engine ของ Google
คลาสนี้จะอนุญาตให้ผู้โทรไปยัง enable
และ disableLocationTracking()
ปิดใช้การติดตามตําแหน่งได้ คุณควบคุมความถี่ของการอัปเดตได้ด้วย setLocationReportingInterval(long, TimeUnit)
คลาสนี้ไม่เหมาะสำหรับชุดข้อความ
สรุปข้อมูลชั้นเรียนที่ซ้อนกัน
ที่ปรับปรุงใหม่ | FleetEngine.AuthTokenFactory | ระบบจะขอให้อินสแตนซ์ของอินเทอร์เฟซนี้ระบุโทเค็นการให้สิทธิ์เมื่อมีการดำเนินการต่างๆ | |
คลาส | FleetEngine.ErrorListener | ไคลเอ็นต์ Fleet Engine จะใช้อินสแตนซ์ของอินเทอร์เฟซนี้เพื่อแจ้งนักพัฒนาแอปเมื่อมีข้อยกเว้นที่สำคัญ | |
ที่ปรับปรุงใหม่ | FleetEngine.FleetEngineConfig | อินเทอร์เฟซนี้เลิกใช้งานแล้ว ฮุกเดิม | |
ที่ปรับปรุงใหม่ | FleetEngine.StatusListener | Listener สำหรับการอัปเดตสถานะ | |
enum | FleetEngine.VehicleState | ระบุว่ายานพาหนะนั้นยอมรับการเดินทางใหม่หรือไม่ |
สรุปวิธีการสาธารณะ
คงที่ เป็นโมฆะ |
clearInstance()
clearInstance จะหยุดการติดตามตำแหน่ง ล้างสถานะภายใน และรีเซ็ตซิงเกิล FleetEngine เป็น Null
|
คงที่ เป็นโมฆะ |
createInstance(แอปพลิเคชัน, String providerId, String personalId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)
สร้างซิงเกิล
FleetEngine ซึ่งใช้เข้าถึงบริการ Google Fleet Engine ได้ |
คงที่ เป็นโมฆะ |
createInstance(แอปพลิเคชันแอปพลิเคชัน, String providerId, String pathId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)
สร้างซิงเกิล
FleetEngine ซึ่งใช้เข้าถึงบริการ Google Fleet Engine ได้ |
void |
disableLocationTracking()
หยุดติดตามตำแหน่ง
|
void |
enableLocationTracking()
เริ่มอัปโหลดรายงานตำแหน่งไปยังแบ็กเอนด์ Fleet Engine
|
static FleetEngine |
getInstance()
แสดงผลซิงเกิล FleetEngine
|
long |
getLocationReportingIntervalMs()
แสดงผลช่วงเวลาการรายงานตำแหน่งปัจจุบันในหน่วยมิลลิวินาที
|
boolean |
isLocationTrackingEnabled()
แสดงผลว่ามีการเปิดใช้การติดตามตำแหน่งหรือไม่
|
คงที่ เป็นโมฆะ | |
void |
setLocationReportingInterval(ช่วงเวลายาว, TimeUnit periodUnits)
ตั้งค่าช่วงเวลาขั้นต่ำในการส่งรายงานตำแหน่งไปยังแบ็กเอนด์ Fleet Engine
|
คงที่ เป็นโมฆะ |
setNavigator(ตัวนำทาง Navigator)
|
void |
ข้อมูลสรุปของเมธอดที่รับช่วงมา
วิธีการสาธารณะ
สาธารณะ คงที่ โมฆะ clearInstance ()
clearInstance จะหยุดการติดตามตำแหน่ง ล้างสถานะภายใน และรีเซ็ตซิงเกิล FleetEngine เป็น Null
สาธารณะ static void createInstance (แอปพลิเคชันแอปพลิเคชัน, String providerId, String pathId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.ErrorListener errorListener)
สร้างซิงเกิล FleetEngine
ซึ่งใช้เข้าถึงบริการ Google Fleet Engine ได้ วิธีนี้จะได้รับ RoadSnappedLocationProvider
โดยใช้ getRoadSnappedLocationProvider(Application)
ภายใน ดังนั้นเมธอดนี้จึงต้องได้รับ Navigator
ได้สำเร็จก่อนเรียกใช้เมธอดนี้ มิเช่นนั้นจะส่งผลให้มี IllegalStateException
การเรียกใช้ createInstance() 2 ครั้งจะทำให้เกิด IllegalStateException
พารามิเตอร์
แอปพลิเคชัน | Application ปัจจุบัน ต้องเป็น null |
---|---|
providerId | รหัสของผู้ให้บริการ |
vehicleId | รหัสของรถที่จะเชื่อมต่อกับ Fleet Engine |
authTokenFactory | factory ที่ส่งโทเค็นการให้สิทธิ์ Fleet Engine |
errorListener | listener ที่จะได้รับการแจ้งเตือนเมื่อเกิดข้อผิดพลาดของไคลเอ็นต์ Fleet Engine |
การขว้าง
IllegalStateException | หากไม่ได้ระบุรหัสผู้ให้บริการใน AndroidManifest.xml
|
---|
สาธารณะ static void createInstance (แอปพลิเคชันแอปพลิเคชัน, String providerId, String cartId, FleetEngine.AuthTokenFactory authTokenFactory, FleetEngine.StatusListener statusListener, FleetEngine.ErrorListener errorListener)
สร้างซิงเกิล FleetEngine
ซึ่งใช้เข้าถึงบริการ Google Fleet Engine ได้ วิธีนี้จะได้รับ RoadSnappedLocationProvider
โดยใช้ getRoadSnappedLocationProvider(Application)
ภายใน ดังนั้นเมธอดนี้จึงต้องได้รับ Navigator
ได้สำเร็จก่อนเรียกใช้เมธอดนี้ มิเช่นนั้นจะส่งผลให้มี IllegalStateException
การเรียกใช้ createInstance() 2 ครั้งจะทำให้เกิด IllegalStateException
พารามิเตอร์
แอปพลิเคชัน | Application ปัจจุบัน ต้องไม่เป็น null |
---|---|
providerId | รหัสของผู้ให้บริการ |
vehicleId | รหัสของรถที่จะเชื่อมต่อกับ Fleet Engine |
authTokenFactory | factory ที่ส่งโทเค็นการให้สิทธิ์ Fleet Engine |
statusListener | Listener การอัปเดตสถานะ |
errorListener | listener ที่จะได้รับการแจ้งเตือนเมื่อเกิดข้อผิดพลาดของไคลเอ็นต์ Fleet Engine |
การขว้าง
IllegalStateException | หากไม่ได้ระบุรหัสผู้ให้บริการใน AndroidManifest.xml
|
---|
สาธารณะ void disableLocationTracking ()
หยุดติดตามตำแหน่ง ระบบจะไม่พยายามหยุดรายงานที่กำลังดำเนินการอยู่ แต่จะไม่มีการสร้างหรือส่งรายงานตำแหน่งใหม่
คุณจะเรียกให้การติดตามกลับมาทำงานอีกครั้งได้หลังจากหยุดด้วยการโทรหา enableLocationTracking()
อีกครั้ง
การขว้าง
IllegalStateException | หากการติดตามตำแหน่งหยุดไปแล้ว |
---|
สาธารณะ void enableLocationTracking ()
เริ่มอัปโหลดรายงานตำแหน่งไปยังแบ็กเอนด์ Fleet Engine ระบบจะสร้างรายงานเป็นระยะๆ โดยค่าเริ่มต้นทุก 5 วินาที ระบบอาจสร้างรายงานน้อยลงหากเกิดปัญหาชั่วคราว เช่น การเชื่อมต่อเครือข่ายขาดหาย ทำให้ไม่สามารถส่งรายงานได้
รายงานอันดับจะสร้างขึ้นในชุดข้อความเบื้องหลัง และการเรียกนี้จะแสดงผลทันที
อาจมีการปิดใช้การติดตามตำแหน่งโดยโทรไปที่ disableLocationTracking()
ช่วงเวลาการรายงานสามารถเปลี่ยนแปลงได้ด้วย setLocationReportingInterval(long, TimeUnit)
การขว้าง
IllegalStateException | หากมีการเปิดใช้การติดตามตำแหน่งอยู่แล้ว |
---|
สาธารณะ คงที่ FleetEngine getInstance ()
แสดงผล Singleton สำหรับ FleetEngine ต้องเรียกใช้ createInstance() ก่อน getInstance() มิเช่นนั้นระบบจะแสดงผลเป็น Null
สาธารณะ ยาว getLocationReportingIntervalMs ()
แสดงผลช่วงเวลาการรายงานตำแหน่งปัจจุบันในหน่วยมิลลิวินาที
สาธารณะ บูลีน isLocationTrackingEnabled ()
แสดงผลว่ามีการเปิดใช้การติดตามตำแหน่งหรือไม่
สาธารณะ void setLocationReportingInterval (ช่วงเวลายาว หน่วยช่วงเวลา)
ตั้งค่าช่วงเวลาขั้นต่ำในการส่งรายงานตำแหน่งไปยังแบ็กเอนด์ Fleet Engine ช่วงเวลาการรายงานเริ่มต้นคือ 10 วินาที ช่วงเวลาการอัปเดตขั้นต่ำที่รองรับคือ 5 วินาที การอัปเดตบ่อยขึ้นอาจส่งผลให้คำขอและข้อผิดพลาดช้าลง
พารามิเตอร์
ช่วงเวลา | |
---|---|
intervalUnits |
สาธารณะ void setVehicleState (FleetEngine.VehicleState)
ตั้งค่า PaneState หากเปิดใช้การอัปเดตตำแหน่ง ค่าจะเผยแพร่ในการอัปเดตตำแหน่งครั้งถัดไป หากปิดใช้การอัปเดตตำแหน่ง การอัปเดตจะเริ่มทำงานทันที
ระบบดำเนินการอัปเดตยานพาหนะในเทรดเบื้องหลัง และการโทรนี้จะแสดงผลทันที
พารามิเตอร์
state |
---|
การขว้าง
IllegalStateException | หากตั้งค่ายานพาหนะเป็น "ออนไลน์" แต่ยังไม่ได้เปิดใช้งานการติดตามตำแหน่ง |
---|