本節說明如何讓車輛準備好執行排程任務。您必須完成以下所有步驟,後端才能比對車輛與任務。
設定事件監聽器
由於 Driver SDK 會在背景執行動作,因此請在發生特定事件 (例如錯誤、警告或偵錯訊息) 時,使用 DriverStatusListener
觸發通知。錯誤可能會暫時性地發生 (例如 BACKEND_CONNECTIVITY_ERROR
),也可能會導致位置更新永久停止。舉例來說,如果您收到 VEHICLE_NOT_FOUND
錯誤,表示有設定錯誤。
以下範例為 DriverStatusListener
實作:
class MyStatusListener implements DriverStatusListener {
/** Called when background status is updated, during actions such as location reporting. */
@Override
public void updateStatus(
StatusLevel statusLevel, StatusCode statusCode, String statusMsg, @Nullable Throwable cause) {
// Existing implementation
if (cause != null && cause instanceof StatusRuntimeException) {
if (Status.NOT_FOUND.getCode().equals(cause.getStatus().getCode())) {
// NOT_FOUND gRPC exception thrown by Fleet Engine.
}
}
}
}
DriverContextBuilder.setDriverStatusListener(new MyStatusListener());
啟用位置更新通知
有了 *VehicleReporter
例項後,請按照下列步驟啟用位置更新功能:
Java
DeliveryVehicleReporter reporter = ...;
reporter.enableLocationTracking();
Kotlin
val reporter = ...
reporter.enableLocationTracking()
(選用) 設定更新間隔
根據預設,Driver SDK 會以 10 秒的間隔傳送位置更新資料。每個位置更新也會指出車輛是否連線。您可以使用 reporter.setLocationReportingInterval(long, TimeUnit)
變更這段間隔。支援的更新間隔最短為 5 秒。頻繁的更新可能會導致要求和錯誤變慢。