Hướng dẫn di chuyển

Các API Google Fit sẽ ngừng hoạt động vào năm 2026. Google cung cấp một số sản phẩm và dịch vụ về sức khoẻ và sức khoẻ tổng thể để giúp người dùng tiếp tục đạt được mục tiêu sau khi chúng tôi ngừng cung cấp các sản phẩm và dịch vụ này.

Các nguyên tắc sau đây cho bạn biết dịch vụ nào cần di chuyển dựa trên cách bạn đang sử dụng API Google Fit Android.

Chúng tôi sẽ cập nhật thông tin và hướng dẫn mới nhất trên trang này.

Tích hợp API Fit

Nếu bạn sử dụng một hoặc nhiều API Fit nhưng không thêm đường liên kết trực tiếp đến ứng dụng Fit trong giao diện người dùng, thì bạn cần tuân thủ các nguyên tắc này. Nếu bạn hiển thị Fit trong giao diện người dùng, hãy tham khảo Nguyên tắc tích hợp ứng dụng Fit.

Các ứng dụng sử dụng Fit Recording API để ghi lại số bước

Fit Recording API cho phép ứng dụng yêu cầu lưu trữ tự động dữ liệu cảm biến theo cách tiết kiệm pin bằng cách tạo đăng ký thuê bao. Mỗi gói thuê bao kết nối một ứng dụng Android với một loại dữ liệu cụ thể về hoạt động thể dục hoặc nguồn dữ liệu, đồng thời loại dữ liệu Step thường được dùng để ghi lại số bước.

Hãy làm theo các bước sau để di chuyển từ Fit Recording API:

Bảng 1: Các bước di chuyển từ Fit Recording API
Điện thoại Wear
  1. Để tiếp tục hiển thị dữ liệu về các bước tại địa phương trong ứng dụng, hãy triển khai tính năng thu thập dữ liệu bằng cách sử dụng Recording API trên thiết bị di động.
  2. Để hiện tổng số bước, bao gồm cả hệ thống tổng hợp số bước từ các ứng dụng và thiết bị khác, hãy thêm Health Connect vào ứng dụng của bạn.

Sử dụng Dịch vụ sức khoẻ:

  • PassiveMonitoringClient
  • ExerciseClient

Hãy xem tài liệu về Dịch vụ sức khoẻ để biết thêm thông tin về sự khác biệt giữa hai dịch vụ này.

Ứng dụng sử dụng History API để đọc hoặc ghi dữ liệu vào bộ nhớ các hoạt động thể dục

History API cho phép ứng dụng thực hiện hàng loạt thao tác trên bộ nhớ các hoạt động thể dục. Các thao tác này bao gồm đọc, chèn, cập nhật và xoá dữ liệu lịch sử về sức khoẻ và tinh thần.

Hãy làm theo các bước sau để di chuyển từ History API:

Bảng 2: Các bước di chuyển từ Fit History API
Điện thoại Wear

Thêm Health Connect vào ứng dụng của bạn.

Không có. Dùng Health Connect trong ứng dụng di động và không dành cho thiết bị đeo.

Ứng dụng sử dụng Sensor API để hiển thị dữ liệu thể dục theo thời gian thực

Sensor API cho phép bạn đọc dữ liệu cảm biến thô trong ứng dụng theo thời gian thực. API Cảm biến có chức năng sau:

  • Liệt kê các nguồn dữ liệu có trên thiết bị và trên các thiết bị đồng hành.
  • Đăng ký trình nghe để nhận dữ liệu cảm biến thô.
  • Hủy đăng ký trình nghe để nó không còn nhận được dữ liệu cảm biến thô.

Hãy làm theo các bước sau để di chuyển từ Sensor API:

Bảng 3: Các bước di chuyển từ Fit Sensor API
Điện thoại Wear

Sử dụng Cảm biến, API Trình cung cấp vị trí kết hợp

Sử dụng Dịch vụ sức khoẻ trên Wear OS:

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    Hoặc sử dụng SensorManager, FusedLocationProvider

Các ứng dụng sử dụng Session API để cung cấp thông tin tóm tắt về hoạt động

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.

Session API cho phép ứng dụng tạo phiên trong bộ nhớ các hoạt động thể chất.

Hãy làm theo các bước sau để di chuyển từ Session API:

Bảng 4: Các bước di chuyển từ Fit Session API
Điện thoại Wear

Bắt đầu/dừng: Không áp dụng. Ứng dụng này phải theo dõi trạng thái của các phiên đang diễn ra bên trong.

Đọc/ghi: Thêm Health Connect vào ứng dụng của bạn.

Bắt đầu/dừng: Sử dụng Dịch vụ sức khỏe (ExerciseClient)

Đọc/ghi: Sử dụng Health Connect với ứng dụng di động.

Đối với những quy trình làm việc cụ thể, bạn nên làm như sau:

  • Chèn một phiên: Nhà phát triển nên sử dụng Health Connect với ứng dụng di động của họ và chèn ExerciseSessionRecord hoặc SleepSessionRecord cho phù hợp.

Ứng dụng sử dụng API Mục tiêu

Mục tiêu là các đích cần thực hiện trong ứng dụng Google Fit mà người dùng có thể đặt cho các chỉ số của mình, chẳng hạn như số bước và điểm nhịp tim. Nền tảng Fit ghi lại mục tiêu và theo dõi hoạt động hằng ngày của họ so với các mục tiêu đó bằng cách sử dụng API mục tiêu.

Bảng 5: Hướng dẫn di chuyển cho Fit Goals API
Điện thoại Wear
Không có API thay thế. Không có API thay thế.

Các ứng dụng sử dụng BLE API

Ứng dụng của bạn có thể tìm các thiết bị Bluetooth năng lượng thấp (BLE) và chèn dữ liệu cảm biến vào nền tảng Google Fit bằng API BLE.

Làm theo các bước sau để di chuyển từ BLE API:

Bảng 6: Các bước di chuyển từ API BLE của Fit
Điện thoại Wear
Sử dụng trực tiếp API Android Bluetooth. Sử dụng trực tiếp API Android Bluetooth.

Tích hợp ứng dụng Fit

Sau đây là cách tích hợp ứng dụng Fit tuỳ thuộc vào việc bạn có người dùng hiện tại hay người dùng mới cho ứng dụng của mình.

Người dùng hiện tại của ứng dụng

Nếu giao diện người dùng của ứng dụng có cách để người dùng kết nối với Google Fit (hoặc nếu ứng dụng của bạn có trong danh sách Các ứng dụng hoạt động với Google Fit), bạn có thể tiếp tục duy trì việc tích hợp ứng dụng Fit cho người dùng hiện tại.

Chúng tôi sẽ cập nhật thông tin trong phần này về thời điểm ngừng cung cấp tính năng tích hợp ứng dụng Fit và những lựa chọn tốt nhất để duy trì trải nghiệm người dùng. Trong thời gian chờ đợi, bạn có thể liên hệ với chúng tôi.

Bảng 7: Đề xuất cho người dùng hiện tại có tích hợp ứng dụng Fit
checkDo this đóngKhông nên làm việc này
Cung cấp Health Connect dưới dạng một lựa chọn mới trong ứng dụng của bạn.

Tập trung vào lợi ích của người dùng, chẳng hạn như dữ liệu và thông tin chi tiết phong phú hơn, quyền riêng tư và tính bảo mật.

Đồng bộ hoá với Health Connect

Yêu cầu người dùng ngắt kết nối với Google Fit.

Ngắt kết nối với Health Connect

Người dùng mới của ứng dụng

Để mang lại trải nghiệm tương tự cho người dùng mới của ứng dụng, bạn nên tạo một quy trình tích hợp Health Connect.

Health Connect cho phép bạn truy cập vào các nguồn và loại dữ liệu mới để mang lại trải nghiệm phong phú hơn cho người dùng. Dữ liệu được lưu trữ trên thiết bị và được chia sẻ an toàn giữa các ứng dụng mà người dùng cho phép, đảm bảo tính riêng tư và bảo mật.

Bảng 8: Đề xuất cho người dùng mới có tích hợp ứng dụng Fit
checkDo this đóngKhông nên làm việc này
Thêm Health Connect vào quy trình thiết lập của ứng dụng. Cung cấp Fit dưới dạng một ứng dụng mà người dùng có thể kết nối sau khi Health Connect ra mắt.