Referensi Struct FlpLocationInterface

Referensi Struct FlpLocationInterface

#include < fused_location.h >

Kolom Data

size_t  size
 
int(*  init )( FlpCallbacks *callbacks)
 
int(*  get_batch_size )()
 
int(*  start_batching )(int id, FlpBatchOptions *options)
 
int(*  update_batching_options )(int id, FlpBatchOptions *new_options)
 
int(*  stop_batching )(int id)
 
void(*  cleanup )()
 
void(*  get_batched_location )(int last_n_locations)
 
int(*  inject_location )( FlpLocation *location)
 
const void *(*  get_extension )(const char *name)
 
void(*  flush_batched_locations )()
 

Deskripsi Mendetail

Merepresentasikan antarmuka FLP standar.

Definisi di baris 321 file fused_location.h .

Dokumentasi Bidang

void(* cleanup)()

Menutup antarmuka. Jika ada operasi batch yang sedang berlangsung, operasi tersebut harus dihentikan.

Definisi di baris 398 dari file fused_location.h .

void(* flush_batched_locations)()

Ambil semua lokasi batch yang saat ini disimpan dan hapus buffer. flp_location_callback HARUS dipanggil sebagai respons, meskipun tidak ada lokasi yang akan dihapus (dalam hal ini, num_locations harus 0). Panggilan berikutnya ke get_batched_location atau flush_batched_locations tidak boleh menampilkan lokasi apa pun yang ditampilkan dalam panggilan ini.

Definisi di baris 436 dari file fused_location.h .

int(* get_batch_size)()

Menampilkan ukuran batch (dalam jumlah objek FlpLocation ) yang tersedia di hardware. Perhatikan bahwa implementasi HW yang berbeda mungkin memiliki ukuran sampel yang berbeda. Tindakan ini akan menampilkan jumlah sampel yang ditentukan dalam format FlpLocation . Ini akan digunakan oleh lapisan atas, untuk menentukan interval pengelompokan dan apakah AP harus diaktifkan atau tidak.

Definisi di baris 343 dari file fused_location.h .

void(* get_batched_location)(int last_n_locations)

Dapatkan lokasi gabungan yang dikelompokkan. flp_location_callback digunakan untuk menampilkan lokasi. Objek lokasi dihapus dari buffering hanya jika buffering penuh. Jangan menghapusnya dari buffering hanya karena telah ditampilkan menggunakan callback. Dengan kata lain, jika tidak ada objek lokasi baru, dua panggilan ke get_batched_location(1) akan menampilkan objek lokasi yang sama. Parameter: last_n_locations - Jumlah lokasi yang akan diperoleh. Nilai ini dapat berupa satu atau beberapa. Jika last_n_locations adalah 1, Anda akan mendapatkan lokasi terbaru yang diketahui oleh hardware.

Definisi di baris 412 dari file fused_location.h .

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

Mendapatkan pointer ke informasi ekstensi.

Definisi di baris 427 dari file fused_location.h .

int(* init)( FlpCallbacks *callbacks)

Membuka antarmuka dan menyediakan rutinitas callback ke implementasi antarmuka ini. Setelah dipanggil, Anda harus merespons dengan memanggil flp_capabilities_callback di FlpCallbacks untuk menentukan kemampuan yang didukung implementasi Anda.

Definisi di baris 333 dari file fused_location.h .

int(* inject_location)( FlpLocation *location)

Memasukkan lokasi saat ini dari penyedia lokasi lain lintang dan bujur diukur dalam derajat akurasi yang diharapkan diukur dalam meter Parameter: location - Objek lokasi yang dimasukkan. Nilai yang ditampilkan: FLP_RESULT_SUCCESS atau FLP_RESULT_ERROR.

Definisi di baris 422 dari file fused_location.h .

ukuran size_t

ditetapkan ke sizeof(FlpLocationInterface)

Definisi di baris 325 dari file fused_location.h .

int(* start_batching)(int id, FlpBatchOptions *options)

Mulai mengelompokkan lokasi. API ini terutama digunakan saat AP dalam mode tidur dan perangkat dapat mengelompokkan lokasi di hardware. flp_location_callback digunakan untuk menampilkan lokasi. Saat buffer penuh dan FLP_BATCH_WAKEUP_ON_FIFO_FULL digunakan, AP akan diaktifkan. Jika buffer penuh dan FLP_BATCH_WAKEUP_ON_FIFO_FULL tidak ditetapkan, objek lokasi terlama akan dihapus. Dalam hal ini, AP tidak akan diaktifkan. Lapisan atas akan menggunakan get_batched_location API untuk meminta lokasi secara eksplisit. Jika FLP_BATCH_CALLBACK_ON_LOCATION_FIX ditetapkan, penerapan akan memanggil flp_location_callback setiap kali ada perbaikan lokasi. Tindakan ini akan mengganti setelan flag FLP_BATCH_WAKEUP_ON_FIFO_FULL. Lapisan atas (pemanggil) bertanggung jawab untuk menonaktifkannya, jika mengetahui bahwa AP mungkin akan tidur. Hal ini berguna untuk aplikasi navigasi saat sistem berada dalam mode daya tinggi. Parameter: id - ID untuk permintaan. options - Lihat definisi struct FlpBatchOptions . Nilai yang ditampilkan: FLP_RESULT_SUCCESS jika berhasil, FLP_RESULT_INSUFFICIENT_MEMORY, FLP_RESULT_ID_EXISTS, FLP_RESULT_ERROR jika gagal.

Definisi pada baris 367 dari file fused_location.h .

int(* stop_batching)(int id)

Berhenti melakukan pengelompokan. Parameter: id - ID untuk permintaan. Nilai yang Ditampilkan: FLP_RESULT_SUCCESS jika berhasil, FLP_RESULT_ID_UNKNOWN, atau FLP_RESULT_ERROR jika gagal.

Definisi di baris 392 dari file fused_location.h .

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

Perbarui FlpBatchOptions yang terkait dengan permintaan pengelompokan. Saat operasi pengelompokan sedang berlangsung dan opsi pengelompokan seperti FLP_BATCH_WAKEUP_ON_FIFO_FULL perlu diperbarui, API ini akan digunakan. Misalnya, hal ini dapat terjadi saat AP aktif dan aplikasi peta sedang digunakan. Parameter: id - ID permintaan batch yang ada. new_options - FlpBatchOptions yang diperbarui Nilai yang ditampilkan: FLP_RESULT_SUCCESS jika berhasil, FLP_RESULT_ID_UNKNOWN, FLP_RESULT_ERROR jika terjadi error.

Definisi di baris 382 dari file fused_location.h .


Dokumentasi untuk struct ini dibuat dari file berikut: