Tài liệu tham khảo dành cho lớp GMTDDeviceReporter

Hàm thành viên công khai | Loại được bảo vệ | Thuộc tính được bảo vệ | Thuộc tính
Tài liệu tham khảo dành cho lớp GMTDDeviceReporter

Tổng quan

Đối tượng gửi thông tin đến phần phụ trợ của Fleet Engine.

Dùng để giao hàng.

Kế thừa kế thừa từ GMTDVehicleReporter.

Hàm thành viên công khai

(void) – setCarStops:completes:complete:
 Cập nhật các ActivityStops còn lại cho xe.
(void) – reportEnrouteToNextStopWithCompletion:
 Cập nhật trạng thái của GMTDVehicleStop đầu tiên trong remainingVehicleStops thành GMTDVehicleStopStateEnroute.
(void) – reportAlreadyAtStopWithCompletion:
 Cập nhật trạng thái của GMTDVehicleStop đầu tiên trong remainingVehicleStops thành GMTDVehicleStopStateArrived.
(void) – reportCompletedStopWithCompletion:
 Xoá GMTDVehicleStop đầu tiên trong remainingVehicleStops.
(void) – getRemainingvehicleStopsWithCompletion:
 Lấy các đối tượng GMTDVehicleStop còn lại mà xe vẫn cần truy cập.
(void) – updateXeState:
 Cập nhật trạng thái xe.
(void) – addListener:
 Thêm trình nghe.
(void) – removeListener:
 Xoá trình nghe.

Các loại được bảo vệ

khoảng trống typedef(^ GMTDVehicleReporterStopCompletionHandler )(NSArray< GMTDVehicleStop * > *_Điểm dừng có thể có giá trị rỗng, NSError *_Nullable error)
 Trình xử lý để cập nhật các điểm dừng qua GMTDDeliveryVehicleReporter.

Thuộc tính được bảo vệ

 __pad0__: NSObject <GMSNavigatorListener

Thuộc tính

GMSRoadSnappedLocationProviderListener
BOOL		locationTrackingEnabled
 Lớp này không có trình khởi tạo công khai; hãy lấy đối tượng này từ thuộc tính vehicleReporter của đối tượng GMTDDeliveryDriverAPI hoặc GMTDRidesharingDriverAPI.
Khoảng thời gian NSTimelocationReportingInterval
 Cho biết khoảng thời gian tối thiểu mà báo cáo vị trí sẽ được gửi cho Fleet Engine.

Tài liệu về hàm thành phần

– (vô hiệu) setXeStops: (NSArray< GMTDVehicleStop * > *) vehicleStops
hoàn thành: (GMTDVehicleReporterStopCompletionHandler) hoàn tất

Cập nhật các ActivityStops còn lại cho xe.

Kết quả được phản ánh không đồng bộ trong remainingVehicleStops. Xe sẽ đến các điểm dừng theo cùng thứ tự như trong mảng.

Các tham số:
vehicleStopsMảng gồm các đối tượng GMTDVehicleStop theo thứ tự mà xe sẽ truy cập. Giá trị này phải có giá trị bằng 1 và tất cả các điểm dừng khác ngoài điểm dừng đầu tiên phải có trạng thái là GMTDVehicleStopStateNew.
hoàn thànhMột khối sẽ chạy sau khi các điểm dừng đã được cập nhật.
- (vô hiệu) reportEnrouteToNextStopWithCompletion: (GMTDVehicleReporterStopCompletionHandler) hoàn thành

Cập nhật trạng thái của GMTDVehicleStop đầu tiên trong remainingVehicleStops thành GMTDVehicleStopStateEnroute.

remainingVehicleStops phải chứa ít nhất một điểm dừng khi hàm này được gọi.

Các tham số:
hoàn thànhMột khối sẽ chạy sau khi các điểm dừng đã được cập nhật.
– (vô hiệu) reportActualdAtStopWithCompletion: (GMTDVehicleReporterStopCompletionHandler) hoàn thành

Cập nhật trạng thái của GMTDVehicleStop đầu tiên trong remainingVehicleStops thành GMTDVehicleStopStateArrived.

remainingVehicleStops phải chứa ít nhất một điểm dừng khi hàm này được gọi.

Các tham số:
hoàn thànhMột khối sẽ chạy sau khi các điểm dừng đã được cập nhật.
– (vô hiệu) reportCompletedStopWithCompletion: (GMTDVehicleReporterStopCompletionHandler) hoàn thành

Xoá GMTDVehicleStop đầu tiên trong remainingVehicleStops.

remainingVehicleStops phải chứa ít nhất một điểm dừng khi hàm này được gọi.

Các tham số:
hoàn thànhMột khối sẽ chạy sau khi các điểm dừng đã được cập nhật.
– (vô hiệu) getRemainingvehicleStopsWithCompletion: (GMTDVehicleReporterStopCompletionHandler) hoàn thành

Lấy các đối tượng GMTDVehicleStop còn lại mà xe vẫn cần truy cập.

Các tham số:
hoàn thànhHoàn tất để chạy với các đối tượng GMTDVehicleStop đã truy xuất. Quá trình hoàn tất sẽ chạy không đồng bộ trên luồng chính.
- (vô hiệu) updateXeState: (GMTDVehicleState) vehicleState

Cập nhật trạng thái xe.

Chỉ dùng để đi chung xe.

Nếu bạn đặt locationTrackingEnabled thành NO, thì việc đặt trạng thái thành GMTDVehicleStateOnline sẽ không thành công.

Nếu bạn đặt trạng thái khác, hệ thống sẽ gửi yêu cầu một lần đến phần phụ trợ của Fleet Engine.

Phương thức này cập nhật trạng thái phía máy chủ, ứng dụng khách phải theo dõi fleetEngine:didSucceedVehicleUpdate: và fleetEngine:didFailVehicleUpdate:withError: để xác nhận trạng thái thành công hay không. Các lỗi sẽ được tự động thử lại nếu bạn đặt locationTrackingEnabled thành YES.

Các tham số:
vehicleStateTrạng thái xe mong muốn.
– (vô hiệu) addListener: (id< GMTDVehicleReporterListener >) trình nghe

Thêm trình nghe.

Trình nghe bị giữ lại một tham chiếu yếu.

Các tham số:
trình ngheMột đối tượng tuân theo giao thức GMTDVehicleReporterListener.
– (vô hiệu) removeListener: (id< GMTDVehicleReporterListener >) trình nghe

Xoá trình nghe.

Các tham số:
trình ngheMột đối tượng tuân theo giao thức GMTDVehicleReporterListener.

Tài liệu về dữ liệu thành viên

– GMTDvehicleReporter: [protected, inherited]

Tài liệu về thuộc tính

– (GMSRoadSnappedLocationProviderListener BOOL) locationTrackingEnabled [read, write, assign, inherited]

Lớp này không có trình khởi tạo công khai; hãy lấy đối tượng này từ thuộc tính vehicleReporter của đối tượng GMTDDeliveryDriverAPI hoặc GMTDRidesharingDriverAPI.

Cho biết liệu tính năng theo dõi vị trí có được bật hay không.

Nếu bạn đặt chính sách này thành YES, thì thông tin cập nhật về chuyến đi và phương tiện sẽ được gửi đến phần phụ trợ của Fleet Engine theo định kỳ dựa trên giá trị được đặt cho locationUpdateInterval.

Nếu bạn đặt chính sách này thành KHÔNG, quá trình cập nhật sẽ dừng lại và yêu cầu cập nhật xe một lần sẽ được gửi đến phần phụ trợ của Fleet Engine để đặt trạng thái xe thành GMTDVehicleStateOffline. Hãy xem updateVehicleState để biết những điểm cần đặc biệt lưu ý về xử lý lỗi khi bạn đặt locationTrackingEnabled thành NO.

– (NSTimeInterval) locationReportingInterval [read, write, assign, inherited]

Cho biết khoảng thời gian tối thiểu mà báo cáo vị trí sẽ được gửi cho Fleet Engine.

Lưu ý:
Khoảng thời gian báo cáo mặc định là 10 giây. Giá trị tối đa được hỗ trợ là 60 giây và giá trị tối thiểu được hỗ trợ là 5 giây. Nếu sử dụng một giá trị nằm ngoài phạm vi này, thì giá trị yêu cầu sẽ được giới hạn trong phạm vi đó.