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. Chúng xuất hiện trong trang nhật ký của ứng dụng Google Fit. Cho 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ễ mô tả và phù hợp (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 mang lại cho người dùng bức tranh toàn diện 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 làm loại dữ liệu. 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
từ FitnessOptions.
Ví dụ: để đọc các phiên liên quan đến chạy bộ, 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 vào siêu dữ liệu về phiên hoạt động, đồng thời chỉ định các loại dữ liệu mà ứng dụng muốn đọc trong các phiên đó; thời gian tần số tim, tốc độ và vị trí được sử dụng trong ví dụ này.
Kiến trúc chuyển trạng thái đại diện (REST)
Phạm vi yêu cầu như sau:
- Phiên có loại hoạt động ngủ:
https://www.googleapis.com/auth/fitness.sleep.readhttps://www.googleapis.com/auth/fitness.sleep.write
- Tất cả các phiên khác:
https://www.googleapis.com/auth/fitness.activity.readhttps://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 sự kiện theo thời gian thực
- Chèn phiên hoạt động vào cửa hàng thể dục
- Chèn phân đoạn hoạt động để hỗ trợ tạm dừng trong bài 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 phiên hoạt động vào cửa hàng thể dục
- Chèn phân đoạn hoạt động để hỗ trợ tạm dừng trong bài 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 đoạn tương tác với phiên
Trong Google Fit:
- Một Tập dữ liệu đại diện cho tập hợp các điểm dữ liệu từ một nguồn dữ liệu 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 thì có thể 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.
- Một phân đoạn 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 đã làm trong buổi tập. Ví dụ: nếu người dùng theo dõi một bài chạy 30 phút ( nhưng đi bộ một lúc trong thời gian này, điều này có thể được chia thành phân khúc. Sẽ có một đoạn chạy, sau đó đến đoạn nghỉ giải lao và sau đó là đoạn 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 về buổi tập từ kho lưu trữ dữ liệu thể dục, tất cả dữ liệu về hoạt động thể dục giảm trong khoảng thời gian của một phiên hoạt động. phiên hoạt động, ngay cả khi bạn chèn dữ liệu sau khi tạo phiên hoạt động hoặc tạo một 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ể cho 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 thủ công.
- Khi người dùng tự thêm một bài tập thể dục hoặc hoạt độ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 hoạt động. 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 và để Google Fit tạo các phân khúc này theo 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à người dùng tạo/chèn
- Tên hoặc
- Mã nhận dạng
- Tìm tất cả các phiên mà công cụ đã 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 những nguồn nào đã tạo phiên hoạt động
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 Android viết
khách hàng. Để 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 ý định khởi chạy ứng dụng của bạn.
Tìm hiểu thêm về cách tìm nguồn đã tạo ra .
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ể dùng
trong ứng dụng của bạn để cho người dùng biết ứng dụng nào khác đã chèn thông tin thể dục
phiên hoạt động. 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 .