Referência de estrutura FlpLocationInterface

Campos de dados
Referência de estrutura FlpLocationInterface

#include < fused_location.h >

Campos de dados

tamanho_t tamanho
interno(* init )( FlpCallbacks *retornos de chamada)
interno(* get_batch_size )()
interno(* start_batching )(int id, FlpBatchOptions *opções)
interno(* update_batching_options )(int id, FlpBatchOptions *new_options)
interno(* stop_batching )(int id)
vazio(* limpar )()
vazio(* get_batched_location )(int last_n_locations)
interno(* inject_location )( FlpLocation *localização)
const vazio *(* get_extension )(const char *nome)
vazio(* flush_batched_locations )()

Descrição detalhada

Representa a interface FLP padrão.

Definição na linha 321 do arquivo fused_location.h .

Documentação de campo

vazio(* limpeza)()

Fecha a interface. Se alguma operação em lote estiver em andamento, ela deverá ser interrompida.

Definição na linha 398 do arquivo fused_location.h .

void(*flush_batched_locations)()

Recupere todos os locais em lote armazenados atualmente e limpe o buffer. flp_location_callback DEVE ser chamado em resposta, mesmo se não houver locais para liberar (nesse caso num_locations deve ser 0). As chamadas subsequentes para get_batched_location ou flush_batched_locations não devem retornar nenhum dos locais retornados nesta chamada.

Definição na linha 436 do arquivo fused_location.h .

int(* get_batch_size)()

Retorna o tamanho do lote (em número de objetos FlpLocation ) disponível no hardware. Observe que diferentes implementações de HW podem ter diferentes tamanhos de amostra. Isso retornará o número de amostras definidas no formato de FlpLocation . Isso será usado pela camada superior para decidir o intervalo de lote e se o AP deve ser ativado ou não.

Definição na linha 343 do arquivo fused_location.h .

void(* get_batched_location)(int last_n_locations)

Obtenha o local fundido que foi agrupado. flp_location_callback é usado para retornar a localização. O objeto de localização é eliminado do buffer somente quando o buffer está cheio. Não remova-o do buffer só porque ele foi retornado usando o retorno de chamada. Em outras palavras, quando não há nenhum novo objeto de localização, duas chamadas para get_batched_location(1) devem retornar o mesmo objeto de localização. Parâmetros: last_n_locations – Número de locais a serem obtidos. Isso pode ser um ou vários. Se last_n_locations for 1, você obterá o último local conhecido pelo hardware.

Definição na linha 412 do arquivo fused_location.h .

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

Obtenha um ponteiro para informações de extensão.

Definição na linha 427 do arquivo fused_location.h .

int(* init)( FlpCallbacks *retornos de chamada)

Abre a interface e fornece as rotinas de retorno de chamada para a implementação desta interface. Uma vez chamado, você deve responder chamando flp_capabilities_callback em FlpCallbacks para especificar os recursos que sua implementação suporta.

Definição na linha 333 do arquivo fused_location.h .

int(* inject_location)( FlpLocation *localização)

Injeta a localização atual de outro provedor de localização, a latitude e a longitude são medidas em graus, a precisão esperada é medida em metros Parâmetros: localização - O objeto de localização que está sendo injetado. Valor de retorno: FLP_RESULT_SUCCESS ou FLP_RESULT_ERROR.

Definição na linha 422 do arquivo fused_location.h .

tamanho_t tamanho

definido como sizeof(FlpLocationInterface)

Definição na linha 325 do arquivo fused_location.h .

int(* start_batching)(int id, FlpBatchOptions *opções)

Inicie os locais de lote. Esta API é usada principalmente quando o AP está inativo e o dispositivo pode agrupar locais no hardware. flp_location_callback é usado para retornar os locais. Quando o buffer está cheio e FLP_BATCH_WAKEUP_ON_FIFO_FULL é usado, o AP é ativado. Quando o buffer está cheio e FLP_BATCH_WAKEUP_ON_FIFO_FULL não está definido, o objeto de localização mais antigo é descartado. Neste caso o AP não será acordado. A camada superior usará a API get_batched_location para solicitar explicitamente a localização. Se FLP_BATCH_CALLBACK_ON_LOCATION_FIX estiver definido, a implementação chamará flp_location_callback sempre que houver uma correção de localização. Isso substitui a configuração do sinalizador FLP_BATCH_WAKEUP_ON_FIFO_FULL. É responsabilidade das camadas superiores (chamador) desligá-lo, caso saiba que o AP pode entrar em hibernação. Isto é útil para aplicações de navegação quando o sistema está no modo de alta potência. Parâmetros: id - Id da solicitação. opções - Consulte a definição da estrutura FlpBatchOptions . Valor de retorno: FLP_RESULT_SUCCESS em caso de sucesso, FLP_RESULT_INSUFFICIENT_MEMORY, FLP_RESULT_ID_EXISTS, FLP_RESULT_ERROR em caso de falha.

Definição na linha 367 do arquivo fused_location.h .

int(* stop_batching)(int id)

Pare de agrupar. Parâmetros: id - Id da solicitação. Valor de retorno: FLP_RESULT_SUCCESS em caso de sucesso, FLP_RESULT_ID_UNKNOWN ou FLP_RESULT_ERROR em caso de falha.

Definição na linha 392 do arquivo fused_location.h .

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

Atualize FlpBatchOptions associado a uma solicitação em lote. Quando uma operação em lote estiver em andamento e uma opção de lote como FLP_BATCH_WAKEUP_ON_FIFO_FULL precisar ser atualizada, esta API será usada. Por exemplo, isso pode acontecer quando o AP está ativo e o aplicativo de mapas está sendo usado. Parâmetros: id - ID de uma solicitação em lote existente. new_options - Valor de retorno de FlpBatchOptions atualizado: FLP_RESULT_SUCCESS em caso de sucesso, FLP_RESULT_ID_UNKNOWN, FLP_RESULT_ERROR em caso de erro.

Definição na linha 382 do arquivo fused_location.h .

A documentação desta estrutura foi gerada a partir do seguinte arquivo: