Bắt đầu trên Android

Tạo tài khoản Google

Để sử dụng Google Fit API, bạn cần có Tài khoản Google. Bạn có thể tạo tài khoản mới hoặc sử dụng tài khoản hiện có. Bạn nên tạo một tài khoản riêng để kiểm thử ứng dụng theo góc độ của người dùng.

Tải Dịch vụ Google Play

Tải thư viện ứng dụng mới nhất cho Dịch vụ Google Play trên máy chủ lưu trữ phát triển của bạn:

1. Mở Trình quản lý SDK Android.
2. Trong phần SDK Tools (Bộ công cụ SDK), hãy tìm Dịch vụ Google Play.
3. Nếu trạng thái của các gói này không phải là Đã cài đặt, hãy chọn cả hai gói rồi nhấp vào Cài đặt gói.

Nhận mã ứng dụng khách OAuth 2.0

Để bật Fitness API, hãy nhận mã ứng dụng khách OAuth 2.0.

Tạo và định cấu hình dự án

Bạn nên sử dụng môi trường phát triển Android Studio để tạo ứng dụng bằng Fitness API. Để biết thông tin chi tiết về cách tạo một dự án mới và định cấu hình dự án đó trong Android Studio, hãy xem phần Tạo dự án.

Thêm thư viện ứng dụng Dịch vụ Google Play

Trong Android Studio, hãy mở tệp build.gradle cho mô-đun của bạn rồi thêm thư viện ứng dụng Dịch vụ Google Play làm phần phụ thuộc:

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:21.4.0")
}

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.3.0'
    implementation 'com.google.android.gms:play-services-auth:21.4.0'
}

Điều này đảm bảo rằng Gradle tự động tải SDK thể dục xuống khi tạo ứng dụng của bạn.

Lấy các quyền cần thiết trên Android

Để đọc và ghi một số loại dữ liệu, ứng dụng của bạn cần yêu cầu quyền trên Android.

Nhận quyền OAuth

Các loại dữ liệu mà ứng dụng của bạn có quyền truy cập tương ứng với phạm vi uỷ quyền. Để yêu cầu các quyền này, bạn cần thêm những loại dữ liệu mà ứng dụng của bạn cần truy cập vào một thực thể FitnessOptions. Khi ứng dụng của bạn yêu cầu sử dụng bất kỳ loại dữ liệu nào của Google Fit, Android SDK sẽ tự động kiểm tra xem các loại dữ liệu đó thuộc phạm vi nào và yêu cầu người dùng cấp quyền cho các phạm vi đó.

Tạo một ứng dụng API

Tạo một ứng dụng API và thêm các loại dữ liệu mà ứng dụng của bạn cần truy cập để ghi hoặc đọc dữ liệu. Bạn có thể sử dụng các điểm cuối sau:

• SensorsClient: Truy cập vào nhiều nguồn dữ liệu sức khoẻ và chăm sóc sức khoẻ tinh thần từ các cảm biến phần cứng trong thiết bị cục bộ và trong các thiết bị đồng hành.
• RecordingClient: Để thu thập dữ liệu cảm biến ở chế độ nền, luôn bật và tiêu thụ ít năng lượng.
• HistoryClient: Chèn, xoá và đọc dữ liệu trước đây trong Google Fit.
• SessionsClient: Tạo và quản lý Phiên hoạt động của người dùng.
• GoalsClient: Đọc các mục tiêu về Điểm tim và Số bước do người dùng tạo trong Google Fit.
• ConfigClient: Truy cập vào các loại dữ liệu và chế độ cài đặt tuỳ chỉnh trong nền tảng Google Fit.

Xem ví dụ về cách tạo một ứng dụng Fitness API.

Luồng uỷ quyền người dùng thu được

Sau đây là quy trình uỷ quyền mà người dùng sẽ trải qua khi được yêu cầu cấp quyền:

1. Các quyền trên Android: Người dùng sẽ thấy những quyền trên Android mà ứng dụng của bạn đã yêu cầu trước khi tải ứng dụng xuống. Sau khi ứng dụng của bạn được tải xuống, ứng dụng sẽ yêu cầu mọi quyền khi bắt đầu chạy cần thiết và người dùng cấp hoặc từ chối các quyền này.
2. Kiểm tra và kết nối: Ứng dụng của bạn kiểm tra xem các quyền đã được cấp hay chưa trước khi yêu cầu quyền truy cập vào các loại dữ liệu khác.
3. Yêu cầu phạm vi OAuth: Google nhắc người dùng cấp cho ứng dụng của bạn các phạm vi OAuth cần thiết cho những loại dữ liệu mà ứng dụng muốn truy cập.
4. Quyền truy cập được áp dụng: Sau khi người dùng cấp quyền, ứng dụng của bạn có thể truy cập vào các loại dữ liệu thuộc những phạm vi mà người dùng đã cấp quyền.