Phiên

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:

    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()

Sử dụng phiên

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.