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. 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 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.

   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ộ, 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 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