คู่มือนี้ใช้ได้กับ Health Connect เวอร์ชัน 1.1.0-alpha12
Health Connect มีประเภทข้อมูลอุณหภูมิผิวหนังเพื่อวัดอุณหภูมิร่างกายส่วนปลาย การวัดนี้เป็นสัญญาณที่มีประโยชน์อย่างยิ่งในการตรวจหา คุณภาพการนอนหลับ สุขภาพเจริญพันธุ์ และการเริ่มเจ็บป่วยที่อาจเกิดขึ้น
ความพร้อมใช้งานของฟีเจอร์
หากต้องการดูว่าอุปกรณ์ของผู้ใช้รองรับอุณหภูมิผิวหนังใน Health Connect หรือไม่ ให้ตรวจสอบความพร้อมใช้งานของFEATURE_SKIN_TEMPERATURE
ในไคลเอ็นต์ ดังนี้
if (healthConnectClient
.features
.getFeatureStatus(
HealthConnectFeatures.FEATURE_SKIN_TEMPERATURE
) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {
// Feature is available
} else {
// Feature isn't available
}
ดูข้อมูลเพิ่มเติมได้ที่ตรวจสอบความพร้อมใช้งานของฟีเจอร์
สิทธิ์ที่จำเป็น
การเข้าถึงอุณหภูมิผิวหนังได้รับการคุ้มครองโดยสิทธิ์ต่อไปนี้
android.permission.health.READ_SKIN_TEMPERATURE
android.permission.health.WRITE_SKIN_TEMPERATURE
หากต้องการเพิ่มความสามารถในการวัดอุณหภูมิผิวหนังลงในแอป ให้เริ่มต้นด้วยการขอสิทธิ์เขียนสำหรับประเภทข้อมูล SkinTemperature
สิทธิ์ที่คุณต้องประกาศเพื่อเขียนอุณหภูมิผิวมีดังนี้
<application>
<uses-permission
android:name="android.permission.health.WRITE_SKIN_TEMPERATURE" />
...
</application>
หากต้องการอ่านอุณหภูมิผิวหนัง คุณต้องขอสิทธิ์ต่อไปนี้
<application>
<uses-permission
android:name="android.permission.health.READ_SKIN_TEMPERATURE" />
...
</application>
ขอสิทธิ์จากผู้ใช้
หลังจากสร้างอินสแตนซ์ไคลเอ็นต์แล้ว แอปของคุณต้องขอสิทธิ์จากผู้ใช้ ผู้ใช้ต้องได้รับอนุญาตให้ให้หรือปฏิเสธสิทธิ์ได้ทุกเมื่อ
โดยให้สร้างชุดสิทธิ์สำหรับประเภทข้อมูลที่จำเป็น ตรวจสอบว่าได้ประกาศสิทธิ์ในชุดไว้ใน Android Manifest ก่อน
// Create a set of permissions for required data types
val PERMISSIONS =
setOf(
HealthPermission.getReadPermission(SkinTemperatureRecord::class),
HealthPermission.getWritePermission(SkinTemperatureRecord::class)
)
ใช้ getGrantedPermissions
เพื่อดูว่าแอปของคุณได้รับสิทธิ์ที่จำเป็นแล้วหรือไม่ หากไม่มี ให้ใช้ createRequestPermissionResultContract
เพื่อขอสิทธิ์เหล่านั้น ซึ่งจะแสดงหน้าจอสิทธิ์ของ Health Connect
// Create the permissions launcher
val requestPermissionActivityContract = PermissionController.createRequestPermissionResultContract()
val requestPermissions = registerForActivityResult(requestPermissionActivityContract) { granted ->
if (granted.containsAll(PERMISSIONS)) {
// Permissions successfully granted
} else {
// Lack of required permissions
}
}
suspend fun checkPermissionsAndRun(healthConnectClient: HealthConnectClient) {
val granted = healthConnectClient.permissionController.getGrantedPermissions()
if (granted.containsAll(PERMISSIONS)) {
// Permissions already granted; proceed with inserting or reading data
} else {
requestPermissions.launch(PERMISSIONS)
}
}
เนื่องจากผู้ใช้สามารถให้หรือเพิกถอนสิทธิ์ได้ทุกเมื่อ แอปของคุณจึงต้อง ตรวจสอบสิทธิ์ที่ได้รับเป็นระยะๆ และจัดการสถานการณ์ที่ สิทธิ์สูญหาย
ข้อมูลที่รวมอยู่ในบันทึกอุณหภูมิผิวหนัง
ระบบจะจัดระเบียบการวัดอุณหภูมิผิวหนังเป็นบันทึก แต่ละระเบียนประกอบด้วยข้อมูลต่อไปนี้
- อุณหภูมิพื้นฐานเป็นองศาเซลเซียสหรือองศาฟาเรนไฮต์ นี่คือ ค่าที่ไม่บังคับซึ่งมีประโยชน์มากที่สุดสำหรับการแสดงภาพใน UI ของแอป
- รายการเดลต้าของอุณหภูมิผิวหนัง โดยแต่ละรายการจะแสดงการเปลี่ยนแปลงของอุณหภูมิผิวหนังตั้งแต่การวัดครั้งล่าสุด หากมีการระบุอุณหภูมิพื้นฐาน ส่วนต่างเหล่านี้ควรใช้หน่วยอุณหภูมิเดียวกัน
- ตำแหน่งบนร่างกายของผู้ใช้ที่ทำการวัด ได้แก่ นิ้วมือ นิ้วเท้า หรือข้อมือ
การรวมที่รองรับ
ไม่มีการรวบรวมที่รองรับสำหรับข้อมูลประเภทนี้
ตัวอย่างการใช้งาน
อ่านหรือเขียนการวัดอุณหภูมิผิวหนังโดยใช้ไลบรารี JetPack
อ่านข้อมูลอุณหภูมิผิวหนัง
ข้อมูลโค้ดต่อไปนี้แสดงวิธีอ่านค่าอุณหภูมิผิวหนัง โดยใช้ไลบรารี Jetpack
suspend fun readSkinTemperatures() {
// Error handling, permission check, and feature availability check
// aren't included.
// Record includes measurements during the past hour.
val recordEndTime = Instant.now()
val recordStartTime = recordEndTime.minusSeconds(60 * 60)
val response = healthConnectClient.readRecords(
ReadRecordsRequest<SkinTemperatureRecord>(
timeRangeFilter = TimeRangeFilter.between(
recordStartTime, recordEndTime
)
)
)
for (skinTemperatureRecord in response.records) {
// Process each skin temperature record here.
}
}
เขียนข้อมูลอุณหภูมิผิวหนัง
ข้อมูลโค้ดต่อไปนี้แสดงวิธีเขียนการวัดอุณหภูมิผิวหนัง โดยใช้ไลบรารี Jetpack
suspend fun writeSkinTemperatures(): InsertRecordsResponse {
// Error handling, permission check, and feature availability check
// aren't included.
// Record includes measurements during the past hour.
val recordEndTime: ZonedDateTime = now()
val recordStartTime: ZonedDateTime = recordEndTime.minusHours(1)
healthConnectClient.insertRecords(
// For this example, there's only one skin temperature record.
listOf(
SkinTemperatureRecord(
baseline = Temperature.celsius(37.0),
startTime = recordStartTime.toInstant(),
startZoneOffset = recordStartTime.offset,
endTime = recordEndTime.toInstant(),
endZoneOffset = recordEndTime.offset,
deltas = listOf(
SkinTemperatureRecord.Delta(
recordEndTime.minusMinutes(50).toInstant(), celsius(0.5)
), SkinTemperatureRecord.Delta(
recordEndTime.minusMinutes(30).toInstant(), celsius(-0.7)
)
),
measurementLocation = SkinTemperatureRecord.MEASUREMENT_LOCATION_FINGER,
metadata = Metadata.autoRecorded(
device = Device(type = Device.TYPE_RING)
),
)
)
)
}