مرجع ساختار FlpLocationInterface

فیلدهای داده
مرجع ساختار FlpLocationInterface

#include < fused_location.h >

فیلدهای داده

اندازه_t اندازه
int(* init ) ( FlpCallbacks *Callbacks)
int(* get_batch_size )()
int(* start_batching )(int id، FlpBatchOptions *گزینه ها)
int(* update_batching_options )(int id، FlpBatchOptions *new_options)
int(* stop_batching )(int id)
خالی(* پاک کردن )()
خالی(* get_batched_location )(int last_n_locations)
int(* inject_location )( FlpLocation *location)
باطل ماندن *(* get_extension )(const char *name)
خالی(* flush_batched_locations )()

توصیف همراه با جزئیات

رابط استاندارد FLP را نشان می دهد.

تعریف در خط 321 فایل fused_location.h .

مستندات میدانی

void(* پاکسازی)()

رابط را می بندد. اگر عملیات دسته ای در حال انجام است، باید متوقف شود.

تعریف در خط 398 فایل fused_location.h .

void(* flush_batched_locations)()

همه مکان‌های دسته‌ای که در حال حاضر ذخیره شده‌اند را بازیابی کنید و بافر را پاک کنید. flp_location_callback باید در پاسخ فراخوانی شود، حتی اگر مکانی برای فلاش وجود نداشته باشد (در این صورت num_locations باید 0 باشد). تماس‌های بعدی به get_batched_location یا flush_batched_locations نباید هیچ یک از مکان‌های بازگردانده شده در این تماس را برگردانند.

تعریف در خط 436 فایل fused_location.h .

int(* get_batch_size)()

اندازه دسته (به تعداد اشیاء FlpLocation ) موجود در سخت افزار را برگردانید. توجه داشته باشید، پیاده سازی های مختلف HW ممکن است اندازه های نمونه متفاوتی داشته باشند. این باید تعداد نمونه های تعریف شده در قالب FlpLocation را برگرداند. این توسط لایه بالایی برای تصمیم گیری در مورد بازه بچینگ و اینکه آیا AP باید بیدار شود یا خیر استفاده می شود.

تعریف در خط 343 فایل fused_location.h .

void(* 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 .

اندازه_t اندازه

روی sizeof (FlpLocationInterface) تنظیم کنید

تعریف در خط 325 فایل fused_location.h .

int(* start_batching)(int id، FlpBatchOptions *گزینه ها)

دسته بندی مکان ها را شروع کنید. این API عمدتاً زمانی استفاده می‌شود که AP در حالت خواب است و دستگاه می‌تواند مکان‌های سخت‌افزاری را دسته‌بندی کند. flp_location_callback برای برگرداندن مکان ها استفاده می شود. هنگامی که بافر پر است و FLP_BATCH_WAKEUP_ON_FIFO_FULL استفاده می شود، AP بیدار می شود. وقتی بافر پر است و FLP_BATCH_WAKEUP_ON_FIFO_FULL تنظیم نشده است، قدیمی ترین شی مکان حذف می شود. در این صورت AP بیدار نخواهد شد. لایه بالایی از get_batched_location API برای درخواست صریح مکان استفاده می کند. اگر FLP_BATCH_CALLBACK_ON_LOCATION_FIX تنظیم شده باشد، پیاده‌سازی هر بار که یک تعمیر مکان وجود داشته باشد، flp_location_callback را فراخوانی می‌کند. این تنظیم پرچم FLP_BATCH_WAKEUP_ON_FIFO_FULL را لغو می کند. این مسئولیت لایه های بالایی (تماس گیرنده) است که آن را خاموش کنند، اگر بدانند که AP ممکن است به خواب برود. هنگامی که سیستم در حالت قدرت بالا است، این برای برنامه های ناوبری مفید است. پارامترها: id - شناسه درخواست. گزینه ها - به تعریف ساختار FlpBatchOptions مراجعه کنید. مقدار بازگشتی: FLP_RESULT_SUCCESS در صورت موفقیت، FLP_RESULT_INSUFFICIENT_MEMORY، FLP_RESULT_ID_EXISTS، FLP_RESULT_ERROR در صورت شکست.

تعریف در خط 367 فایل fused_location.h .

int(* stop_batching)(int id)

دسته بندی را متوقف کنید. پارامترها: id - شناسه درخواست. ارزش بازگشتی: FLP_RESULT_SUCCESS در صورت موفقیت، FLP_RESULT_ID_UNKNOWN یا FLP_RESULT_ERROR در صورت شکست.

تعریف در خط 392 فایل fused_location.h .

int(* update_batching_options)(int id، FlpBatchOptions *new_options)

FlpBatchOptions مرتبط با درخواست دسته‌بندی را به‌روزرسانی کنید. هنگامی که یک عملیات دسته‌بندی در حال انجام است و یک گزینه دسته‌بندی مانند FLP_BATCH_WAKEUP_ON_FIFO_FULL باید به‌روزرسانی شود، از این API استفاده می‌شود. به عنوان مثال، این می تواند زمانی اتفاق بیفتد که AP بیدار است و برنامه نقشه در حال استفاده است. پارامترها: id - شناسه درخواست دسته ای موجود. new_options - به‌روزرسانی‌شده FlpBatchOptions مقدار بازگشتی: FLP_RESULT_SUCCESS در صورت موفقیت، FLP_RESULT_ID_UNKNOWN، FLP_RESULT_ERROR در صورت خطا.

تعریف در خط 382 فایل fused_location.h .

مستندات این ساختار از فایل زیر تولید شده است: