Khởi chạy SDK trình điều khiển

Trước khi sử dụng SDK trình điều khiển, trước tiên bạn phải khởi chạy SDK điều hướng và SDK trình điều khiển theo các bước sau:

  1. Lấy đối tượng Navigator từ NavigationApi.

    Java

    NavigationApi.getNavigator(
    this, // Activity
    new NavigationApi.NavigatorListener() {
      @Override
      public void onNavigatorReady(Navigator navigator) {
        // Keep a reference to the Navigator (used to configure and start nav)
        this.navigator = navigator;
      }
    }
);

    Kotlin

    NavigationApi.getNavigator(
  this, // Activity
  object : NavigatorListener() {
    override fun onNavigatorReady(navigator: Navigator) {
      // Keep a reference to the Navigator (used to configure and start nav)
      this@myActivity.navigator = navigator
    }
  },
)

  2. Tạo đối tượng DriverContext, điền sẵn các trường bắt buộc. Người nhận khởi tạo đối tượng DriverContext, bạn phải nhập Mã dự án của dự án Google Cloud dưới tên providerId. Để biết thông tin về cách thiết lập dự án Google Cloud, hãy xem Tạo dự án Fleet Engine.

    Java

    DriverContext driverContext = DriverContext.builder(application)
    .setProviderId(providerId)
    .setVehicleId(vehicleId)
    .setAuthTokenFactory(authTokenFactory)
    .setNavigator(navigator)
    .setRoadSnappedLocationProvider(
        NavigationApi.getRoadSnappedLocationProvider(application))
    .build();

    Kotlin

    val driverContext =
  DriverContext.builder(application)
    .setProviderId(providerId)
    .setVehicleId(vehicleId)
    .setAuthTokenFactory(authTokenFactory)
    .setNavigator(navigator)
    .setRoadSnappedLocationProvider(NavigationApi.getRoadSnappedLocationProvider(application))
    .build()

  3. Sử dụng đối tượng DriverContext để khởi tạo *DriverApi.

    DeliveryDriverApi driverApi = DeliveryDriverApi.createInstance(driverContext);

  4. Lấy DeliveryVehicleReporter từ đối tượng API. (DeliveryVehicleReporter mở rộng NavigationVehicleReporter.)

    DeliveryVehicleReporter vehicleReporter = driverApi.getDeliveryVehicleReporter();

Lưu ý về SSL/TLS

Trong nội bộ, việc triển khai SDK Trình điều khiển sử dụng SSL/TLS để kết nối an toàn với dịch vụ Fleet Engine. API Android phiên bản 23 hoặc có thể cần bản vá SecurityProvider để giao tiếp với máy chủ. Để biết thêm thông tin về cách làm việc với SSL trong Android, hãy xem Nhà cung cấp GMS bảo mật. Bài viết này cũng chứa các mã mẫu để vá trình cung cấp dịch vụ bảo mật.

Các bước tiếp theo

Chuẩn bị xe sẵn sàng