مرجع الفئة GMTDVehicleReporter


نظرة عامة

كائن إرسال المعلومات إلى الواجهة الخلفية لـ Fleet Engine.

استخدِم هذا الصف من سلسلة المحادثات الرئيسية فقط.

وظائف الأعضاء العامين

(void) - updateVehicleState:
 لتعديل حالة المركبة
(void) - addListener:
 إضافة مستمع
(void) - removeListener:
 لإزالة مستمِع.

السمات المحمية

 __pad0__: NSObject <GMSNavigatorListener

المواقع

GMSRoadSnappedLocationProviderListener
BOOL
locationTrackingEnabled
 لا تحتوي هذه الفئة على مهيئات عامة، لذا يمكنك الحصول على هذا الكائن من السمة vehicleReporter في العنصر GMTDDeliveryDriverAPI أو GMTDRidesharingDriverAPI.
NSTimeIntervallocationReportingInterval
 يشير إلى الحد الأدنى للفاصل الزمني الذي يتم خلاله تسليم تقارير المواقع إلى Fleet Engine.

وثائق وظائف الأعضاء

- (باطل) updateVehicleState: (GMTDVehicleState) vehicleState

لتعديل حالة المركبة

يُستخدم لمشاركة الرحلات فقط.

إذا تم ضبط locationTrackingEnabled على "لا"، سيتعذّر ضبط الحالة على GMTDVehicleStateOnline.

سيؤدي ضبط حالة مختلفة إلى إرسال طلب لمرة واحدة إلى الواجهة الخلفية لـ Fleet Engine.

تعدِّل هذه الطريقة حالة من جهة الخادم، ويجب أن يتتبّع تطبيق العميل fleetEngine:didSucceedVehicleUpdate: وfleetEngine:didFailVehicleUpdate:withError: للتأكّد من نجاح العملية أو تعذُّرها. تتم إعادة المحاولة تلقائيًا مع تعذّر إتمام العملية في حال ضبط locationTrackingEnabled على "نعم".

المَعلمات:
vehicleStateالحالة المطلوبة للمركبة
- (void) addListener: (id< GMTDVehicleReporterListener >) مستمع

إضافة مستمع

يتم احتواء المستمع على مرجع ضعيف.

المَعلمات:
أداة معالجة الحدثعنصر متوافق مع البروتوكول GMTDVehicleReporterListener
- (void) removeListener: (id< GMTDVehicleReporterListener >) مستمع

لإزالة مستمِع.

المَعلمات:
أداة معالجة الحدثعنصر متوافق مع البروتوكول GMTDVehicleReporterListener

وثائق بيانات الأعضاء

- GMTDVehicleReporter:

وثائق العقار

- (GMSRoadSnappedLocationProviderListener BOOL) locationTrackingEnabled [read, write, assign]

لا تحتوي هذه الفئة على مهيئات عامة، لذا يمكنك الحصول على هذا الكائن من السمة vehicleReporter في العنصر GMTDDeliveryDriverAPI أو GMTDRidesharingDriverAPI.

يشير إلى ما إذا كان تتبع الموقع الجغرافي مفعَّلاً أم لا.

في حال ضبط هذه السياسة على "نعم"، يتم إرسال تحديثات الرحلات والمركبات إلى الواجهة الخلفية لـ Fleet Engine على فترات منتظمة استنادًا إلى القيمة المضبوطة على locationUpdateInterval.

في حال ضبط هذه السياسة على "لا"، تتوقف التحديثات ويتم إرسال طلب لتحديث المركبة مرة واحدة إلى الواجهة الخلفية لـ Fleet Engine لضبط حالة المركبة على GMTDVehicleStateOffline. راجِع updateVehicleState لمعرفة اعتبارات خاصة حول التعامل مع حالات التعذُّر عند ضبط locationTrackingEnabled على "لا".

- (NSTimeInterval) locationReportingInterval [read, write, assign]

يشير إلى الحد الأدنى للفاصل الزمني الذي يتم خلاله تسليم تقارير المواقع إلى Fleet Engine.

ملاحظة:
الفاصل الزمني التلقائي لإعداد التقارير هو 10 ثوانٍ. يبلغ الحد الأقصى المسموح به للقيمة 60 ثانية والحد الأدنى المسموح به هو 5 ثوانٍ. وفي حال استخدام قيمة خارج هذا النطاق، يتم تطبيق القيمة المطلوبة على ذلك النطاق.