Migrationsanleitung für Android Driver SDK 3.0

Für das Treiber-SDK für Android 3.0 müssen Sie Ihren Code aktualisieren für bestimmte Operationen. In diesem Leitfaden werden die Änderungen und die die Sie ausführen müssen, um Ihren Code zu migrieren.

Änderung des Paketnamens

Der Paketname wurde geändert von com.google.android.libraries.ridesharing.driver bis com.google.android.libraries.mapsplatform.transportation.driver. Bitte Aktualisieren Sie Verweise in Ihrem Code.

SDK initialisieren

In früheren Versionen initialisieren Sie das Navigation SDK und erhalten dann einen Verweis auf die FleetEngine-Klasse Im Treiber-SDK Version 3 können Sie das SDK wie folgt initialisieren:

  1. Rufen Sie ein Navigator-Objekt aus NavigationApi ab.

    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;
            }
          }
    );
    
  2. Erstellen Sie ein DriverContext-Objekt und füllen Sie die Pflichtfelder aus.

    DriverContext driverContext = DriverContext.builder(application)
                 .setProviderId(providerId)
                 .setVehicleId(vehicleId)
                 .setAuthTokenFactory(authTokenFactory)
                 .setNavigator(navigator)
                 .setRoadSnappedLocationProvider(
                     NavigationApi.getRoadSnappedLocationProvider(application))
                 .build()
    
  3. Verwenden Sie das DriverContext-Objekt, um *DriverApi zu initialisieren.

    RidesharingDriverApi ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext);
    
  4. Rufen Sie die NavigationVehicleReporter aus dem API-Objekt ab. *VehicleReporter verlängert NavigationVehicleReporter.

    RidesharingVehicleReporter vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter();
    

Standortaktualisierungen aktivieren und deaktivieren

In früheren Versionen sollten Sie Standortupdates aktivieren, nachdem Sie Eine FleetEngine-Referenz. Aktivieren Sie im Treiber SDK v3 Standortaktualisierungen wie folgt:

RidesharingVehicleReporter reporter = ...;

reporter.enableLocationTracking();

Verwenden Sie zum Aktualisieren des Berichtsintervalls RidesharingVehicleReporter.setLocationReportingInterval(long, TimeUnit) oder DeliveryVehicleReporter.setLocationReportingInterval(long, TimeUnit).

Standortaktualisierungen deaktivieren, wenn die Schicht des Fahrers beendet ist und das Fahrzeug durch Aufrufen von NavigationVehicleReporter.disableLocationTracking() als offline markieren.

Fahrzeugstatus auf dem Server festlegen

In früheren Versionen würden Sie das FleetEngine-Objekt verwenden, um Zustand des Fahrzeugs. Verwenden Sie in Treiber-SDK v3 die Methode RidesharingVehicleReporter-Objekt zum Festlegen des Fahrzeugstatus:

  RidesharingVehicleReporter reporter = ...;

  reporter.enableLocationTracking();
  reporter.setVehicleState(VehicleState.ONLINE);

Um den Fahrzeugstatus auf OFFLINE festzulegen, rufen Sie RidesharingVehicleReporter.disableLocationTracking(). Fehler Updates des Fahrzeugstatus mithilfe der optional bereitgestellten StatusListener wurde in DriverContext festgelegt.

Error Reporting mit StatusListener

ErrorListener wurde entfernt und mit StatusListener kombiniert. die so definiert werden kann:

class MyStatusListener implements StatusListener {
  /** Called when background status is updated, during actions such as location reporting. */
  @Override
  public void updateStatus(
    StatusLevel statusLevel,
    StatusCode statusCode,
    String statusMsg) {
    // Status handling stuff goes here.
    // StatusLevel may be DEBUG, INFO, WARNING, or ERROR.
    // StatusCode may be DEFAULT, UNKNOWN_ERROR, VEHICLE_NOT_FOUND, 
    // BACKEND_CONNECTIVITY_ERROR, or PERMISSION_DENIED.
  }
}

Mit AuthTokenFactory authentifizieren

AuthTokenFactory hat jetzt nur noch eine Methode, getToken(), die AuthTokenContext als Parameter verwenden. Mitfahrdienste müssen Authentifizierung für den Diensttyp VEHICLE, wodurch die Standortermittlung aktiviert wird Berichte zum Fahrzeugstatus (online/offline)

class JsonAuthTokenFactory implements AuthTokenFactory {
  String vehicleServiceToken;  // initially null
  long expiryTimeMs = 0;

  // This method is called on a thread whose only responsibility is to send
  // location updates. Blocking is OK, but just know that no location updates
  // can occur until this method returns.
  @Override public String getToken(AuthTokenContext authTokenContext) {
    if (System.currentTimeMillis() > expiryTimeMs) {
      // The token has expired, go get a new one.
      fetchNewToken(vehicleId);
    }
    if (ServiceType.VEHICLE.equals(authTokenContext.getServiceType)) {
      return vehicleServiceToken;
    } else {
      throw new RuntimeException("Unsupported ServiceType: " + authTokenContext.getServiceType());
    }
  }

  private void fetchNewToken(String vehicleId) {
    String url = "https://yourauthserver.example/token/" + vehicleId;

    try (Reader r = new URL(url).openStream()) {
      com.google.gson.JsonObject obj
          = new com.google.gson.JsonParser().parse(r);
      vehicleServiceToken = obj.get("VehicleServiceToken").getAsString();
      expiryTimeMs = obj.getAsLong("TokenExpiryMs");

      // The expiry time could be an hour from now, but just to try and avoid
      // passing expired tokens, we subtract 10 minutes from that time.
      expiryTimeMs -= 10 * 60 * 1000;
    } catch (IOException e) {
      // It's OK to throw exceptions here, the StatusListener you passed to
      // create the FleetEngine class will be notified and pass along the failed
      // update warning.
      throw new RuntimeException("Could not get auth token", e);
    }
  }
}