การอ้างอิง Struct GpsGeofencingInterface

ช่องข้อมูล
การอ้างอิง Struct GpsGeofencingInterface

#include < gps.h >

ฟิลด์ข้อมูล

size_t  size
 
void(*  init )( GpsGeofenceCallbacks *callbacks)
 
void(*  add_geofence_area )(int32_t geofence_id, double latitude, double longitude, double radius_meters, int last_transition, int monitor_transitions, int notification_responsiveness_ms, int unknown_timer_ms)
 
void(*  pause_geofence )(int32_t geofence_id)
 
void(*  resume_geofence )(int32_t geofence_id, int monitor_transitions)
 
void(*  remove_geofence_area )(int32_t geofence_id)
 

คำอธิบายโดยละเอียด

อินเทอร์เฟซแบบขยายสำหรับการรองรับ GPS_Geofencing

คําจํากัดความที่บรรทัด 1361 ของไฟล์ gps.h .

เอกสารประกอบในสนาม

void(* add_geofence_area)(int32_t geofence_id, double latitude, double longitude, double radius_meters, int last_transition, int monitor_transitions, int notification_responsiveness_ms, int unknown_timer_ms)

เพิ่มพื้นที่เขตพื้นที่เสมือน ปัจจุบัน API นี้รองรับการกำหนดเขตพื้นที่เสมือนแบบวงกลม พารามิเตอร์: geofence_id - รหัสของเขตพื้นที่เสมือน หากมีการกำหนดเขตพื้นที่เสมือนที่มีรหัสนี้แล้ว ระบบจะแสดงค่าข้อผิดพลาด (GPS_GEOFENCE_ERROR_ID_EXISTS) latitude, longtitude, radius_meters - ละติจูด ลองจิจูด และรัศมี (เป็นเมตร) ของเขตพื้นที่เสมือน last_transition - สถานะปัจจุบันของเขตพื้นที่เสมือน ตัวอย่างเช่น หากระบบทราบว่าผู้ใช้อยู่ภายในเขตพื้นที่เสมือนอยู่แล้ว ระบบจะตั้งค่าเป็น GPS_GEOFENCE_ENTERED ในกรณีส่วนใหญ่จะเป็น GPS_GEOFENCE_UNCERTAIN monitor_transition - การเปลี่ยนสถานะที่จะตรวจสอบ OR แบบบิตของ GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED และ GPS_GEOFENCE_UNCERTAIN notification_responsiveness_ms - กําหนดคําอธิบายแบบพยายามอย่างเต็มที่เกี่ยวกับความรวดเร็วที่ควรเรียกใช้การเรียกกลับเมื่อทริกเกอร์การเปลี่ยนสถานะที่เชื่อมโยงกับ เขตพื้นที่เสมือน (Geofence) เช่น หากตั้งค่าเป็น 1, 000 มิลลิวินาทีด้วย GPS_GEOFENCE_ENTERED ระบบจะเรียกใช้การเรียกกลับ 1, 000 มิลลิวินาทีภายในการเข้าสู่เขตพื้นที่เสมือน พารามิเตอร์นี้กำหนดเป็นมิลลิวินาที หมายเหตุ: อย่าสับสนกับอัตราที่ระบบโพล GPS คุณสามารถเปลี่ยนแปลงอัตราการสุ่มตัวอย่าง GPS แบบไดนามิกเพื่อประหยัดพลังงานได้ ดังนั้นอัตราการสุ่มตัวอย่างจึงอาจเร็วหรือช้ากว่านี้ unknown_timer_ms - ขีดจํากัดเวลาหลังจากที่ควรทริกเกอร์การเปลี่ยนสถานะเป็น UNCERTAIN พารามิเตอร์นี้กำหนดเป็นมิลลิวินาที โปรดดูคำอธิบายโดยละเอียดด้านบน

คําจํากัดความที่บรรทัด 1400 ของไฟล์ gps.h .

void(* init)( GpsGeofenceCallbacks *callbacks)

เปิดอินเทอร์เฟซเขตพื้นที่เสมือนและระบุกิจวัตรการเรียกกลับเพื่อการติดตั้งใช้งานอินเทอร์เฟซนี้

คําจํากัดความที่บรรทัด 1369 ของไฟล์ gps.h .

void(* pause_geofence)(int32_t geofence_id)

หยุดตรวจสอบเขตพื้นที่เสมือนที่เฉพาะเจาะจงชั่วคราว พารามิเตอร์: geofence_id - รหัสของเขตพื้นที่เสมือน

คําจํากัดความที่บรรทัด 1409 ของไฟล์ gps.h .

void(* remove_geofence_area)(int32_t geofence_id)

นำพื้นที่เขตพื้นที่เสมือนออก หลังจากฟังก์ชันแสดงผลแล้ว ระบบจะไม่ส่งการแจ้งเตือน พารามิเตอร์: geofence_id - รหัสของเขตพื้นที่เสมือน

คําจํากัดความที่บรรทัด 1429 ของไฟล์ gps.h .

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

ตรวจสอบเขตพื้นที่เสมือนที่เฉพาะเจาะจงต่อ พารามิเตอร์: geofence_id - รหัสของเขตพื้นที่เสมือน monitor_transitions - การเปลี่ยนสถานะที่จะตรวจสอบ OR แบบบิตไวส์ของ GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED และ GPS_GEOFENCE_UNCERTAIN ค่านี้จะลบล้างค่าที่เชื่อมโยงซึ่งระบุไว้ในการเรียก add_geofence_area

คําจํากัดความที่บรรทัด 1421 ของไฟล์ gps.h .

size_t size

ตั้งค่าเป็น sizeof(GpsGeofencingInterface)

คําจํากัดความที่บรรทัด 1363 ของไฟล์ gps.h .

เอกสารประกอบสำหรับโครงสร้างนี้สร้างขึ้นจากไฟล์ต่อไปนี้
  • hardware/libhardware/include/hardware/ gps.h