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 vào 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 phần 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 chạy *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()
    

Ghi chú 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 trở xuống có thể yêu cầu 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.

Bước tiếp theo

Chuẩn bị xe