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. 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:

    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 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.