Bắt đầu trên Android

Hướng dẫn này giải thích cách bắt đầu phát triển bằng Google Fit trên Android.

Lưu ý: Google Fit là một phần của Dịch vụ Google Play. Tìm hiểu về những lợi ích mà ứng dụng của bạn nhận được khi sử dụng Dịch vụ Google Play.

Thiết lập

Trước khi bắt đầu xây dựng ứng dụng, hãy hoàn tất các bước trong các phần sau.

Tạo tài khoản Google

Để sử dụng API Google Fit, bạn cần có Tài khoản Google. Bạn có thể tạo một tài khoản mới hoặc sử dụng một 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 của mình từ góc độ 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ủ phát triển:

1. Mở Android SDK Manager (Trình quản lý SDK Android).
2. Trong phần SDK Tools (Bộ công cụ SDK), hãy tìm Google Play Services (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 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 tải 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 của 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 và thêm thư viện ứng dụng Dịch vụ Google Play làm phần phụ thuộc:

Kotlin DSL

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

...

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

DSL hấp dẫn

apply plugin: 'com.android.application'

...

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

Việc này giúp đảm bảo Gradle tự động tải SDK thể dục xuống khi xây dựng ứng dụng.

Tạo và kiểm thử ứng dụng

Sau khi hoàn tất các bước thiết lập, bạn có thể bắt đầu xây dựng ứng dụng. Để bắt đầu, hãy tìm hiểu về các loại dữ liệu mà ứng dụng của bạn có thể lưu trữ và đọc. Tìm hiểu thêm về cách làm việc với dữ liệu trong Google Fit.

Nhận 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 những 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 trong 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 Google Fit nào, SDK Android sẽ tự động kiểm tra xem các phạm vi đó thuộc về cá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 ứ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. Có các điểm cuối sau:

• SensorsClient: Truy cập vào nhiều nguồn dữ liệu về sức khoẻ thể chất và tinh thần qua những cảm biến phần cứng trên thiết bị cục bộ và trên các thiết bị đồng hành.
• RecordingClient: Dành cho tính năng thu thập dữ liệu cảm biến ở chế độ nền mà vẫn tiết kiệm pin.
• HistoryClient: Chèn, xoá và đọc dữ liệu trong quá khứ trong Google Fit.
• SessionsClient: Tạo và quản lý Phiên của hoạt động của người dùng.
• GoalsClient: Đọc các mục tiêu về Điểm nhịp tim và Số bước do người dùng Google Fit tạo ra.
• 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 ứng dụng Fitness API.

Quy trình uỷ quyền người dùng thu được

Dưới đây là quy trình uỷ quyền mà người dùng gặp phải khi được yêu cầu cấp quyền:

Hình 1. Quy trình uỷ quyền cho người dùng.

1. 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 xuống. Sau khi được tải xuống, ứng dụng của bạn sẽ yêu cầu mọi quyền khi bắt đầu chạy mà ứng dụng đó cần và người dùng cấp hoặc từ chối những quyền đó.
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 sẽ 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 các loại dữ liệu mà ứng dụng muốn truy cập.
4. Đã áp dụng quyền truy cập: Sau khi người dùng cấp quyền, ứng dụng của bạn có thể truy cập vào những loại dữ liệu thuộc phạm vi mà người dùng đã cấp quyền.

Đăng ký xác minh

Sau khi tạo và kiểm thử ứng dụng, bạn cần đăng ký xác minh với nhiều mức độ lý do cần thiết cho phạm vi nhạy cảm và bị hạn chế.