Tham chiếu cấu trúc giao diện FlpLocation

Trường dữ liệu
Tham chiếu cấu trúc giao diện FlpLocation

#include < fused_location.h >

Trường dữ liệu

kích thước_t kích cỡ
int(* init )( FlpCallbacks *gọi lại)
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)
khoảng trống(* dọn dẹp )()
khoảng trống(* get_batched_location )(int Last_n_locations)
int(* tiêm_location )( FlpLocation *vị trí)
const void *(* get_extension )(const char *name)
khoảng trống(* Flush_batched_locations )()

miêu tả cụ thể

Đại diện cho giao diện FLP tiêu chuẩn.

Định nghĩa tại dòng 321 của file fused_location.h .

Tài liệu hiện trường

void(* dọn dẹp)()

Đóng giao diện. Nếu bất kỳ hoạt động hàng loạt nào đang được tiến hành, chúng phải được dừng lại.

Định nghĩa tại dòng 398 của file fused_location.h .

void(* Flush_batched_locations)()

Truy xuất tất cả các vị trí theo lô hiện được lưu trữ và xóa bộ đệm. flp_location_callback PHẢI được gọi để phản hồi, ngay cả khi không có vị trí nào cần xóa (trong trường hợp đó num_locations phải bằng 0). Các cuộc gọi tiếp theo tới get_batched_location hoặc Flush_batched_locations sẽ không trả về bất kỳ vị trí nào được trả về trong cuộc gọi này.

Định nghĩa tại dòng 436 của file fused_location.h .

int(* get_batch_size)()

Trả về kích thước lô (bằng số lượng đối tượng FlpLocation ) có sẵn trong phần cứng. Lưu ý, việc triển khai CTNH khác nhau có thể có cỡ mẫu khác nhau. Điều này sẽ trả về số lượng mẫu được xác định theo định dạng FlpLocation . Điều này sẽ được lớp trên sử dụng để quyết định khoảng thời gian phân đợt và liệu AP có nên được đánh thức hay không.

Định nghĩa tại dòng 343 của file fused_location.h .

void(* get_batched_location)(int Last_n_locations)

Lấy vị trí hợp nhất đã được gộp lại. flp_location_callback được sử dụng để trả về vị trí. Đối tượng vị trí chỉ bị xóa khỏi bộ đệm khi bộ đệm đầy. Đừng xóa nó khỏi bộ đệm chỉ vì nó đã được trả về bằng lệnh gọi lại. Nói cách khác, khi không có đối tượng vị trí mới, hai lệnh gọi tới get_batched_location(1) sẽ trả về cùng một đối tượng vị trí. Tham số: Last_n_locations - Số lượng vị trí cần lấy. Đây có thể là một hoặc nhiều. Nếu Last_n_locations là 1, bạn sẽ có được vị trí mới nhất mà phần cứng biết.

Định nghĩa tại dòng 412 của file fused_location.h .

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

Nhận một con trỏ tới thông tin tiện ích mở rộng.

Định nghĩa tại dòng 427 của file fused_location.h .

int(* init)( FlpCallbacks *callbacks)

Mở giao diện và cung cấp các thủ tục gọi lại để triển khai giao diện này. Sau khi được gọi, bạn nên phản hồi bằng cách gọi flp_capabilities_callback trong FlpCallbacks để chỉ định các khả năng mà việc triển khai của bạn hỗ trợ.

Định nghĩa tại dòng 333 của file fused_location.h .

int(* chích_location)( FlpLocation *vị trí)

Việc chèn vị trí hiện tại từ một nhà cung cấp vị trí khác vĩ độ và kinh độ được đo bằng độ, độ chính xác dự kiến ​​được đo bằng mét Tham số: vị trí - Đối tượng vị trí được chèn. Giá trị trả về: FLP_RESULT_SUCCESS hoặc FLP_RESULT_ERROR.

Định nghĩa tại dòng 422 của file fused_location.h .

kích thước_t kích thước

được đặt thành sizeof(FlpLocationInterface)

Định nghĩa tại dòng 325 của file fused_location.h .

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

Bắt đầu phân nhóm các địa điểm. API này chủ yếu được sử dụng khi AP ở chế độ ngủ và thiết bị có thể sắp xếp các vị trí trong phần cứng. flp_location_callback được sử dụng để trả về vị trí. Khi bộ đệm đầy và FLP_BATCH_WAKEUP_ON_FIFO_FULL được sử dụng, AP sẽ được đánh thức. Khi bộ đệm đầy và FLP_BATCH_WAKEUP_ON_FIFO_FULL không được đặt, đối tượng vị trí cũ nhất sẽ bị loại bỏ. Trong trường hợp này AP sẽ không được đánh thức. Lớp trên sẽ sử dụng API get_batched_location để yêu cầu vị trí một cách rõ ràng. Nếu FLP_BATCH_CALLBACK_ON_LOCATION_FIX được đặt, quá trình triển khai sẽ gọi flp_location_callback mỗi khi có bản sửa lỗi vị trí. Điều này ghi đè cài đặt cờ FLP_BATCH_WAKEUP_ON_FIFO_FULL. Trách nhiệm của các lớp trên (người gọi) là tắt nó đi nếu biết rằng AP có thể chuyển sang chế độ ngủ. Điều này rất hữu ích cho các ứng dụng điều hướng khi hệ thống ở chế độ năng lượng cao. Tham số: id - Id cho yêu cầu. tùy chọn - Xem định nghĩa cấu trúc FlpBatchOptions . Giá trị trả về: FLP_RESULT_SUCCESS khi thành công, FLP_RESULT_INSUFFICIENT_MEMORY, FLP_RESULT_ID_EXISTS, FLP_RESULT_ERROR khi thất bại.

Định nghĩa tại dòng 367 của file fused_location.h .

int(* stop_batching)(int id)

Dừng trộn. Tham số: id - Id cho yêu cầu. Giá trị trả về: FLP_RESULT_SUCCESS khi thành công, FLP_RESULT_ID_UNKNOWN hoặc FLP_RESULT_ERROR khi thất bại.

Định nghĩa tại dòng 392 của file fused_location.h .

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

Cập nhật FlpBatchOptions được liên kết với yêu cầu tạo khối. Khi hoạt động tạo khối đang diễn ra và tùy chọn tạo khối như FLP_BATCH_WAKEUP_ON_FIFO_FULL cần được cập nhật, API này sẽ được sử dụng. Chẳng hạn, điều này có thể xảy ra khi AP hoạt động và ứng dụng bản đồ đang được sử dụng. Tham số: id - Id của yêu cầu hàng loạt hiện có. new_options - Giá trị trả về của FlpBatchOptions được cập nhật: FLP_RESULT_SUCCESS nếu thành công, FLP_RESULT_ID_UNKNOWN, FLP_RESULT_ERROR nếu có lỗi.

Định nghĩa tại dòng 382 của file fused_location.h .

Tài liệu cho cấu trúc này được tạo từ tệp sau: