API của Android

API Google Fit cho Android là một phần của Dịch vụ Google Play. Các API Google Fit được hỗ trợ trên Android 4.1 (cấp độ API 16) trở lên. Bằng cách sử dụng các API này, ứng dụng của bạn có thể làm những việc sau:

  • Đọc dữ liệu gần như theo thời gian thực và dữ liệu trong quá khứ, bao gồm cả dữ liệu từ các thiết bị Bluetooth năng lượng thấp (BLE).
  • Ghi lại hoạt động.
  • Liên kết dữ liệu với một phiên.
  • Đặt mục tiêu thể chất.

Đọc dữ liệu cảm biến

Nếu ứng dụng của bạn cung cấp thông tin về hoạt động của người dùng (chẳng hạn như số bước chân hằng ngày), thì ứng dụng đó có thể hiển thị dữ liệu gần như theo thời gian thực về các chuyển động của người dùng. Sensors API cung cấp quyền truy cập vào các luồng dữ liệu thô chứa thông tin này. Dữ liệu có thể đến từ các cảm biến có trên thiết bị chạy Android cũng như từ các cảm biến trong thiết bị đồng hành, chẳng hạn như thiết bị đeo.

Dữ liệu bản ghi

Nếu ứng dụng của bạn cần thu thập, lưu trữ và đồng bộ hoá dữ liệu về hoạt động thể chất của người dùng, bạn có thể sử dụng Recording API. API này lưu trữ dữ liệu về sức khoẻ và sức khoẻ tinh thần bằng cách sử dụng các gói thuê bao. Ứng dụng của bạn chỉ định một hoặc nhiều loại hoạt động cần ghi lại. Sau đó, Google Fit sẽ lưu trữ dữ liệu thuộc các loại được chỉ định ở chế độ nền ngay cả khi ứng dụng của bạn không chạy. Dịch vụ này cũng khôi phục các gói thuê bao này khi hệ thống khởi động lại.

Sơ đồ Google Fit
Hình 1. Google Fit trên Android.

Dữ liệu trong quá khứ

Nếu muốn người dùng có thể xem dữ liệu thể chất từ các hoạt động trước đây, bạn có thể sử dụng History API. API này cung cấp quyền truy cập vào dữ liệu lịch sử về sức khoẻ và tinh thần, đồng thời cho phép các ứng dụng thực hiện thao tác hàng loạt, chẳng hạn như chèn, xoá và đọc dữ liệu.

Phiên

Dữ liệu về thể chất có thể mang lại lợi ích cho chính dữ liệu đó, nhưng dữ liệu sẽ hữu ích hơn khi bạn kết hợp dữ liệu đó với thông tin bổ sung về hoạt động của người dùng. Sessions API (API Phiên) sẽ kết hợp dữ liệu sức khoẻ và thể chất, cùng với một số siêu dữ liệu, thành các đơn vị gọi là phiên. Phiên hoạt động biểu thị khoảng thời gian người dùng thực hiện một hoạt động thể chất.

Xem và đặt mục tiêu

Ứng dụng của bạn có thể giúp thúc đẩy người dùng bằng cách cho họ biết hoạt động thể dục của họ so với mục tiêu mà họ đã đặt ra. Goals API giúp ứng dụng của bạn cho người dùng thấy các mục tiêu về sức khoẻ và thể chất mà họ đã tạo.