FlpLocationInterface स्ट्रक्चर का रेफ़रंस

डेटा फ़ील्ड
FlpLocationInterface स्ट्रक्चर का रेफ़रंस

#include < fused_location.h >

डेटा फ़ील्ड

size_t  size
 
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 )()
 

पूरी जानकारी

स्टैंडर्ड FLP इंटरफ़ेस दिखाता है.

परिभाषा, fused_location.h की फ़ाइल के 321 पंक्ति पर दी गई है.

फ़ील्ड का दस्तावेज़

void(* cleanup)()

इंटरफ़ेस को बंद करता है. अगर कोई बैच ऑपरेशन चल रहा है, तो उसे रोक दिया जाना चाहिए.

परिभाषा, फ़ाइल fused_location.h की लाइन 398 पर दी गई है.

void(* flush_batched_locations)()

फ़िलहाल सेव की गई, एक साथ भेजी गई सभी जगहों की जानकारी को वापस पाएं और बफ़र को खाली करें. जवाब में flp_location_callback को ज़रूर कॉल किया जाना चाहिए. भले ही, फ़्लश करने के लिए कोई जगह न हो (इस मामले में num_locations 0 होना चाहिए). get_batched_location या flush_batched_locations के बाद के कॉल में, इस कॉल में मिली जगहों की जानकारी नहीं दिखनी चाहिए.

परिभाषा, फ़ाइल fused_location.h की लाइन 436 पर दी गई है.

int(* get_batch_size)()

हार्डवेयर में उपलब्ध बैच का साइज़ ( FlpLocation ऑब्जेक्ट की संख्या में) दिखाता है. ध्यान दें, अलग-अलग एचडब्ल्यू लागू करने के लिए, सैंपल साइज़ अलग-अलग हो सकते हैं. इससे, FlpLocation फ़ॉर्मैट में तय किए गए सैंपल की संख्या दिखेगी. इसका इस्तेमाल ऊपरी लेयर, बैचिंग इंटरवल तय करने के लिए करेगी. साथ ही, यह भी तय करेगी कि एपी को चालू किया जाना चाहिए या नहीं.

परिभाषा, फ़ाइल fused_location.h की लाइन 343 पर दी गई है.

void(* get_batched_location)(int last_n_locations)

एक साथ भेजी गई जगह की जानकारी पाएं. जगह की जानकारी दिखाने के लिए, flp_location_callback का इस्तेमाल किया जाता है. जगह की जानकारी वाले ऑब्जेक्ट को बफ़र से सिर्फ़ तब हटाया जाता है, जब बफ़र भर जाता है. सिर्फ़ इसलिए इसे बफ़र से न हटाएं, क्योंकि इसे कॉलबैक का इस्तेमाल करके लौटाया गया है. दूसरे शब्दों में, जब कोई नया जगह की जानकारी वाला ऑब्जेक्ट नहीं होता है, तो get_batched_location(1) के दो कॉल से एक ही जगह की जानकारी वाला ऑब्जेक्ट दिखना चाहिए. पैरामीटर: last_n_locations - जगहों की संख्या. यह एक या उससे ज़्यादा हो सकता है. अगर last_n_locations की वैल्यू 1 है, तो आपको हार्डवेयर की जगह की जानकारी मिलती है.

परिभाषा, फ़ाइल fused_location.h की लाइन 412 पर दी गई है.

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

एक्सटेंशन की जानकारी का पॉइंटर पाएं.

परिभाषा, फ़ाइल fused_location.h की लाइन 427 पर दी गई है.

int(* init)( FlpCallbacks *callbacks)

यह इंटरफ़ेस खोलता है और इस इंटरफ़ेस को लागू करने के लिए कॉलबैक रूटीन उपलब्ध कराता है. कॉल आने के बाद, आपको उन सुविधाओं के बारे में बताने के लिए, FlpCallbacks में flp_capabilities_callback को कॉल करके जवाब देना चाहिए जिन पर आपका लागू किया गया वर्शन काम करता है.

परिभाषा, fused_location.h फ़ाइल की लाइन 333 पर दी गई है.

int(* inject_location)( FlpLocation *location)

किसी अन्य जगह की जानकारी देने वाली सेवा से, मौजूदा जगह की जानकारी इंजेक्ट करता है. अक्षांश और देशांतर को डिग्री में मेज़र किया जाता है. जगह की सटीक जानकारी को मीटर में मेज़र किया जाता है. पैरामीटर: जगह - इंजेक्ट किया जा रहा जगह का ऑब्जेक्ट. रिटर्न वैल्यू: FLP_RESULT_SUCCESS या FLP_RESULT_ERROR.

परिभाषा, फ़ाइल fused_location.h की लाइन 422 पर दी गई है.

size_t size

sizeof(FlpLocationInterface) पर सेट करें

परिभाषा, फ़ाइल के fused_location.h 325 पंक्ति पर दी गई है.

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

एक साथ कई जगहों की जानकारी जोड़ना शुरू करें. इस एपीआई का इस्तेमाल मुख्य रूप से तब किया जाता है, जब एपी स्लीप मोड में हो और डिवाइस, हार्डवेयर में जगह की जानकारी को एक साथ भेज सके. जगह की जानकारी दिखाने के लिए, flp_location_callback का इस्तेमाल किया जाता है. जब बफ़र भर जाता है और FLP_BATCH_WAKEUP_ON_FIFO_FULL का इस्तेमाल किया जाता है, तो एपी को जगाया जाता है. जब बफ़र भर जाता है और FLP_BATCH_WAKEUP_ON_FIFO_FULL सेट नहीं होता है, तो सबसे पुराना जगह की जानकारी वाला ऑब्जेक्ट हटा दिया जाता है. इस मामले में, एपी को चालू नहीं किया जाएगा. ऊपरी लेयर, जगह की जानकारी के लिए साफ़ तौर पर पूछने के लिए, get_batched_location API का इस्तेमाल करेगी. अगर FLP_BATCH_CALLBACK_ON_LOCATION_FIX सेट है, तो जगह की जानकारी अपडेट होने पर, flp_location_callback को हर बार कॉल किया जाएगा. यह FLP_BATCH_WAKEUP_ON_FIFO_FULL फ़्लैग की सेटिंग को बदल देता है. अगर ऊपरी लेयर (कॉल करने वाले) को पता है कि एपी स्लीप मोड में जा सकता है, तो उसे बंद करना उसकी ज़िम्मेदारी है. यह तब काम आता है, जब सिस्टम हाई पावर मोड में हो और नेविगेशन ऐप्लिकेशन इस्तेमाल किए जा रहे हों. पैरामीटर: आईडी - अनुरोध का आईडी. विकल्प - 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 - अनुरोध का आईडी. रिटर्न वैल्यू: सफल होने पर 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 जैसे एक साथ कई क्वेरी भेजने के विकल्प को अपडेट करना हो, तो इस एपीआई का इस्तेमाल किया जाएगा. उदाहरण के लिए, ऐसा तब हो सकता है, जब एपी चालू हो और Maps ऐप्लिकेशन का इस्तेमाल किया जा रहा हो. पैरामीटर: id - किसी मौजूदा बैच अनुरोध का आईडी. new_options - अपडेट किए गए FlpBatchOptions रिटर्न वैल्यू: काम करने पर FLP_RESULT_SUCCESS, गड़बड़ी होने पर FLP_RESULT_ID_UNKNOWN, और गड़बड़ी होने पर FLP_RESULT_ERROR.

परिभाषा, fused_location.h फ़ाइल की लाइन 382 पर दी गई है.

इस स्ट्रक्चर का दस्तावेज़, इस फ़ाइल से जनरेट किया गया था: