Riferimento alla struttura FlpLocationInterface

Campi dati
Riferimento alla struttura FlpLocationInterface

#include < fused_location.h >

Campi dati

taglia_t misurare
int(* init )( FlpCallbacks *callback)
int(* get_dimensione_batch )()
int(* start_batch )(int id, FlpBatchOptions *opzioni)
int(* update_batching_options )(int id, FlpBatchOptions *new_options)
int(* stop_batching )(int id)
vuoto(* ripulire )()
vuoto(* get_batched_location )(int last_n_locations)
int(* posizione_iniettata )( Posizione_Flp *posizione)
const vuoto *(* get_extension )(const char *nome)
vuoto(* flush_batched_locations )()

Descrizione dettagliata

Rappresenta l'interfaccia FLP standard.

Definizione alla riga 321 del file fused_location.h .

Documentazione sul campo

void(* pulizia)()

Chiude l'interfaccia. Se sono in corso operazioni batch, è necessario interromperle.

Definizione alla riga 398 del file fused_location.h .

void(* flush_batched_locations)()

Recupera tutte le posizioni raggruppate attualmente memorizzate e cancella il buffer. flp_location_callback DEVE essere chiamato in risposta, anche se non ci sono posizioni da svuotare (nel qual caso num_locations dovrebbe essere 0). Le chiamate successive a get_batched_location o flush_batched_locations non dovrebbero restituire nessuna delle posizioni restituite in questa chiamata.

Definizione alla riga 436 del file fused_location.h .

int(* get_batch_size)()

Restituisce la dimensione del batch (in numero di oggetti FlpLocation ) disponibile nell'hardware. Tieni presente che diverse implementazioni HW possono avere dimensioni di campione diverse. Ciò restituirà il numero di campioni definiti nel formato FlpLocation . Questo verrà utilizzato dal livello superiore per decidere l'intervallo di batching e se l'AP deve essere svegliato o meno.

Definizione alla riga 343 del file fused_location.h .

void(* get_batched_location)(int last_n_locations)

Ottieni la posizione fusa che è stata raggruppata. flp_location_callback viene utilizzato per restituire la posizione. L'oggetto posizione viene eliminato dal buffer solo quando il buffer è pieno. Non rimuoverlo dal buffer solo perché è stato restituito utilizzando il callback. In altre parole, quando non è presente un nuovo oggetto posizione, due chiamate a get_batched_location(1) dovrebbero restituire lo stesso oggetto posizione. Parametri: last_n_locations - Numero di posizioni da ottenere. Può essere uno o molti. Se last_n_locations è 1, ottieni l'ultima posizione nota all'hardware.

Definizione alla riga 412 del file fused_location.h .

const void*(* get_extension)(const char *nome)

Ottieni un puntatore alle informazioni sull'estensione.

Definizione alla riga 427 del file fused_location.h .

int(* init)( FlpCallbacks *callbacks)

Apre l'interfaccia e fornisce le routine di callback per l'implementazione di questa interfaccia. Una volta chiamato, dovresti rispondere chiamando flp_capabilities_callback in FlpCallbacks per specificare le funzionalità supportate dalla tua implementazione.

Definizione alla riga 333 del file fused_location.h .

int(* inject_location)( FlpLocation *location)

Inserisce la posizione corrente da un altro provider di posizione: latitudine e longitudine sono misurate in gradi, la precisione prevista è misurata in metri Parametri: posizione: l'oggetto posizione inserito. Valore restituito: FLP_RESULT_SUCCESS o FLP_RESULT_ERROR.

Definizione alla riga 422 del file fused_location.h .

dimensione_t dimensione

impostato su sizeof(FlpLocationInterface)

Definizione alla riga 325 del file fused_location.h .

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

Inizia a raggruppare le posizioni. Questa API viene utilizzata principalmente quando l'AP è in modalità di sospensione e il dispositivo può raggruppare le posizioni nell'hardware. flp_location_callback viene utilizzato per restituire le posizioni. Quando il buffer è pieno e viene utilizzato FLP_BATCH_WAKEUP_ON_FIFO_FULL, l'AP viene riattivato. Quando il buffer è pieno e FLP_BATCH_WAKEUP_ON_FIFO_FULL non è impostato, l'oggetto posizione più vecchio viene eliminato. In questo caso l'AP non verrà svegliato. Il livello superiore utilizzerà l'API get_batched_location per richiedere esplicitamente la posizione. Se FLP_BATCH_CALLBACK_ON_LOCATION_FIX è impostato, l'implementazione chiamerà flp_location_callback ogni volta che viene rilevata una correzione della posizione. Ciò sovrascrive l'impostazione del flag FLP_BATCH_WAKEUP_ON_FIFO_FULL. È responsabilità degli strati superiori (chiamante) spegnerlo, se sa che l'AP potrebbe andare in sospensione. Ciò è utile per le applicazioni di navigazione quando il sistema è in modalità ad alta potenza. Parametri: id - ID per la richiesta. opzioni: vedere la definizione della struttura FlpBatchOptions . Valore restituito: FLP_RESULT_SUCCESS in caso di successo, FLP_RESULT_INSUFFICIENT_MEMORY, FLP_RESULT_ID_EXISTS, FLP_RESULT_ERROR in caso di fallimento.

Definizione alla riga 367 del file fused_location.h .

int(* stop_batching)(int id)

Smettere di raggruppare. Parametri: id - ID per la richiesta. Valore restituito: FLP_RESULT_SUCCESS in caso di successo, FLP_RESULT_ID_UNKNOWN o FLP_RESULT_ERROR in caso di fallimento.

Definizione alla riga 392 del file fused_location.h .

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

Aggiorna FlpBatchOptions associato a una richiesta di raggruppamento. Quando è in corso un'operazione di batch e un'opzione di batch come FLP_BATCH_WAKEUP_ON_FIFO_FULL deve essere aggiornata, verrà utilizzata questa API. Ciò può verificarsi, ad esempio, quando l'AP è attivo e viene utilizzata l'applicazione delle mappe. Parametri: id - ID di una richiesta batch esistente. new_options - FlpBatchOptions aggiornato Valore restituito: FLP_RESULT_SUCCESS in caso di successo, FLP_RESULT_ID_UNKNOWN, FLP_RESULT_ERROR in caso di errore.

Definizione alla riga 382 del file fused_location.h .

La documentazione per questa struttura è stata generata dal seguente file: