Referencia de la estructura FlpLocationInterface

Campos de datos
Referencia de la estructura FlpLocationInterface

#include < fused_location.h >

Campos de datos

size_t  tamaño
 
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 )()
 

Descripción detallada

Representa la interfaz FLP estándar.

Definición en la línea 321 del archivo fused_location.h .

Documentación de campos

void(* cleanup)()

Cierra la interfaz. Si hay operaciones por lotes en curso, se deben detener.

Definición en la línea 398 del archivo fused_location.h .

void(* flush_batched_locations)()

Recupera todas las ubicaciones por lotes que se almacenan actualmente y borra el búfer. SE DEBE llamar a flp_location_callback en respuesta, incluso si no hay ubicaciones para borrar (en cuyo caso, num_locations debe ser 0). Las llamadas posteriores a get_batched_location o flush_batched_locations no deberían mostrar ninguna de las ubicaciones que se muestran en esta llamada.

Definición en la línea 436 del archivo fused_location.h .

int(* get_batch_size)()

Muestra el tamaño del lote (en cantidad de objetos FlpLocation ) disponible en el hardware. Ten en cuenta que las diferentes implementaciones de HW pueden tener diferentes tamaños de muestra. Se mostrará la cantidad de muestras definidas en el formato de FlpLocation . La capa superior lo usará para decidir el intervalo de lotes y si se debe activar o no el AP.

Definición en la línea 343 del archivo fused_location.h .

void(* get_batched_location)(int last_n_locations)

Obtén la ubicación combinada que se procesó por lotes. Se usa flp_location_callback para mostrar la ubicación. El objeto de ubicación se descarta del búfer solo cuando este está lleno. No lo quites del búfer solo porque se devolvió con la devolución de llamada. En otras palabras, cuando no hay un objeto de ubicación nuevo, dos llamadas a get_batched_location(1) deben mostrar el mismo objeto de ubicación. Parámetros: last_n_locations: Es la cantidad de ubicaciones que se obtendrán. Puede ser uno o varios. Si last_n_locations es 1, obtienes la ubicación más reciente que conoce el hardware.

Definición en la línea 412 del archivo fused_location.h .

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

Obtén un puntero a la información de la extensión.

Definición en la línea 427 del archivo fused_location.h .

int(* init)( FlpCallbacks *callbacks)

Abre la interfaz y proporciona las rutinas de devolución de llamada a la implementación de esta interfaz. Una vez que se te llame, debes responder llamando a flp_capabilities_callback en FlpCallbacks para especificar las capacidades que admite tu implementación.

Definición en la línea 333 del archivo fused_location.h .

int(* inject_location)( FlpLocation *location)

Inyecta la ubicación actual de otro proveedor de ubicación. La latitud y la longitud se miden en grados, y la precisión esperada se mide en metros. Parámetros: location: Es el objeto de ubicación que se inyecta. Valor que se muestra: FLP_RESULT_SUCCESS o FLP_RESULT_ERROR.

Definición en la línea 422 del archivo fused_location.h .

tamaño de size_t

se establece en sizeof(FlpLocationInterface).

Definición en la línea 325 del archivo fused_location.h .

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

Comienza a agrupar las ubicaciones. Esta API se usa principalmente cuando el AP está inactivo y el dispositivo puede agrupar ubicaciones en el hardware. flp_location_callback se usa para mostrar las ubicaciones. Cuando el búfer está lleno y se usa FLP_BATCH_WAKEUP_ON_FIFO_FULL, se activa el AP. Cuando el búfer está lleno y no se configuró FLP_BATCH_WAKEUP_ON_FIFO_FULL, se descarta el objeto de ubicación más antiguo. En este caso, no se activará el AP. La capa superior usará la API de get_batched_location para solicitar la ubicación de forma explícita. Si se establece FLP_BATCH_CALLBACK_ON_LOCATION_FIX, la implementación llamará a flp_location_callback cada vez que haya una corrección de ubicación. Esto anula la configuración de la marca FLP_BATCH_WAKEUP_ON_FIFO_FULL. Es responsabilidad de las capas superiores (llamante) desactivarlo, si sabe que el AP podría entrar en modo de suspensión. Esto es útil para aplicaciones de navegación cuando el sistema está en modo de alta potencia. Parámetros: id: Es el ID de la solicitud. options: Consulta la definición de la struct FlpBatchOptions . Valor que se muestra: FLP_RESULT_SUCCESS si se realiza correctamente, FLP_RESULT_INSUFFICIENT_MEMORY, FLP_RESULT_ID_EXISTS, FLP_RESULT_ERROR si se produce un error.

Definición en la línea 367 del archivo fused_location.h .

int(* stop_batching)(int id)

Detén el procesamiento por lotes. Parámetros: id: Es el ID de la solicitud. Valor que se muestra: FLP_RESULT_SUCCESS si se realiza correctamente, FLP_RESULT_ID_UNKNOWN o FLP_RESULT_ERROR si se produce un error.

Definición en la línea 392 del archivo fused_location.h .

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

Actualiza FlpBatchOptions asociado con una solicitud por lotes. Cuando se está realizando una operación por lotes y se debe actualizar una opción de lotes, como FLP_BATCH_WAKEUP_ON_FIFO_FULL, se usará esta API. Por ejemplo, esto puede suceder cuando el AP está activo y se usa la aplicación de Maps. Parámetros: id: Es el ID de una solicitud por lotes existente. new_options: Es un objeto FlpBatchOptions actualizado. Valor que se muestra: FLP_RESULT_SUCCESS si se realiza correctamente, FLP_RESULT_ID_UNKNOWN o FLP_RESULT_ERROR si se produce un error.

Definición en la línea 382 del archivo fused_location.h .

La documentación de esta struct se generó a partir del siguiente archivo: