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à thể chất để 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 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 cho 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 đưa đường liên kết trực tiếp đến ứng dụng Fit vào giao diện người dùng, thì bạn nên tham khảo 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 API Bản ghi Fit để 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 gói 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 hoặc nguồn dữ liệu thể dục cụ thể, và 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ừ API Bản ghi Fit:

Điện thoại Wear
  1. Để tiếp tục hiển thị dữ liệu về các bước trên máy trong ứng dụng, hãy triển khai tính năng thu thập dữ liệu bằng API ghi trên thiết bị di động.
  2. Để hiển thị tổng số bước, bao gồm cả hệ thống tổng hợp các 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 loại này.

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

API nhật ký 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 sức khoẻ và tinh thần trước đây.

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

Đ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 dành cho thiết bị di động và không dành cho thiết bị đeo.

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

API Cảm biến 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ừ API cảm biến:

Đ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 bản tóm tắt 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.

API phiên 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:

Đ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 dành cho thiết bị 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 phiên: Nhà phát triển nên sử dụng Health Connect với ứng dụng di động 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 họ, 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.

Điện thoại Wear
Không có API thay thế. Không có API thay thế.

Ứng dụng sử dụng API BLE

Ứ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.

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

Đ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 phù hợp

Phần sau đây cho bạn biết 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 Hoạt động với các ứng dụng Google Fit), thì 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 phần này để cung cấp thông tin về thời điểm ngừng sử dụng tính năng tích hợp ứng dụng Fit và các 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.

kiểm traLàm việc này đó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 các lợi ích cho người dùng 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 khỏ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ích hợp Health Connect.

Health Connect cung cấp cho bạn quyề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ẻ một cách an toàn giữa các ứng dụng mà người dùng cho phép, giúp dữ liệu trở nên riêng tư và an toàn.

đánh dấuLàm việc này đó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.