การอ้างอิงโครงสร้าง FlpLocationInterface
#include < fused_location.h >
เขตข้อมูล | |
| ขนาด_t | ขนาด |
| อินท์(* | init )( FlpCallbacks *การโทรกลับ) |
| อินท์(* | get_batch_size )() |
| อินท์(* | start_batching )(int id, FlpBatchOptions *ตัวเลือก) |
| อินท์(* | update_batching_options )(int id, FlpBatchOptions *new_options) |
| อินท์(* | stop_batching ) (int id) |
| เป็นโมฆะ(* | ทำความสะอาด )() |
| เป็นโมฆะ(* | get_batched_location ) (int Last_n_locations) |
| อินท์(* | inject_location )( FlpLocation * ตำแหน่ง) |
| const เป็นโมฆะ *(* | get_extension )(const char *ชื่อ) |
| เป็นโมฆะ(* | flush_batched_locations )() |
คำอธิบายโดยละเอียด
แสดงถึงอินเทอร์เฟซ FLP มาตรฐาน
คำจำกัดความที่บรรทัด 321 ของไฟล์ fused_location.h
เอกสารภาคสนาม
| เป็นโมฆะ(* การล้างข้อมูล)() |
ปิดอินเทอร์เฟซ หากการดำเนินการแบบแบตช์ใดๆ อยู่ระหว่างดำเนินการ ควรหยุดการดำเนินการเหล่านั้น
คำจำกัดความที่บรรทัด 398 ของไฟล์ fused_location.h
| เป็นโมฆะ (* flush_batched_locations)() |
ดึงข้อมูลตำแหน่งที่จัดเป็นชุดทั้งหมดที่จัดเก็บอยู่ในปัจจุบันและล้างบัฟเฟอร์ ต้องเรียก flp_location_callback เพื่อตอบสนอง แม้ว่าจะไม่มีตำแหน่งที่จะล้างก็ตาม (ในกรณีนี้ num_locations ควรเป็น 0) การเรียก get_batched_location หรือ flush_batched_locations ครั้งต่อไปไม่ควรส่งคืนตำแหน่งใด ๆ ที่ส่งคืนในการโทรนี้
คำจำกัดความที่บรรทัด 436 ของไฟล์ fused_location.h
| int(* get_batch_size)() |
ส่งกลับขนาดแบตช์ (ในจำนวนวัตถุ FlpLocation ) ที่มีอยู่ในฮาร์ดแวร์ โปรดทราบว่าการใช้งาน HW ที่แตกต่างกันอาจมีขนาดตัวอย่างที่แตกต่างกัน สิ่งนี้จะส่งคืนจำนวนตัวอย่างที่กำหนดในรูปแบบของ FlpLocation ชั้นบนจะใช้สิ่งนี้เพื่อตัดสินใจเกี่ยวกับช่วงเวลาการแบทช์และควรปลุก AP หรือไม่
คำจำกัดความที่บรรทัด 343 ของไฟล์ fused_location.h
| เป็นโมฆะ (* get_batched_location) (int Last_n_locations) |
รับตำแหน่งที่หลอมละลายที่ถูกแบทช์ flp_location_callback ใช้เพื่อส่งคืนตำแหน่ง วัตถุที่ตั้งจะถูกปล่อยจากบัฟเฟอร์เมื่อบัฟเฟอร์เต็มเท่านั้น อย่าลบมันออกจากบัฟเฟอร์เพียงเพราะมันถูกส่งคืนโดยใช้การโทรกลับ กล่าวอีกนัยหนึ่ง เมื่อไม่มีวัตถุตำแหน่งใหม่ การเรียก get_batched_location(1) สองครั้งควรส่งคืนวัตถุตำแหน่งเดียวกัน พารามิเตอร์: Last_n_locations - จำนวนสถานที่ที่จะได้รับ นี่อาจเป็นหนึ่งหรือหลายรายการก็ได้ หาก Last_n_locations เป็น 1 คุณจะได้รับตำแหน่งล่าสุดที่ฮาร์ดแวร์รู้จัก
คำจำกัดความที่บรรทัด 412 ของไฟล์ fused_location.h
| const void*(* get_extension)(const char *ชื่อ) |
รับตัวชี้ไปยังข้อมูลส่วนขยาย
คำจำกัดความที่บรรทัด 427 ของไฟล์ fused_location.h
| int(* init)( FlpCallbacks *โทรกลับ) |
เปิดอินเทอร์เฟซและจัดเตรียมรูทีนการโทรกลับเพื่อใช้งานอินเทอร์เฟซนี้ เมื่อถูกเรียกแล้ว คุณควรตอบกลับด้วยการเรียก flp_capabilities_callback ใน FlpCallbacks เพื่อระบุความสามารถที่การใช้งานของคุณรองรับ
คำจำกัดความที่บรรทัด 333 ของไฟล์ fused_location.h
| int(* inject_location)( FlpLocation *ตำแหน่ง) |
แทรกตำแหน่งปัจจุบันจากผู้ให้บริการตำแหน่งอื่น ละติจูดและลองจิจูดจะวัดเป็นองศา ความแม่นยำที่คาดหวังจะวัดเป็นเมตร พารามิเตอร์: ตำแหน่ง - วัตถุตำแหน่งที่ถูกฉีด ส่งคืนค่า: FLP_RESULT_SUCCESS หรือ FLP_RESULT_ERROR
คำจำกัดความที่บรรทัด 422 ของไฟล์ fused_location.h
| ขนาด_ขนาดt |
ตั้งค่าเป็น sizeof (FlpLocationInterface)
คำจำกัดความที่บรรทัด 325 ของไฟล์ fused_location.h
| int(* start_batching)(int id, FlpBatchOptions *ตัวเลือก) |
เริ่มสถานที่จัดกลุ่ม 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 อาจจะเข้าสู่โหมดสลีป สิ่งนี้มีประโยชน์สำหรับแอปพลิเคชันการนำทางเมื่อระบบอยู่ในโหมดพลังงานสูง พารามิเตอร์: id - รหัสสำหรับคำขอ ตัวเลือก - ดูคำจำกัดความของโครงสร้าง FlpBatchOptions ส่งคืนค่า: FLP_RESULT_SUCCESS เมื่อสำเร็จ, FLP_RESULT_INSUFFICIENT_MEMORY, FLP_RESULT_ID_EXISTS, FLP_RESULT_ERROR เมื่อล้มเหลว
คำจำกัดความที่บรรทัด 367 ของไฟล์ fused_location.h
| int(* stop_batching)(int id) |
หยุดการแบทช์ พารามิเตอร์: id - รหัสสำหรับคำขอ ส่งคืนค่า: FLP_RESULT_SUCCESS เมื่อสำเร็จ FLP_RESULT_ID_UNKNOWN หรือ FLP_RESULT_ERROR เมื่อล้มเหลว
คำจำกัดความที่บรรทัด 392 ของไฟล์ fused_location.h
| int(* update_batching_options)(int id, FlpBatchOptions *new_options) |
อัปเดต FlpBatchOptions ที่เกี่ยวข้องกับคำขอแบทช์ เมื่อการดำเนินการแบทช์อยู่ระหว่างดำเนินการและจำเป็นต้องอัปเดตตัวเลือกการแบทช์ เช่น FLP_BATCH_WAKEUP_ON_FIFO_FULL API นี้จะถูกใช้งาน ตัวอย่างเช่น สิ่งนี้สามารถเกิดขึ้นได้เมื่อ AP ตื่นอยู่และมีการใช้แอปพลิเคชันแผนที่ พารามิเตอร์: id - รหัสของคำขอแบทช์ที่มีอยู่ new_options - อัปเดตค่าส่งคืน FlpBatchOptions : FLP_RESULT_SUCCESS เมื่อสำเร็จ FLP_RESULT_ID_UNKNOWN, FLP_RESULT_ERROR เมื่อเกิดข้อผิดพลาด
คำจำกัดความที่บรรทัด 382 ของไฟล์ fused_location.h
เอกสารประกอบสำหรับโครงสร้างนี้สร้างขึ้นจากไฟล์ต่อไปนี้:
- ฮาร์ดแวร์/libhardware/รวม/ฮาร์ดแวร์/ fused_location.h