اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
مرجع بنية FlpBatchOptions
#include <
fused_location.h
>
الخيارات المتاحة لواجهات برمجة التطبيقات لميزة FLP في وضع الحِزم
التعريف في السطر
258
من الملف
fused_location.h
.
FLP_BATCH_WAKEUP_ON_FIFO_FULL: في حال ضبط هذا الإعداد، ستوقِظ الأجهزة نقطة الوصول عندما يكون المخزن المؤقت ممتلئًا. في حال عدم ضبط هذا الخيار، ستسقط الأجهزة أقدم عنصر موقع جغرافي.
FLP_BATCH_CALLBACK_ON_LOCATION_FIX: في حال ضبط هذا الإعداد، سيتمّ استدعاء دالة الاستدعاء الخاصة بالموقع الجغرافي في كلّ مرّة يتمّ فيها تحديد الموقع الجغرافي. تقع على عاتق الطبقات العليا (المتصل) مسؤولية إيقافه، إذا كانت تعلم أنّ نقطة الوصول قد تنتقل إلى وضع السكون. عندما يكون هذا القسم مفعّلاً أثناء جلسة تجميع، من المفترض أن يستمر التجميع أثناء الإبلاغ عن إصلاحات الموقع الجغرافي في الوقت الفعلي.
علامات أخرى سيتم دمجها باستخدام عملية OR على مستوى الوحدات في المستقبل
التعريف في السطر
284
من الملف
fused_location.h
.
|
double max_power_allocation_mW
|
الحد الأقصى للطاقة بوحدة mW التي يمكن للتنفيذ الأساسي استخدامها في طلب تجميع البيانات هذا. إذا كانت قيمة max_power_allocation_mW هي 0، لن يتم تسجيل سوى الإصلاحات التي يتم إنشاؤها بدون أي تكلفة إضافية للطاقة.
التعريف في السطر
265
من الملف
fused_location.h
.
معدّل تكرار تجميع المواقع الجغرافية بالنانوسثانية
التعريف في السطر
290
من الملف
fused_location.h
.
|
float smallest_displacement_meters
|
أصغر إزاحة بين المواقع الجغرافية المسجّلة بالمتر
في حال ضبطه على 0، عليك الإبلاغ عن المواقع الجغرافية في الفاصل الزمني المطلوب حتى إذا كان الجهاز ثابتًا. إذا كانت الإجابة "نعم"، يمكنك استخدام هذه المَعلمة كإشارة لتوفير الطاقة (مثلاً، الحد من فترة تحديد الموقع الجغرافي إذا لم ينتقل المستخدم بالقرب من الحدّ الأدنى للتنقّل). حتى القيم الإيجابية الصغيرة يمكن تفسيرها على أنّها تعني أنّه ليس عليك احتساب الموقع الجغرافي عندما يكون الجهاز ثابتًا.
ليست هناك حاجة إلى فلترة عرض الإعلانات حسب الموقع الجغرافي استنادًا إلى هذه المَعلمة. يمكن إرسال المواقع الجغرافية حتى إذا كانت لها إزاحة أصغر من المطلوب. يمكن تجاهل هذه المَعلمة بأمان على حساب التوفير المحتمل للطاقة.
التعريف في السطر
307
من الملف
fused_location.h
.
تم إنشاء مستندات هذه البنية من الملف التالي:
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Android Hardware Abstraction Layer: FlpBatchOptions Struct Reference\n\nFlpBatchOptions Struct Reference\n================================\n\n[Data Fields](#pub-attribs) \nFlpBatchOptions Struct Reference \n\n`\n#include \u003c\n`[fused_location.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/fused_location.h)`\n\u003e\n`\n\n|----------|-----------------------------------------------------------------------------------------------------------|\n| Data Fields ----------- ||\n| double | [max_power_allocation_mW](/reference/hal/struct_flp_batch_options#ae300330f3b7cb10809a7e67735e02410) |\n| ||\n| uint32_t | [sources_to_use](/reference/hal/struct_flp_batch_options#a352dd652f7b9c6033433ad53089fe281) |\n| ||\n| uint32_t | [flags](/reference/hal/struct_flp_batch_options#a773b39d480759f67926cb18ae2219281) |\n| ||\n| int64_t | [period_ns](/reference/hal/struct_flp_batch_options#a9d1968cb4382e5653d8d5a31c8a2ee6b) |\n| ||\n| float | [smallest_displacement_meters](/reference/hal/struct_flp_batch_options#a1b30671f2f5bdad79f87fdd30f6bb8a8) |\n| ||\n\n\nDetailed Description\n--------------------\n\n\nOptions with the batching FLP APIs\n\n\nDefinition at line\n[258](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/fused_location.h)\nof file\n[fused_location.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/fused_location.h)\n.\n\nField Documentation\n-------------------\n\n\n|----------------|\n| uint32_t flags |\n\n\nFLP_BATCH_WAKEUP_ON_FIFO_FULL - If set the hardware will wake up the AP when the buffer is full. If not set, the hardware will drop the oldest location object.\n\n\nFLP_BATCH_CALLBACK_ON_LOCATION_FIX - If set the location callback will be called every time there is a location fix. Its the responsibility of the upper layers (caller) to switch it off, if it knows that the AP might go to sleep. When this bit is on amidst a batching session, batching should continue while location fixes are reported in real time.\n\n\nOther flags to be bitwised ORed in the future.\n\n\nDefinition at line\n[284](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/fused_location.h)\nof file\n[fused_location.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/fused_location.h)\n.\n\n|--------------------------------|\n| double max_power_allocation_mW |\n\n\nMaximum power in mW that the underlying implementation can use for this batching call. If max_power_allocation_mW is 0, only fixes that are generated at no additional cost of power shall be reported.\n\n\nDefinition at line\n[265](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/fused_location.h)\nof file\n[fused_location.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/fused_location.h)\n.\n\n|-------------------|\n| int64_t period_ns |\n\n\nFrequency with which location needs to be batched in nano seconds.\n\n\nDefinition at line\n[290](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/fused_location.h)\nof file\n[fused_location.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/fused_location.h)\n.\n\n|------------------------------------|\n| float smallest_displacement_meters |\n\n\nThe smallest displacement between reported locations in meters.\n\n\nIf set to 0, then you should report locations at the requested interval even if the device is stationary. If positive, you can use this parameter as a hint to save power (e.g. throttling location period if the user hasn't traveled close to the displacement threshold). Even small positive values can be interpreted to mean that you don't have to compute location when the device is stationary.\n\n\nThere is no need to filter location delivery based on this parameter. Locations can be delivered even if they have a displacement smaller than requested. This parameter can safely be ignored at the cost of potential power savings.\n\n\nDefinition at line\n[307](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/fused_location.h)\nof file\n[fused_location.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/fused_location.h)\n.\n\n|-------------------------|\n| uint32_t sources_to_use |\n\n\nBitwise OR of the FLP_TECH_MASKS to use\n\n\nDefinition at line\n[268](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/fused_location.h)\nof file\n[fused_location.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/fused_location.h)\n.\n\n*** ** * ** ***\n\nThe documentation for this struct was generated from the following file:\n\n- hardware/libhardware/include/hardware/ [fused_location.h](https://android.googlesource.com/platform/hardware/libhardware/+/master/include/hardware/fused_location.h)"]]
