مرجع هيكل FlpLocationInterface

حقول البيانات
مرجع هيكل FlpLocationInterface

#include < fused_location.h >

حقول البيانات

size_t مقاس
كثافة العمليات (* init )( FlpCallbacks *callbacks)
كثافة العمليات (* get_batch_size )()
كثافة العمليات (* start_batching )(معرف int، FlpBatchOptions *options)
كثافة العمليات (* update_batching_options )(معرف كثافة العمليات، FlpBatchOptions *new_options)
كثافة العمليات (* stop_batching )(معرف كثافة العمليات)
فارغ(* تنظيف )()
فارغ(* get_batched_location )(int last_n_locations)
كثافة العمليات (* inject_location )( FlpLocation *location)
ثابت باطل *(* get_extension )(حرف ثابت * الاسم)
فارغ(* Flush_batched_locations )()

وصف تفصيلي

يمثل واجهة FLP القياسية.

التعريف في السطر 321 من الملف fused_location.h .

التوثيق الميداني

باطلة (* تنظيف) ()

يغلق الواجهة إذا كانت هناك أية عمليات مجمعة قيد التقدم، فيجب إيقافها.

التعريف في السطر 398 من الملف fused_location.h .

باطلة (* Flush_batched_locations) ()

استرداد جميع المواقع المجمعة المخزنة حاليًا ومسح المخزن المؤقت. يجب استدعاء flp_location_callback ردًا على ذلك، حتى لو لم تكن هناك مواقع للمسح (في هذه الحالة يجب أن تكون num_locations 0). يجب ألا تُرجع الاستدعاءات اللاحقة إلى get_batched_location أو Flush_batched_locations أيًا من المواقع التي تم إرجاعها في هذه الاستدعاء.

التعريف في السطر 436 من الملف fused_location.h .

كثافة العمليات (* get_batch_size)()

قم بإرجاع حجم الدُفعة (في عدد كائنات FlpLocation ) المتوفرة في الجهاز. لاحظ أن تطبيقات المخلفات الخطرة المختلفة قد يكون لها أحجام عينات مختلفة. يجب أن يُرجع هذا عدد العينات المحددة بتنسيق FlpLocation . سيتم استخدام هذا بواسطة الطبقة العليا لتحديد الفاصل الزمني للتجميع وما إذا كان يجب إيقاظ نقطة الوصول أم لا.

التعريف في السطر 343 من الملف fused_location.h .

باطلة(* get_batched_location)(int last_n_locations)

احصل على الموقع المدمج الذي تم تجميعه. يتم استخدام flp_location_callback لإرجاع الموقع. يتم إسقاط كائن الموقع من المخزن المؤقت فقط عندما يكون المخزن المؤقت ممتلئًا. لا تقم بإزالته من المخزن المؤقت لمجرد أنه تم إرجاعه باستخدام رد الاتصال. بمعنى آخر، في حالة عدم وجود كائن موقع جديد، يجب أن تقوم مكالمتان لـ get_batched_location(1) بإرجاع نفس كائن الموقع. المعلمات: last_n_locations - عدد المواقع المطلوب الحصول عليها. يمكن أن يكون هذا واحدًا أو أكثر. إذا كان last_n_locations هو 1، فستحصل على أحدث موقع معروف للجهاز.

التعريف في السطر 412 من الملف fused_location.h .

const void*(* get_extension)(const char *name)

احصل على مؤشر لمعلومات الامتداد.

التعريف في السطر 427 من الملف fused_location.h .

int(* init)( FlpCallbacks *callbacks)

يفتح الواجهة ويوفر إجراءات رد الاتصال لتنفيذ هذه الواجهة. بمجرد الاتصال، يجب عليك الرد عن طريق استدعاء flp_capabilities_callback في FlpCallbacks لتحديد الإمكانيات التي يدعمها تطبيقك.

التعريف في السطر 333 من الملف fused_location.h .

int(* inject_location)( FlpLocation *location)

يقوم بإدخال الموقع الحالي من مزود موقع آخر ويتم قياس خطوط الطول والعرض بالدرجات ويتم قياس الدقة المتوقعة بالأمتار المعلمات: الموقع - كائن الموقع الذي يتم حقنه. قيمة الإرجاع: FLP_RESULT_SUCCESS أو FLP_RESULT_ERROR.

التعريف في السطر 422 من الملف fused_location.h .

حجم_حجم

تم ضبطه على sizeof (FlpLocationInterface)

التعريف في السطر 325 من الملف fused_location.h .

int(* start_batching)(معرف int، FlpBatchOptions *options)

ابدأ بمواقع التجميع. يتم استخدام واجهة برمجة التطبيقات (API) هذه بشكل أساسي عندما تكون نقطة الوصول في وضع السكون ويمكن للجهاز تجميع المواقع في الأجهزة. يتم استخدام flp_location_callback لإرجاع المواقع. عندما يكون المخزن المؤقت ممتلئًا ويتم استخدام FLP_BATCH_WAKEUP_ON_FIFO_FULL، يتم إيقاظ نقطة الوصول. عندما يكون المخزن المؤقت ممتلئًا ولم يتم تعيين FLP_BATCH_WAKEUP_ON_FIFO_FULL، يتم إسقاط كائن الموقع الأقدم. في هذه الحالة، لن يتم إيقاظ نقطة الوصول. ستستخدم الطبقة العليا واجهة برمجة التطبيقات get_batched_location لطلب الموقع بشكل صريح. إذا تم تعيين FLP_BATCH_CALLBACK_ON_LOCATION_FIX، فسيقوم التنفيذ باستدعاء flp_location_callback في كل مرة يتم فيها إصلاح الموقع. يؤدي هذا إلى تجاوز إعداد العلامة FLP_BATCH_WAKEUP_ON_FIFO_FULL. تقع على عاتق الطبقات العليا (المتصل) مسؤولية إيقاف تشغيله، إذا علمت أن نقطة الوصول قد تدخل في وضع السكون. يعد هذا مفيدًا لتطبيقات الملاحة عندما يكون النظام في وضع الطاقة العالية. المعلمات: معرف - معرف الطلب. الخيارات - راجع تعريف بنية FlpBatchOptions . قيمة الإرجاع: FLP_RESULT_SUCCESS عند النجاح، FLP_RESULT_INSUFFICIENT_MEMORY، FLP_RESULT_ID_EXISTS، FLP_RESULT_ERROR عند الفشل.

التعريف في السطر 367 من الملف fused_location.h .

كثافة العمليات (* stop_batching) (معرف كثافة العمليات)

توقف عن الخلط. المعلمات: معرف - معرف الطلب. قيمة الإرجاع: FLP_RESULT_SUCCESS عند النجاح، FLP_RESULT_ID_UNKNOWN أو FLP_RESULT_ERROR عند الفشل.

التعريف في السطر 392 من الملف fused_location.h .

كثافة العمليات (* update_batching_options) (معرف كثافة العمليات، FlpBatchOptions *new_options)

قم بتحديث FlpBatchOptions المرتبط بطلب التجميع. عندما تكون عملية التجميع قيد التقدم ويحتاج خيار التجميع مثل FLP_BATCH_WAKEUP_ON_FIFO_FULL إلى التحديث، سيتم استخدام واجهة برمجة التطبيقات هذه. على سبيل المثال، يمكن أن يحدث هذا عندما تكون نقطة الوصول نشطة ويتم استخدام تطبيق الخرائط. المعلمات: معرف - معرف طلب دفعة موجود. new_options - قيمة إرجاع FlpBatchOptions المحدثة: FLP_RESULT_SUCCESS عند النجاح، FLP_RESULT_ID_UNKNOWN، FLP_RESULT_ERROR عند الخطأ.

التعريف في السطر 382 من الملف fused_location.h .

تم إنشاء وثائق هذه البنية من الملف التالي: