Trang này được dịch bởi Cloud Translation API.

Số phiên hoạt động

Phiên hoạt động là một 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 chính mà họ đã thực hiện. Chúng xuất hiện trên trang nhật ký ứng dụng Google Fit. Ví dụ: một phiên thở, đi bộ, chạy bộ hoặc ngủ ban đêm là những ví dụ về phiên hoạt động.

Phiên hoạt động sẽ nhóm các tập dữ liệu từ 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 thời điểm họ bắt đầu và kết thúc 3 km, thì một phiên hoạt động có thể được tạo và tất cả dữ liệu về hoạt động thể dục trong khoảng thời gian đó (như số bước, tốc độ, khoảng cách) sẽ được liên kết với phiên hoạt động đó.

Bản thân các phiên hoạt động không chứa thông tin chi tiết về hoạt động. Điều này nằm trong tập dữ liệu. Phiên hoạt động có các thuộc tính sau:

Tên mô tả, thân thiện (ví dụ: " run run")
Một mô tả
Giá trị nhận dạng duy nhất
Loại hoạt động mà hoạt động thu thập được (ví dụ: hoạt động chạy)

Lợi ích của việc sử dụng phiên

Giúp í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 theo cách 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 trên trang Tạp chí trong ứng dụng Google Fit.
Trải nghiệm người dùng nhất quán: Nếu ứng dụng hoặc thiết bị đồng hành của bạn cho phép theo dõi hoạt động (trong đó người dùng có thể bắt đầu và dừng hoạt động), thì việc có phiên cho những bài tập thể dục này sẽ 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 nguồn để bổ sung và làm phong phú thông tin về phiên hoạt động của bạn. Do đó, người dùng sẽ 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 của bạn không theo dõi hoạt động của họ hoặc ứng dụng không hỗ trợ tính năng theo dõi, thì bạn vẫn có thể đọc các phiên trong Google Fit. Bạn có thể truy vấn dữ liệu chi tiết hoặc tổng hợp từ cửa hàng thể dục và tìm các phiên có sẵn mà không cần triển khai giản đồ và bộ nhớ của riêng mình.
Tăng mức độ tương tác của người dùng: Bạn có thể cho người dùng thấy các phiên có sẵn và ứng dụng đã tạo ra các phiên đó. 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.

Yêu cầu sự cho phép của người dùng cho các phiên

Nếu bạn muốn đọc hoặc ghi phiên, thì ứng dụng phải có quyền của người dùng. Quyền truy cập vào các phiên hoạt động sử dụng cùng phạm vi ủy 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 vào siêu dữ liệu 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 đó; các loại dữ liệu nhịp 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 hoạt động 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 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 các bài tập thể dục
Đọc các phiên và tập dữ liệu được liên kết với chúng
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 một 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 theo thời gian thực
Chèn phiên 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 các bài tập thể dục
Đọc các phiên và tập dữ liệu được liên kết với chúng

Cách tập dữ liệu và phân đoạn tương tác với phiên hoạt động

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 các tập dữ liệu riêng. Tuy nhiên, nếu bạn đang tạo một phiên hoạt động, có thể sẽ dễ dàng hơn khi tạo phiên hoạt động và các tập dữ liệu của phiên hoạt động đó cùng nhau.
Phân đoạn nhóm các tập dữ liệu trong phiên theo hoạt động chính xác của người dùng đã thực hiện trong phiên. Ví dụ: nếu người dùng theo dõi thời gian chạy 30 phút (phiên hoạt động) nhưng đi bộ một lúc trong thời gian này, thì hoạt động này có thể được chia thành các phân khúc. Sẽ có một đoạn để chạy, sau đó có thời gian đi bộ rồi đến lượt chạy lại.

**Hình 1**: Các ứng dụng khác nhau sẽ thêm phiên và tập dữ liệu vào [cửa hàng thể dục].

Hình 1 cho thấy một khoảng thời gian trong cửa hàng thể dục, trong đó các ứng dụng A, B và C đã chèn một số tập dữ liệu và phiên hoạt động:

Ứ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, độc lập với mọi phiên hoạt động.
Ứ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 độc lập với bất kỳ phiên nào.

Khi đọc dữ liệu phiên từ cửa hàng thể dục, tất cả dữ liệu thể dục nằm trong khoảng thời gian của phiên được tự động 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 bị động. Ví dụ: truy vấn về dữ liệu về hoạt động thể dục từ Phiên 1 sẽ trả về:

Tập dữ liệu A1
Tập dữ liệu A2
Phần tập dữ liệu A3 giữa t1 và t2
Phần tập dữ liệu C1 từ t1 đến t2

Bạn có thể biết ứng dụng nào đã chèn mỗi phiên hoạt động và tập dữ liệu.

Tạo phiên

Phiên hoạt động có thể được tạo theo một số 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 hoạt động trên thiết bị (chỉ dành cho Android) hoặc
- bằng cách chèn thủ công nó.
Khi người dùng tự thêm bài tập thể dục hoặc hoạt động trong ứng dụng Google Fit.

Thời điểm nên tạo phiên hoạt động

Bạn có đang thêm dữ liệu giấc ngủ không?

Có – Tạo một phiên và tự chèn phiên này vào cửa hàng thể dục. Ví dụ: chèn một phiên giấc ngủ. Lý do là những người dùng có ứng dụng hoặc thiết bị theo dõi giấc ngủ sẽ không tương tác với thiết bị để bắt đầu và dừng hoạt động của họ (việc này được theo dõi một cách bị động).
Không – Ứng dụng của bạn có cho phép người dùng bắt đầu và dừng các 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 theo thời gian thực nếu người dùng theo dõi hoạt động hoặc theo cách thủ công. Với API REST, hãy tạo một phiên hoạt động và chèn thao tác này vào cửa hàng thể dục theo cách thủ công.
- Ứng dụng có thể phát hiện khi người dùng thực hiện các hoạt động khác nhau ở cấp độ chi tiết hơn (ví dụ: đi bộ so với chạy) không?
  - Có – Thêm các phân khúc.
  - Không – Chỉ thêm tập dữ liệu. Tạm thời bỏ qua các phân khúc và để Google Fit tạo những phân khúc này một cách bị động.

Đọc phiên

Ứng dụng của bạn có thể đọc phiên theo một số cách:

Tìm một phiên cụ thể mà phiên tạo/chèn bởi
- Tên hoặc
- Indonesia
Tìm tất cả các phiên mà ứng dụng đã tạo/chèn, theo khoảng thời gian
Tìm tất cả các phiên có sẵn do tất cả các ứng dụng (bao gồm cả Google Fit) tạo theo khoảng thời gian

Tìm hiểu những nguồn nào đã tạo một 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 từng phiên của họ. Mỗi phiên có một nguồn dữ liệu được liên kết, nguồn này có thông tin về ứng dụng hoặc thiết bị đã thu thập hoặc chuyể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, 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 người dùng biết những ứng dụng nào khác đã chèn 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.

Bạn cũng có thể kích hoạt ý định phát hành các ứng dụng khác để hiển thị thông tin chi tiết về các phiên mà ứ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.

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 sử dụng thuộc tính session.name. Bạn có thể sử dụng thông tin này trong ứng dụng để hiển thị cho người dùng ứng dụng 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 để giúp người dùng xác định.

Tìm hiểu thêm về cách tìm nguồn đã tạo phiên.