FlpLocationInterface 構造体のリファレンス

データフィールド
FlpLocationInterface 構造体のリファレンス

#include < fused_location.h >

データフィールド

サイズ_tサイズ
int(* init )( FlpCallbacks *コールバック)
int(* get_batch_size )()
int(* start_batching )(int id, FlpBatchOptions *オプション)
int(* update_batching_options )(int id, FlpBatchOptions *new_options)
int(* stop_batching )(int id)
空所（*掃除）（）
空所（* get_batched_location )(int last_n_locations)
int(* inject_location )( FlpLocation *location)
const void *(* get_extension )(const char *name)
空所（* flash_batched_locations )()

詳細な説明

標準の FLP インターフェイスを表します。

ファイルfused_location.hの321行目の定義。

フィールドドキュメント

void(* クリーンアップ)()

インターフェースを閉じます。バッチ操作が進行中の場合は、停止する必要があります。

ファイルfused_location.hの398行目の定義。

void(* flash_batched_locations)()

現在保存されているバッチ化された場所をすべて取得し、バッファをクリアします。フラッシュする場所がない場合でも、応答として flp_location_callback を呼び出さなければなりません (この場合、num_locations は 0 でなければなりません)。後続の get_batched_location または flash_batched_locations の呼び出しでは、この呼び出しで返された場所を返さないでください。

ファイルfused_location.hの436行目の定義。

int(* get_batch_size)()

ハードウェアで使用可能なバッチ サイズ ( FlpLocationオブジェクトの数) を返します。ハードウェア実装が異なれば、サンプル サイズも異なる場合があることに注意してください。これは、 FlpLocationの形式で定義されたサンプルの数を返します。これは、バッチ処理間隔と AP をウェイクアップするかどうかを決定するために、上位層によって使用されます。

ファイルfused_location.hの343行目の定義。

void(* get_batched_location)(int last_n_locations)

バッチ化された融合位置を取得します。 flp_location_callback は、位置を返すために使用されます。位置オブジェクトは、バッファーがいっぱいの場合にのみバッファーから削除されます。コールバックを使用して返されたからといってバッファから削除しないでください。つまり、新しい位置オブジェクトがない場合、get_batched_location(1) を 2 回呼び出すと同じ位置オブジェクトが返されるはずです。パラメータ: last_n_locations - 取得する場所の数。これは 1 つまたは複数にすることができます。 last_n_locations が 1 の場合、ハードウェアが認識している最新の場所を取得します。

ファイルfused_location.hの412行目の定義。

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

拡張情報へのポインタを取得します。

ファイルfused_location.hの427行目の定義。

int(* init)( FlpCallbacks *コールバック)

インターフェイスを開き、このインターフェイスの実装にコールバック ルーチンを提供します。呼び出されたら、 FlpCallbacksの flp_capabilities_callback を呼び出して応答し、実装がサポートする機能を指定する必要があります。

ファイルfused_location.hの333行目の定義。

int(* inject_location)( FlpLocation *location)

別の位置プロバイダーから現在の位置を挿入します。緯度と経度は度で測定されます。期待される精度はメートルで測定されます。 パラメーター: location - 挿入される位置オブジェクト。戻り値: FLP_RESULT_SUCCESS または FLP_RESULT_ERROR。

ファイルfused_location.hの422行目の定義。

size_t サイズ

sizeof(FlpLocationInterface) に設定します

ファイルfused_location.hの325行目の定義。

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

場所のバッチ処理を開始します。この API は主に、AP がスリープ状態で、デバイスがハードウェア内の位置をバッチ処理できるときに使用されます。 flp_location_callback は場所を返すために使用されます。バッファがいっぱいで FLP_BATCH_WAKEUP_ON_FIFO_FULL が使用されると、AP がウェイクアップされます。バッファがいっぱいで FLP_BATCH_WAKEUP_ON_FIFO_FULL が設定されていない場合、最も古い位置オブジェクトが削除されます。この場合、AP は起動されません。上位層は get_batched_location API を使用して明示的に場所を要求します。 FLP_BATCH_CALLBACK_ON_LOCATION_FIX が設定されている場合、実装は位置修正があるたびに flp_location_callback を呼び出します。これは FLP_BATCH_WAKEUP_ON_FIFO_FULL フラグ設定をオーバーライドします。 AP がスリープ状態になる可能性があることがわかっている場合、AP をオフにするのは上位層 (呼び出し側) の責任です。これは、システムが高電力モードにある場合のナビゲーション アプリケーションに役立ちます。パラメータ: id - リクエストの ID。オプション - FlpBatchOptions構造体の定義を参照してください。戻り値: 成功した場合は FLP_RESULT_SUCCESS、失敗した場合は FLP_RESULT_INSUFFICIENT_MEMORY、FLP_RESULT_ID_EXISTS、FLP_RESULT_ERROR。

ファイルfused_location.hの367行目の定義。

int(* stop_batching)(int id)

バッチ処理を停止します。パラメータ: id - リクエストの ID。戻り値: 成功した場合は FLP_RESULT_SUCCESS、失敗した場合は FLP_RESULT_ID_UNKNOWN または FLP_RESULT_ERROR。

ファイルfused_location.hの392行目の定義。

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

バッチリクエストに関連付けられたFlpBatchOptionsを更新します。バッチ操作が進行中で、FLP_BATCH_WAKEUP_ON_FIFO_FULL などのバッチ オプションを更新する必要がある場合、この API が使用されます。たとえば、これは AP が起動していて、マップ アプリケーションが使用されているときに発生する可能性があります。パラメータ: id - 既存のバッチリクエストのID。 new_options - FlpBatchOptionsの更新 戻り値: 成功の場合は FLP_RESULT_SUCCESS、エラーの場合は FLP_RESULT_ID_UNKNOWN、FLP_RESULT_ERROR。

ファイルfused_location.hの382行目の定義。

この構造体のドキュメントは次のファイルから生成されました。