قبل استخدام حزمة تطوير البرامج (SDK) للسائقين، يجب أولاً تهيئة حزمة تطوير البرامج (SDK) للتنقّل وحزمة تطوير البرامج (SDK) للسائقين باتّباع الخطوات التالية:
احصل على عنصر
NavigatorمنNavigationApi.جافا
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 } }, )أنشئ عنصر
DriverContextواملأ الحقول المطلوبة. لتهيئة عنصرDriverContext، يجب إدخال رقم تعريف المشروع لمشروعك على Google Cloud كـproviderId. للحصول على معلومات حول إعداد مشروع Google Cloud، يُرجى الاطّلاع على مقالة إنشاء مشروع Fleet Engine.جافا
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()استخدِم عنصر
DriverContextلتهيئة*DriverApi.جافا
RidesharingDriverApi ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext);Kotlin
val ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext)احصل على
RidesharingVehicleReporterمن عنصر واجهة برمجة التطبيقات. (*VehicleReporterيرث منNavigationVehicleReporter.)جافا
RidesharingVehicleReporter vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter();Kotlin
val vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter()
ملاحظات حول طبقة المقابس الآمنة/طبقة النقل الآمنة
داخليًا، يستخدم تنفيذ حزمة تطوير البرامج (SDK) للسائقين طبقة المقابس الآمنة/طبقة النقل الآمنة للتواصل بأمان مع خدمة Fleet Engine. قد تتطلّب إصدارات Android API 23 أو الإصدارات الأقدم تصحيح SecurityProvider للتواصل مع الخادم. لمزيد من المعلومات حول استخدام طبقة المقابس الآمنة في Android، يُرجى الاطّلاع على
موفّر خدمات أمان خدمات Google للأجهزة الجوّالة.
تحتوي المقالة أيضًا على نماذج للتعليمات البرمجية لتصحيح موفّر الأمان.