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 ứng dụng bằng Google Fit trên Android.

Thiết lập

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

Để sử dụng API Google Fit, 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 để thử nghiệm ứng dụng của bạn từ góc độ của người dùng.

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

  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 Install Packages (Cài đặt gói).

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

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

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:

Kotlin DSLDSL bắt mắt
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.3.0")
}
 
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.3.0'
}

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

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 của mình. Để tải 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 hợp tác với dữ liệu trong Google Fit.

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

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. Để hỏi cho những quyền này, bạn cần phải thêm loại dữ liệu mà ứng dụng của bạn cần quyền truy cập trong một FitnessOptions thực thể khác. Khi ứng dụng của bạn yêu cầu sử dụng bất kỳ dữ liệu nào trên Google Fit loại SDK này sẽ tự động kiểm tra xem chúng thuộc phạm vi nào và đặt câu hỏi người dùng để uỷ quyền cho các phạm vi đó.

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 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: Dùng để thu thập dữ liệu cảm biến ở chế độ nền nhưng 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 Số bước và Điểm nhịp tim do người dùng tạo trong Google Fit.
  • ConfigClient: Truy cập vào các chế độ cài đặt và loại dữ liệu tuỳ chỉnh trong nền tảng Google Fit.

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

Phần sau đây cho thấy quy trình uỷ quyền mà người dùng trải nghiệm 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 thấy các 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 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 sẽ kiểm tra xem các quyền đã được được cấp 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 về phạm vi của 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 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 các loại dữ liệu thuộc phạm vi mà người dùng đã cấp cho.

Đăng ký xác minh

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