GpsGeofencing התייחסות למבנה ממשק

שדות נתונים
GpsGeofencing התייחסות למבנה ממשק

#include < gps.h >

שדות נתונים

size_t גודל
בָּטֵל(* init ) ( GpsGeofenceCallbacks * callbacks)
בָּטֵל(* add_geofence_area ) (int32_t geofence_id, קו רוחב כפול, קו אורך כפול, רדיוס_מטרים כפול, int_transition_transition, int monitor_transitions, int
בָּטֵל(* pause_geofence ) (int32_t geofence_id)
בָּטֵל(* resume_geofence ) (int32_t geofence_id, int monitor_transitions)
בָּטֵל(* remove_geofence_area ) (int32_t geofence_id)

תיאור מפורט

ממשק מורחב לתמיכה ב- GPS_Geofencing

הגדרה בשורה 1361 בקובץ gps.h.

תיעוד בשטח

void (* add_geofence_area) (int32_t geofence_id, קו רוחב כפול, קו אורך כפול, מטר רדיוס כפול, int last_transition, int monitor_transitions, int notification_responsiveness_ms, int unknown_timer_ms)

הוסף אזור גדר גדר. ממשק API זה תומך כרגע בגדרות גיאוריות מעגליות. פרמטרים: geofence_id - המזהה עבור geofence. אם כבר קיים גדר עם מזהה זה, יש להחזיר ערך שגיאה (GPS_GEOFENCE_ERROR_ID_EXISTS). קו רוחב, אורך, רדיוס_מטרים - הרוחב, האורך והרדיוס (במטרים) למעבר הגיאוגרפי האחרון - המצב הנוכחי של הגדר. לדוגמא, אם המערכת כבר יודעת שהמשתמש נמצא בתוך הגדר הגיאוגרפית, זה יוגדר ל- GPS_GEOFENCE_ENTERED. ברוב המקרים, זה יהיה GPS_GEOFENCE_UNCERTAIN. monitor_transition - אילו מעברים לפקח. סיבית או של GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED ו- GPS_GEOFENCE_UNCERTAIN. notification_responsiveness_ms - מגדיר את תיאור המאמץ הטוב ביותר של כמה זמן צריך להתקשר להתקשרות חוזרת כאשר מופעל המעבר המשויך לגיאופנס . לדוגמא, אם מוגדר ל- 1000 מילישניות עם GPS_GEOFENCE_ENTERED, יש לקרוא להתקשרות החוזרת 1000 אלפיות השנייה תוך הכניסה לגדר הגדר. פרמטר זה מוגדר באלפיות השנייה. הערה: אין להתבלבל עם הקצב שבו ה- GPS נחקר. מקובל לשנות באופן דינמי את קצב הדגימה של ה- GPS מטעמי חיסכון בחשמל; לפיכך קצב הדגימה עשוי להיות מהיר או איטי מזה. unknown_timer_ms - מגבלת הזמן שאחריה יש להפעיל את המעבר UNCERTAIN. פרמטר זה מוגדר באלפיות השנייה. ראה הסבר מפורט לעיל לעיל.

הגדרה בשורה 1400 של קובץ gps.h.

void (* init) ( GpsGeofenceCallbacks * callbacks)

פותח את ממשק הגיאופנס ומספק את שגרות ההחזרה ליישום ממשק זה.

הגדרה בשורה 1369 בקובץ gps.h.

בטל (* pause_geofence) (int32_t geofence_id)

השהה את המעקב אחר גדר גדר מסוימת. פרמטרים: geofence_id - המזהה עבור geofence.

הגדרה בשורה 1409 בקובץ gps.h.

בטל (* remove_geofence_area) (int32_t geofence_id)

הסר אזור גדר גדר. לאחר חזרת הפונקציה, אין לשלוח התראות. פרמטר: geofence_id - המזהה עבור geofence.

הגדרה בשורה 1429 בקובץ gps.h.

void (* resume_geofence) (int32_t geofence_id, int monitor_transitions)

המשך לפקח על גדר גדר מסוימת. פרמטרים: geofence_id - המזהה עבור geofence. monitor_transitions - אילו מעברים לפקח. סיבית או של GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED ו- GPS_GEOFENCE_UNCERTAIN. זה מחליף את הערך המשויך המסופק בשיחת add_geofence_area.

הגדרה בשורה 1421 בקובץ gps.h.

size_t size

הגדר לגודל (GpsGeofencingInterface)

הגדרה בשורה 1363 בקובץ gps.h.

התיעוד למבנה זה נוצר מהקובץ הבא:
  • חומרה / libhardware / include / hardware / gps.h