หน้านี้จะอธิบายฟังก์ชันหลักของ Health Connect API
การดำเนินการ CRUD ในระเบียนและซิงค์ข้อมูล
แพลตฟอร์มมีฟังก์ชันแทรก อัปเดต และลบมาตรฐานสําหรับข้อมูลที่บันทึกไว้ นอกจากนี้ Health Connect ยังมีฟังก์ชันการทำงานที่ช่วยให้แอปไคลเอ็นต์ซิงค์ข้อมูลจาก Health Connect ได้ ซึ่งจะสร้างบันทึกการเปลี่ยนแปลงข้อมูลที่จะแสดงให้นักพัฒนาแอปและผู้ใช้ทราบว่าแอปอื่นๆ ได้แทรกหรือลบข้อมูลบางประเภทหรือไม่
ฟังก์ชันการรวมข้อมูลพื้นฐาน
ไคลเอ็นต์สามารถใช้ฟังก์ชันการรวมกับข้อมูลพื้นฐานได้ โดยระบุข้อมูลต่อไปนี้
- ค่าเฉลี่ย ค่าต่ำสุด หรือค่าสูงสุด (เช่น อัตราการเต้นของหัวใจต่ำสุดและสูงสุดระหว่างเซสชันกิจกรรม)
- ผลรวมทั้งหมด (เช่น จํานวนก้าวทั้งหมดในช่วงวัน)
- จํานวนการวัดพื้นฐาน (เช่น จํานวนเซสชันกิจกรรมในสัปดาห์หนึ่งๆ)
- ระยะเวลาทั้งหมดในประเภทข้อมูลที่รองรับ (เช่น เวลาที่ใช้ในการนอนหลับลึกในสัปดาห์นี้ หรือระยะเวลาทั้งหมดของเซสชันกิจกรรมในวันนี้)
การตรวจสอบความพร้อมให้บริการ
Health Connect ใช้ได้กับ Android SDK เวอร์ชัน 28 (Pie) ขึ้นไป SDK นี้ช่วยให้แอปไคลเอ็นต์ระบุได้ว่า Health Connect API เปิดอยู่ในอุปกรณ์ Android ของผู้ใช้หรือไม่ หากไม่ Health Connect จะเรียกใช้การตรวจสอบความพร้อมใช้งานเพื่อดูว่าอุปกรณ์ของผู้ใช้ใช้งานร่วมกันได้หรือไม่
การตรวจสอบสิทธิ์
Health Connect กำหนดให้คุณขอสิทธิ์จากผู้ใช้เพื่ออ่านและเขียนข้อมูลสุขภาพและการออกกำลังกายของผู้ใช้ตามแอป นอกจากนี้ คุณยังดูสิทธิ์ที่ผู้ใช้มอบหรือปฏิเสธไปแล้วได้ด้วย
การอ่านด้วย Health Connect
การอ่านในเบื้องหน้า
เฉพาะแอปพลิเคชันที่ทำงานอยู่เบื้องหน้าเท่านั้นที่อ่านข้อมูลด้วย Health Connect ได้ ข้อจำกัดนี้มีไว้เพื่อเสริมความเป็นส่วนตัวของผู้ใช้
สำหรับกรณีที่แอปอาจมีการหยุดชะงัก เช่น การแสดงค่าที่อ่านได้ในแอปพลิเคชัน ให้อ่านจาก Health Connect ไปยังแอปพลิเคชันไคลเอ็นต์โดยตรง
สำหรับกรณีที่คุณต้องการให้แอปทำงานโดยไม่หยุดชะงัก เช่น การอ่านข้อมูลช่วงหนึ่งจาก Health Connect แล้วเขียนและอัปโหลดข้อมูลดังกล่าวไปยังที่อื่น ให้ใช้ ForegroundService แทน Activity ที่ปิดได้ง่าย
การอ่านในเบื้องหลัง
คุณสามารถขอให้แอปพลิเคชันทำงานในเบื้องหลังและอ่านข้อมูลจาก Health Connect หากคุณขอสิทธิ์อ่านในเบื้องหลัง ผู้ใช้จะอนุญาตให้แอปของคุณเข้าถึงเพื่ออ่านข้อมูลในเบื้องหลังได้