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. Để khởi chạy đối tượng DriverContext, bạn phải nhập Mã dự án của Dự án Google Cloud làm 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.

    Java

    RidesharingDriverApi ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext);
    

    Kotlin

    val ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext)
    
  4. Lấy RidesharingVehicleReporter từ đối tượng API. (*VehicleReporter mở rộng NavigationVehicleReporter.)

    Java

    RidesharingVehicleReporter vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter();
    

    Kotlin

    val vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter()
    

Lưu ý về SSL/TLS

Trong nội bộ, quá trình triển khai SDK Trình điều khiển sử dụng SSL/TLS để giao tiếp an toàn với dịch vụ Công cụ của đội xe. 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 bài viết 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