FleetEngine

คลาสสาธารณะ FleetEngine ขยายออบเจ็กต์

ไคลเอ็นต์ของ 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() แสดงผลว่ามีการเปิดใช้การติดตามตำแหน่งหรือไม่
คงที่ เป็นโมฆะ	setFleetEngineConfig(ค่ากำหนด FleetEngine.FleetEngineConfig)
void	setLocationReportingInterval(ช่วงเวลายาว, TimeUnit periodUnits) ตั้งค่าช่วงเวลาขั้นต่ำในการส่งรายงานตำแหน่งไปยังแบ็กเอนด์ Fleet Engine
คงที่ เป็นโมฆะ	setNavigator(ตัวนำทาง Navigator)
void	setVehicleState(สถานะ FleetEngine.VehicleState) ตั้งค่า PaneState

ข้อมูลสรุปของเมธอดที่รับช่วงมา

จากคลาส java.lang.Object

boolean	เท่ากับ(อาร์กิวเมนต์วัตถุ 0)
จบ คลาส<?>	getClass()
int	hashCode()
สุดท้าย เป็นโมฆะ	notify()
สุดท้าย เป็นโมฆะ	notifyAll()
สตริง	toString()
สุดท้าย เป็นโมฆะ	wait(long arg0, int arg1)
สุดท้าย เป็นโมฆะ	รอ(อาร์กิวเมนต์ยาว0)
สุดท้าย เป็นโมฆะ	รอ (()

วิธีการสาธารณะ

สาธารณะ คงที่ โมฆะ 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 ()

แสดงผลว่ามีการเปิดใช้การติดตามตำแหน่งหรือไม่

สาธารณะ static void setFleetEngineConfig (FleetEngine.FleetEngineConfig)

พารามิเตอร์

การกำหนดค่า

สาธารณะ void setLocationReportingInterval (ช่วงเวลายาว หน่วยช่วงเวลา)

ตั้งค่าช่วงเวลาขั้นต่ำในการส่งรายงานตำแหน่งไปยังแบ็กเอนด์ Fleet Engine ช่วงเวลาการรายงานเริ่มต้นคือ 10 วินาที ช่วงเวลาการอัปเดตขั้นต่ำที่รองรับคือ 5 วินาที การอัปเดตบ่อยขึ้นอาจส่งผลให้คำขอและข้อผิดพลาดช้าลง

พารามิเตอร์

ช่วงเวลา
intervalUnits

สาธารณะ คงที่ void setNavigator (ตัวนำทาง Navigator)

พารามิเตอร์

ตัวนำทาง

สาธารณะ void setVehicleState (FleetEngine.VehicleState)

ตั้งค่า PaneState หากเปิดใช้การอัปเดตตำแหน่ง ค่าจะเผยแพร่ในการอัปเดตตำแหน่งครั้งถัดไป หากปิดใช้การอัปเดตตำแหน่ง การอัปเดตจะเริ่มทำงานทันที

ระบบดำเนินการอัปเดตยานพาหนะในเทรดเบื้องหลัง และการโทรนี้จะแสดงผลทันที

พารามิเตอร์

state

การขว้าง

IllegalStateException	หากตั้งค่ายานพาหนะเป็น "ออนไลน์" แต่ยังไม่ได้เปิดใช้งานการติดตามตำแหน่ง