การรวบรวมข้อมูลใน Health Connect รวมถึงการรวบรวมข้อมูลพื้นฐานหรือการรวบรวม ข้อมูลลงในที่เก็บข้อมูล เวิร์กโฟลว์ต่อไปนี้จะแสดงวิธีดำเนินการทั้ง 2 อย่าง
การรวมพื้นฐาน
หากต้องการใช้การรวมพื้นฐานกับข้อมูล ให้ใช้ฟังก์ชัน aggregate
ในออบเจ็กต์ HealthConnectClient
โดยจะรับออบเจ็กต์
AggregateRequest
ซึ่งคุณจะเพิ่มประเภทเมตริก
และช่วงเวลาเป็นพารามิเตอร์ได้ วิธีเรียกใช้ข้อมูลรวมพื้นฐานจะขึ้นอยู่กับ
ประเภทเมตริกที่ใช้
การรวมสะสม
การรวมแบบสะสมจะคำนวณมูลค่าทั้งหมด
ตัวอย่างต่อไปนี้แสดงวิธีรวมข้อมูลสำหรับประเภทข้อมูล
suspend fun aggregateDistance(
healthConnectClient: HealthConnectClient,
startTime: Instant,
endTime: Instant
) {
try {
val response = healthConnectClient.aggregate(
AggregateRequest(
metrics = setOf(DistanceRecord.DISTANCE_TOTAL),
timeRangeFilter = TimeRangeFilter.between(startTime, endTime)
)
)
// The result may be null if no data is available in the time range
val distanceTotalInMeters = response[DistanceRecord.DISTANCE_TOTAL]?.inMeters ?: 0L
} catch (e: Exception) {
// Run error handling here
}
}
กรองตามแหล่งที่มาของข้อมูล
นอกจากนี้ คุณยังกรองข้อมูลรวมตามแหล่งที่มาได้ด้วย เช่น รวมเฉพาะข้อมูลที่แอปหนึ่งๆ เขียน
ตัวอย่างต่อไปนี้แสดงวิธีใช้ dataOriginFilter
และ
AggregateRequest
เพื่อรวบรวมจำนวนก้าวจากแอปที่เฉพาะเจาะจง
suspend fun aggregateStepsFromSpecificApp(
healthConnectClient: HealthConnectClient,
startTime: Instant,
endTime: Instant,
appPackageName: String
) {
try {
val response = healthConnectClient.aggregate(
AggregateRequest(
metrics = setOf(StepsRecord.COUNT_TOTAL),
timeRangeFilter = TimeRangeFilter.between(startTime, endTime),
dataOriginFilter = setOf(DataOrigin(appPackageName))
)
)
// The result may be null if no data is available in the time range
val totalSteps = response[StepsRecord.COUNT_TOTAL] ?: 0L
} catch (e: Exception) {
// Run error handling here
}
}
การรวมข้อมูลทางสถิติ
การรวมทางสถิติจะคำนวณค่าต่ำสุด ค่าสูงสุด หรือค่าเฉลี่ยของ ระเบียนที่มีตัวอย่าง
ตัวอย่างต่อไปนี้แสดงวิธีใช้การรวมข้อมูลทางสถิติ
suspend fun aggregateHeartRate(
healthConnectClient: HealthConnectClient,
startTime: Instant,
endTime: Instant
) {
try {
val response =
healthConnectClient.aggregate(
AggregateRequest(
setOf(HeartRateRecord.BPM_MAX, HeartRateRecord.BPM_MIN),
timeRangeFilter = TimeRangeFilter.between(startTime, endTime)
)
)
// The result may be null if no data is available in the time range
val minimumHeartRate = response[HeartRateRecord.BPM_MIN]
val maximumHeartRate = response[HeartRateRecord.BPM_MAX]
} catch (e: Exception) {
// Run error handling here
}
}
ถัง
นอกจากนี้ Health Connect ยังช่วยให้คุณรวบรวมข้อมูลลงในกลุ่มได้ด้วย ถัง 2 ประเภทที่คุณใช้ได้ ได้แก่ duration และ period
เมื่อเรียกใช้แล้ว ฟังก์ชันเหล่านี้จะแสดงรายการที่เก็บข้อมูล โปรดทราบว่ารายการอาจมีข้อมูลไม่ครบถ้วน ดังนั้น ระบบจะไม่รวมที่เก็บข้อมูลไว้ในรายการหากไม่มีข้อมูล
ระยะเวลา
ในกรณีนี้ ระบบจะแบ่งข้อมูลที่รวบรวมไว้เป็นกลุ่มภายในระยะเวลาที่กำหนด เช่น 1 นาทีหรือ 1 ชั่วโมง หากต้องการรวมข้อมูลเป็นกลุ่ม ให้ใช้
aggregateGroupByDuration
โดยจะยอมรับออบเจ็กต์
AggregateGroupByDurationRequest
ที่คุณเพิ่มประเภทเมตริก ช่วงเวลา และ Duration
เป็นพารามิเตอร์
ตัวอย่างต่อไปนี้แสดงการรวมขั้นตอนเป็นกลุ่มที่มีความยาว 1 นาที
suspend fun aggregateStepsIntoMinutes(
healthConnectClient: HealthConnectClient,
startTime: LocalDateTime,
endTime: LocalDateTime
) {
try {
val response =
healthConnectClient.aggregateGroupByDuration(
AggregateGroupByDurationRequest(
metrics = setOf(StepsRecord.COUNT_TOTAL),
timeRangeFilter = TimeRangeFilter.between(startTime, endTime),
timeRangeSlicer = Duration.ofMinutes(1L)
)
)
for (durationResult in response) {
// The result may be null if no data is available in the time range
val totalSteps = durationResult.result[StepsRecord.COUNT_TOTAL]
}
} catch (e: Exception) {
// Run error handling here
}
}
จุด
ในกรณีนี้ ระบบจะแบ่งข้อมูลรวมออกเป็นกลุ่มภายในระยะเวลาตามวันที่ เช่น สัปดาห์หรือเดือน หากต้องการรวมข้อมูลเป็นกลุ่ม ให้ใช้
aggregateGroupByPeriod
โดยจะยอมรับออบเจ็กต์
AggregateGroupByPeriodRequest
ที่คุณเพิ่ม
ประเภทเมตริก ช่วงเวลา และ Period
เป็นพารามิเตอร์
ตัวอย่างต่อไปนี้แสดงการรวมขั้นตอนต่างๆ เป็นกลุ่มรายเดือน
suspend fun aggregateStepsIntoMonths(
healthConnectClient: HealthConnectClient,
startTime: LocalDateTime,
endTime: LocalDateTime
) {
try {
val response =
healthConnectClient.aggregateGroupByPeriod(
AggregateGroupByPeriodRequest(
metrics = setOf(StepsRecord.COUNT_TOTAL),
timeRangeFilter = TimeRangeFilter.between(startTime, endTime),
timeRangeSlicer = Period.ofMonths(1)
)
)
for (monthlyResult in response) {
// The result may be null if no data is available in the time range
val totalSteps = monthlyResult.result[StepsRecord.COUNT_TOTAL]
}
} catch (e: Exception) {
// Run error handling here
}
}
อ่านข้อจำกัด
โดยค่าเริ่มต้น แอปพลิเคชันทั้งหมดจะอ่านข้อมูลจาก Health Connect ได้นานสูงสุด 30 วัน ก่อนที่จะมีการให้สิทธิ์ครั้งแรก
หากต้องการขยายสิทธิ์การอ่านนอกเหนือจากข้อจำกัดเริ่มต้น ให้ขอPERMISSION_READ_HEALTH_DATA_HISTORY
ไม่เช่นนั้น หากไม่มีสิทธิ์นี้ การพยายามอ่านบันทึกที่เก่ากว่า 30 วันจะทำให้เกิดข้อผิดพลาด
ประวัติสิทธิ์ของแอปที่ถูกลบ
หากผู้ใช้ลบแอปของคุณ ระบบจะเพิกถอนสิทธิ์ทั้งหมด รวมถึงสิทธิ์เข้าถึงประวัติ หากผู้ใช้ติดตั้งแอปของคุณอีกครั้งและให้สิทธิ์อีกครั้ง ข้อจำกัดเริ่มต้นเดียวกันจะยังคงมีผล และแอปของคุณจะอ่านข้อมูลจาก Health Connect ได้นานสูงสุด 30 วันก่อนวันที่ใหม่นั้น
เช่น สมมติว่า ผู้ใช้ลบแอปของคุณในวันที่ 10 พฤษภาคม 2023 แล้วติดตั้งแอปอีกครั้ง ในวันที่ 15 พฤษภาคม 2023 และให้สิทธิ์อ่าน วันที่ที่เร็วที่สุดที่แอปของคุณอ่านข้อมูลได้โดยค่าเริ่มต้นคือ15 เมษายน 2023
รวบรวมข้อมูลที่ได้รับผลกระทบจากลำดับความสำคัญของแอปที่ผู้ใช้เลือก
ผู้ใช้ปลายทางสามารถตั้งค่าลำดับความสำคัญสำหรับแอปการนอนหลับและกิจกรรมที่ผสานรวมกับ Health Connect ได้ มีเพียงผู้ใช้ปลายทางเท่านั้นที่เปลี่ยนแปลงรายการลำดับความสำคัญเหล่านี้ได้ เมื่อคุณอ่านข้อมูลที่รวบรวมแล้ว Aggregate API จะพิจารณา ข้อมูลที่ซ้ำกันและเก็บเฉพาะข้อมูลจากแอปที่มี ลำดับความสำคัญสูงสุด ข้อมูลที่ซ้ำกันอาจเกิดขึ้นได้หากผู้ใช้มีแอปหลายแอปที่เขียนข้อมูลประเภทเดียวกัน เช่น จำนวนก้าวที่เดินหรือระยะทางที่เดินในเวลาเดียวกัน
ดูข้อมูลเกี่ยวกับวิธีที่ผู้ใช้ปลายทางจัดลําดับความสําคัญของแอปได้ที่จัดการข้อมูล Health Connect
ผู้ใช้สามารถเพิ่มหรือนำแอปออก รวมถึงเปลี่ยนลำดับความสำคัญของแอปได้ ผู้ใช้อาจต้องการนำแอปที่เขียนข้อมูลที่ซ้ำกันออกเพื่อให้ผลรวมของข้อมูลในหน้าจอ Health Connect เหมือนกับแอปที่ผู้ใช้ให้ความสำคัญสูงสุด ระบบจะอัปเดตยอดรวมของข้อมูลแบบเรียลไทม์
แม้ว่า Aggregate API จะคำนวณข้อมูลของแอปกิจกรรมและการนอนหลับโดย การขจัดข้อมูลที่ซ้ำกันตามวิธีที่ผู้ใช้ ตั้งค่าลำดับความสำคัญ แต่คุณยังคงสร้างตรรกะของคุณเองเพื่อคำนวณข้อมูลแยกกันสำหรับแต่ละแอปที่เขียนข้อมูลนั้นได้
Health Connect จะขจัดข้อมูลที่ซ้ำกันเฉพาะประเภทข้อมูลกิจกรรมและการนอนหลับ และ ยอดรวมข้อมูลที่แสดงคือค่าหลังจากที่ Aggregate API ขจัดข้อมูลที่ซ้ำกันแล้ว ยอดรวมเหล่านี้แสดงข้อมูลของวันล่าสุดที่สมบูรณ์ ซึ่งมีข้อมูลเกี่ยวกับจำนวนก้าวและระยะทาง สำหรับแอปประเภทอื่นๆ จำนวนรวมของแอปดังกล่าวทั้งหมดจะแสดงในผลรวมของข้อมูลใน Health Connect
การอ่านในเบื้องหลัง
คุณขอให้แอปพลิเคชันทำงานในเบื้องหลังและอ่านข้อมูลจาก Health Connect ได้ หากคุณขอสิทธิ์ อ่านในเบื้องหลัง ผู้ใช้จะให้สิทธิ์แอปของคุณในการอ่านข้อมูลในเบื้องหลังได้
ประเภทข้อมูลรวมที่รองรับตามระเบียน
ตารางนี้แสดงประเภทข้อมูลรวมทั้งหมดที่บันทึก Health Connect รองรับ