إعداد Driver SDK

قبل استخدام حزمة تطوير البرامج (SDK) لبرنامج التشغيل، عليك أولاً إعداد حزمة SDK للتنقل وحزمة تطوير البرامج (SDK) لبرنامج التشغيل باتباع الخطوات التالية:

1. الحصول على كائن Navigator من 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)
         [e-mail] = navigator
       }
     },
   )
   

2. أنشِئ عنصر DriverContext، مع تعبئة الحقول المطلوبة. إلى تهيئة كائن DriverContext، يجب عليك إدخال رقم تعريف المشروع في "مشروع Google Cloud" على أنّه providerId. للحصول على معلومات حول إعداد مشروع Google Cloud، فراجع أنشِئ مشروعك على 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. استخدِم الكائن DriverContext لإعداد *DriverApi.

   Java

   RidesharingDriverApi ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext);
   

   Kotlin

   val ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext)
   

4. يمكنك الحصول على RidesharingVehicleReporter من كائن واجهة برمجة التطبيقات. (تمتد *VehicleReporter إلى NavigationVehicleReporter.)

   Java

   RidesharingVehicleReporter vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter();
   

   Kotlin

   val vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter()
   

ملاحظات حول طبقة المقابس الآمنة/بروتوكول أمان طبقة النقل (TLS)

داخليًا، يستخدم تنفيذ حزمة تطوير البرامج (SDK) لبرنامج التشغيل SSL/TLS للاتصال الآمن بخدمة Fleet Engine. واجهة برمجة تطبيقات Android الإصدار 23 أو في وقت سابق قد تتطلب رمز تصحيح SecurityProvider للاتصال الخادم. لمزيد من المعلومات حول استخدام طبقة المقابس الآمنة (SSL) في Android، راجع موفّر "خدمات Google للأجهزة الجوّالة" (GMS) للأمان تحتوي المقالة أيضًا على عيّنات تعليمات برمجية لتصحيح إعدادات موفِّر الأمان.

الخطوات التالية

تجهيز المركبة