Phiên hoạt động là cách để người dùng nhanh chóng và dễ dàng xem danh sách tất cả các hoạt động mà các em đã thực hiện. Các mục này xuất hiện trên trang nhật ký của ứng dụng Google Fit. Để chẳng hạn như một buổi tập thở, đi bộ, chạy bộ hoặc một giấc ngủ đêm đều ví dụ về một phiên hoạt động.
Tập dữ liệu nhóm phiên trong một khoảng thời gian cụ thể, được thu thập trong một hoạt động. Ví dụ: nếu người dùng theo dõi khi họ bắt đầu và kết thúc 3 km chạy, một phiên có thể được tạo và tất cả dữ liệu thể dục trong khoảng thời gian đó khoảng thời gian (như số bước, tốc độ, quãng đường) sẽ được liên kết với phiên đó.
Bản thân phiên không chứa thông tin chi tiết về hoạt động. Đây là trong tập dữ liệu. Phiên hoạt động có các thuộc tính sau:
- Tên dễ hình dung và dễ làm việc (ví dụ: "chạy buổi sáng")
- Một mô tả
- Giá trị nhận dạng duy nhất
- Loại hoạt động mà thiết bị ghi lại (ví dụ: chạy)
Lợi ích của việc sử dụng phiên
- Hữu ích cho người dùng: Phiên hoạt động giúp bạn sắp xếp dữ liệu hoạt động và các bài tập thể dục trong một có ý nghĩa cho người dùng. Họ có thể xem tất cả hoạt động của mình trong ngày trong Trang nhật ký trong ứng dụng Google Fit.
- Trải nghiệm nhất quán cho người dùng: Nếu ứng dụng hoặc thiết bị đồng hành của bạn cho phép hoạt động theo dõi (nơi người dùng có thể bắt đầu và dừng một hoạt động), tổ chức các phiên hoạt động cho những bài tập thể dục này cho phép người dùng xem hoạt động của họ trên cả hai ứng dụng.
- Dữ liệu đầy đủ hơn: Google Fit cũng hợp nhất dữ liệu từ nhiều để bổ sung và làm phong phú thông tin về phiên của bạn. Điều này giúp người dùng có được thông tin đầy đủ hơn về hoạt động của họ.
- Tận dụng nền tảng Google Fit: Nếu người dùng không theo dõi hoạt động của họ hoặc ứng dụng của bạn không hỗ trợ tính năng theo dõi, bạn vẫn có thể đọc các phiên hoạt động trong Google Fit. Bạn có thể truy vấn dữ liệu chi tiết hoặc dữ liệu tổng hợp từ kho thể dục để tìm các phiên hoạt động hiện có mà không cần triển khai giản đồ riêng bộ nhớ.
- Tăng mức độ tương tác của người dùng: Bạn có thể hiển thị cho người dùng các phiên hiện có và tạo ra chúng. Tương tác với các ứng dụng thể dục khác theo cách này có thể tăng mức độ tương tác của người dùng.
Nhận sự cho phép của người dùng cho phiên
Nếu bạn muốn đọc hoặc ghi phiên, thì ứng dụng của bạn phải nhận được quyền. Quyền truy cập vào các phiên sử dụng cùng một phạm vi uỷ quyền như các loại dữ liệu mà bạn nên yêu cầu như sau:
Android
Chỉ định loại phiên mà ứng dụng của bạn cần truy cập bằng cách sử dụng các phương thức thích hợp từ FitnessOptions
.
Ví dụ: để đọc các phiên liên quan đến việc chạy, bạn có thể chọn:
val fitnessOptions = FitnessOptions.builder()
.accessActivitySessions(FitnessOptions.ACCESS_READ)
.addDataType(DataType.TYPE_HEART_RATE_BPM, FitnessOptions.ACCESS_READ)
.addDataType(DataType.TYPE_SPEED, FitnessOptions.ACCESS_READ)
.addDataType(DataType.TYPE_LOCATION_SAMPLE, FitnessOptions.ACCESS_READ)
.build()
Ví dụ này chỉ định rằng ứng dụng của bạn muốn truy cập siêu dữ liệu phiên hoạt động, đồng thời cũng chỉ định các loại dữ liệu mà ứng dụng muốn đọc trong các phiên đó; các loại dữ liệu nhịp tim, tốc độ và vị trí được sử dụng trong ví dụ này.
REST
Phạm vi yêu cầu như sau:
- Số phiên có các loại hoạt động ngủ:
https://www.googleapis.com/auth/fitness.sleep.read
https://www.googleapis.com/auth/fitness.sleep.write
- Tất cả các phiên khác:
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
Sử dụng phiên
Android
Bạn có thể sử dụng API phiên để:
- Tạo phiên theo thời gian thực
- Chèn phiên tập luyện vào cửa hàng thể dục
- Chèn các phân đoạn hoạt động để hỗ trợ tạm dừng trong khi tập thể dục
- Đọc các phiên và tập dữ liệu liên quan đến phiên hoạt động và tập dữ liệu đó
- Chạy một ứng dụng khác để hiển thị thông tin về phiên mà ứng dụng đó đã tạo
- Nhận ý định khi một ứng dụng khác bắt đầu phiên
Kiến trúc chuyển trạng thái đại diện (REST)
Bạn có thể sử dụng API phiên để:
- Tạo phiên sự kiện theo thời gian thực
- Chèn các phiên vào bộ nhớ các hoạt động thể chất
- Chèn các phân đoạn hoạt động để hỗ trợ việc tạm dừng trong khi tập thể dục
- Đọc các phiên và tập dữ liệu liên quan đến phiên hoạt động và tập dữ liệu đó
Cách tập dữ liệu và phân khúc tương tác với phiên
Trong Google Fit:
- Tập dữ liệu đại diện cho một tập hợp các điểm dữ liệu từ một nguồn dữ liệu cụ thể trong một khoảng thời gian cụ thể. Bạn có thể chèn tập dữ liệu vào của bạn. Nhưng nếu bạn đang tạo một phiên, sẽ dễ dàng hơn nếu bạn tạo phiên hoạt động và tập dữ liệu của phiên hoạt động đó cùng nhau.
- Phân khúc nhóm các tập dữ liệu trong một phiên theo hoạt động chính xác mà người dùng đang thực hiện trong phiên đó. Ví dụ: nếu người dùng theo dõi một lần chạy trong 30 phút (phiên) nhưng đi bộ một chút trong thời gian này, thì hoạt động này có thể được chia thành các phân đoạn. Sẽ có một phân đoạn cho hoạt động chạy, sau đó là thời gian nghỉ đi bộ, sau đó là chạy lại.

Hình 1 cho thấy khoảng thời gian trong cửa hàng thể dục mà các ứng dụng A, B và C đã chèn một số tập dữ liệu và phiên:
- Ứng dụng A đã chèn các tập dữ liệu A1 và A2 cùng với Phiên 1 và A3 một cách độc lập với bất kỳ phiên nào.
- Ứng dụng B đã chèn tập dữ liệu B1 và B2 cùng với Phiên 2.
- Ứng dụng C đã chèn tập dữ liệu C1 một cách độc lập với mọi phiên hoạt động.
Khi đọc dữ liệu phiên từ kho dữ liệu thể dục, tất cả dữ liệu thể dục nằm trong khoảng thời gian của một phiên sẽ tự động được liên kết với phiên đó, ngay cả khi bạn chèn dữ liệu sau khi tạo phiên hoặc tạo phiên sau khi dữ liệu đã được theo dõi thụ động. Ví dụ: truy vấn về thể dục dữ liệu từ Phiên 1 sẽ trả về:
- Tập dữ liệu A1
- Tập dữ liệu A2
- Phần của tập dữ liệu A3 từ t1 đến t2
- Phần của tập dữ liệu C1 giữa t1 và t2
Bạn có thể biết ứng dụng nào đã chèn từng phiên và tập dữ liệu.
Tạo phiên
Bạn có thể tạo phiên hoạt động theo nhiều cách:
- Ứng dụng của bạn có thể chủ động tạo một phiên trong
- trong thời gian thực khi người dùng chủ động theo dõi một hoạt động trên một thiết bị (chỉ Android), hoặc
- bằng cách chèn theo cách thủ công.
- Khi người dùng thêm bài tập thể dục hoặc hoạt động theo cách thủ công trong ứng dụng Google Fit.
Thời điểm tạo phiên
Bạn có đang thêm dữ liệu giấc ngủ không?
- Có – Tạo một phiên tập và chèn thủ công chương trình này vào cửa hàng thể dục. Ví dụ: chèn phiên ngủ. Chiến dịch này là do người dùng có thiết bị hoặc ứng dụng theo dõi giấc ngủ không tương tác với thiết bị để bắt đầu và dừng hoạt động ngủ của chúng (hoạt động này được theo dõi một cách thụ động).
- Không – Ứng dụng của bạn có cho phép người dùng bắt đầu và dừng hoạt động không?
- Không – Không tạo phiên. Chỉ thêm tập dữ liệu từ ứng dụng của bạn.
- Có – Với API Android, hãy tạo một phiên hoạt động theo thời gian thực nếu người dùng theo dõi hoạt động của họ hoặc theo cách thủ công. Với API REST, hãy tạo một phiên và chèn phiên này vào kho dữ liệu thể dục theo cách thủ công.
- Ứng dụng của bạn có phát hiện được thời điểm người dùng đang thực hiện các hoạt động trên
cấp độ chi tiết (ví dụ: đi bộ so với chạy)?
- Có – Thêm phân đoạn.
- Không – Chỉ thêm tập dữ liệu. Bỏ qua các phân đoạn và để Google Fit tạo các phân đoạn này một cách thụ động.
Phiên đọc
Ứng dụng của bạn có thể đọc các phiên hoạt động theo một số cách:
- Tìm một phiên cụ thể mà trình bổ trợ đã tạo/chèn bằng cách sử dụng
- Tên hoặc
- Mã nhận dạng
- Tìm tất cả các phiên mà mã này đã tạo/chèn, theo khoảng thời gian
- Tìm tất cả các phiên hiện có do tất cả các ứng dụng (bao gồm cả Google Fit) tạo ra theo khoảng thời gian
Tìm hiểu xem nguồn nào đã tạo phiên
Bạn có thể cho người dùng biết ứng dụng hoặc thiết bị nào đã tạo ra mỗi phiên của họ. Một có nguồn dữ liệu được liên kết, trong đó có thông tin về ứng dụng hoặc đã thu thập hoặc biến đổi dữ liệu.
Android
Hiện tại, bạn chỉ có thể lấy tên gói của một phiên do ứng dụng Android viết. Để lấy tên gói của ứng dụng đã tạo phiên hoạt động, hãy sử dụng
Phương thức getAppPackageName
. Bạn có thể sử dụng thông tin này trong ứng dụng của mình để cho thấy
người dùng mà các ứng dụng khác đã chèn phiên tập thể dục. Bạn có thể hiển thị biểu tượng cho
mỗi cách này
để giúp người dùng nhận ra các ứng dụng đó.
Bạn cũng có thể kích hoạt intent thành chạy ứng dụng khác để hiển thị thông tin chi tiết về các phiên mà các ứng dụng đó đã tạo. Các ứng dụng khác cũng có thể kích hoạt một ý định để chạy ứng dụng của bạn.
Tìm hiểu thêm về cách tìm nguồn đã tạo phiên.
Kiến trúc chuyển trạng thái đại diện (REST)
Để lấy tên gói của ứng dụng Android đã tạo phiên, hãy sử dụng
Thuộc tính session.application
. Đối với các phiên được tạo bằng
API REST, hãy dùng thuộc tính session.name
. Bạn có thể sử dụng thông tin này trong ứng dụng của mình để cho người dùng biết ứng dụng nào khác đã chèn các phiên tập thể dục. Bạn có thể hiển thị biểu tượng cho từng ứng dụng này để giúp người dùng xác định
chúng.
Tìm hiểu thêm về cách tìm nguồn đã tạo ra .