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