Referencia de estructura de FlpLocationInterface

Referencia de estructura de FlpLocationInterface

#include < fused_location.h >

Campos de información

tamaño_t tamaño
En t(* init )( FlpCallbacks *devoluciones de llamada)
En t(* get_batch_size )()
En t(* start_batching )(int id, FlpBatchOptions *opciones)
En t(* update_batching_options )(int id, FlpBatchOptions *nuevas_opciones)
En t(* stop_batching )(int id)
vacío(* limpiar )()
vacío(* get_batched_location (int últimas_n_ubicaciones)
En t(* inject_location )( FlpLocation *ubicación)
constante nula *(* get_extension )(const char *nombre)
vacío(* ubicaciones_flush_batched )()

Descripción detallada

Representa la interfaz FLP estándar.

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

Documentación de campo

vacío(* limpieza)()

Cierra la interfaz. Si hay alguna operación por lotes en curso, se debe detener.

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

void(* ubicaciones_por lotes)()

Recupere todas las ubicaciones por lotes almacenadas actualmente y borre el búfer. Se DEBE llamar a flp_location_callback en respuesta, incluso si no hay ubicaciones para vaciar (en cuyo caso num_locations debe ser 0). Las llamadas posteriores a get_batched_location o flush_batched_locations no deberían devolver ninguna de las ubicaciones devueltas en esta llamada.

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

int(* get_batch_size)()

Devuelve el tamaño del lote (en número de objetos FlpLocation ) disponible en el hardware. Tenga en cuenta que diferentes implementaciones de HW pueden tener diferentes tamaños de muestra. Esto devolverá el número de muestras definidas en el formato de FlpLocation . Esto será utilizado por la capa superior para decidir el intervalo de procesamiento por lotes y si el AP debe activarse o no.

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

void(* get_batched_location)(int last_n_locations)

Obtenga la ubicación fusionada que se agrupó. flp_location_callback se utiliza para devolver la ubicación. El objeto de ubicación se elimina del búfer solo cuando el búfer está lleno. No lo elimine del búfer solo porque se devolvió mediante la devolución de llamada. En otras palabras, cuando no hay un nuevo objeto de ubicación, dos llamadas a get_batched_location(1) deberían devolver el mismo objeto de ubicación. Parámetros: last_n_locations: número de ubicaciones a obtener. Puede ser uno o varios. Si last_n_locations es 1, obtendrá la última ubicación conocida por el hardware.

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

const void*(* get_extension)(const char *nombre)

Obtenga un puntero a la información de la extensión.

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

int(* init)( FlpCallbacks *devoluciones de llamada)

Abre la interfaz y proporciona las rutinas de devolución de llamada para la implementación de esta interfaz. Una vez llamado, debe responder llamando a flp_capabilities_callback en FlpCallbacks para especificar las capacidades que admite su implementación.

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

int(* inject_location)( FlpLocation *ubicación)

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

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

tamaño_t tamaño

establecido en tamaño de (FlpLocationInterface)

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

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

Inicie el procesamiento por lotes de ubicaciones. Esta API se utiliza principalmente cuando el AP está inactivo y el dispositivo puede agrupar ubicaciones en el hardware. flp_location_callback se utiliza para devolver las ubicaciones. Cuando el búfer está lleno y se usa FLP_BATCH_WAKEUP_ON_FIFO_FULL, el AP se activa. Cuando el búfer está lleno y FLP_BATCH_WAKEUP_ON_FIFO_FULL no está configurado, se descarta el objeto de ubicación más antiguo. En este caso, el AP no se activará. La capa superior utilizará la API get_batched_location para solicitar explícitamente la ubicación. 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 del indicador FLP_BATCH_WAKEUP_ON_FIFO_FULL. Es responsabilidad de las capas superiores (llamante) apagarlo, 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: ID de la solicitud. opciones: consulte la definición de estructura FlpBatchOptions . Valor de retorno: FLP_RESULT_SUCCESS en caso de éxito, FLP_RESULT_INSUFFICIENT_MEMORY, FLP_RESULT_ID_EXISTS, FLP_RESULT_ERROR en caso de error.

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

int(* stop_batching)(int id)

Deje de procesar lotes. Parámetros: id: ID de la solicitud. Valor de retorno: FLP_RESULT_SUCCESS en caso de éxito, FLP_RESULT_ID_UNKNOWN o FLP_RESULT_ERROR en caso de error.

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

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

Actualice FlpBatchOptions asociado con una solicitud de procesamiento por lotes. Cuando una operación de procesamiento por lotes está en progreso y es necesario actualizar una opción de procesamiento por lotes como FLP_BATCH_WAKEUP_ON_FIFO_FULL, se utilizará esta API. Por ejemplo, esto puede suceder cuando el AP está activo y se está utilizando la aplicación de mapas. Parámetros: id: ID de una solicitud por lotes existente. new_options - Valor de retorno de FlpBatchOptions actualizado: FLP_RESULT_SUCCESS en caso de éxito, FLP_RESULT_ID_UNKNOWN, FLP_RESULT_ERROR en caso de error.

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


La documentación para esta estructura se generó a partir del siguiente archivo: