آماده کردن خودرو

این بخش نحوه آماده کردن خودرو برای کارهای زمان‌بندی‌شده را نشان می‌دهد. باید هریک از مراحل زیر را تکمیل کنید تا پس‌زمین شما بتواند خودرویی را با تکلیفی مطابقت دهد.

راه‌اندازی شنونده

ازآنجایی‌که 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 را داشتید، به‌روزرسانی‌های مکان را به‌صورت زیر فعال کنید:

جاوا

DeliveryVehicleReporter reporter = ...;

reporter.enableLocationTracking();

Kotlin

val reporter = ...

reporter.enableLocationTracking()

(اختیاری) تنظیم فاصله زمانی به‌روزرسانی

به‌طور پیش‌فرض، Driver SDK به‌روزرسانی‌های مکان را در فواصل ۱۰ ثانیه‌ای ارسال می‌کند. هر به‌روزرسانی مکان همچنین نشان می‌دهد که خودرو آنلاین است. می‌توانید این فاصله را با reporter.setLocationReportingInterval(long, TimeUnit) تغییر دهید. حداقل فاصله زمانی به‌روزرسانی پشتیبانی‌شده ۵ ثانیه است. به‌روزرسانی‌های مکررتر ممکن است منجر به درخواست‌های کندتر و خطا شود.