ตรวจสอบฟังก์ชันการทำงานของ Health Connect

หน้านี้จะอธิบายฟังก์ชันหลักของ 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 ไปยังแอปพลิเคชันของลูกค้าโดยตรง

สำหรับกรณีที่คุณต้องการให้แอปทำงานโดยไม่หยุดชะงัก ให้ใช้บริการที่ทำงานอยู่เบื้องหน้า ดังนี้

  • FOREGROUND_SERVICE_TYPE_HEALTH: อนุญาตให้แอปทำงานอยู่เบื้องหน้าเพื่อรวบรวมข้อมูลเซ็นเซอร์ เช่น แอปออกกำลังกายที่รวบรวมข้อมูลต่อไปแม้ว่าผู้ใช้จะย้ายแอปไปไว้เบื้องหลัง

  • FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: บริการประเภททั่วไปที่อนุญาตให้แอปรวบรวมข้อมูลที่สําคัญต่อไปสําหรับงานที่ใช้เวลาน้อยกว่า 3 นาที แม้ว่าผู้ใช้จะย้ายแอปไปไว้เบื้องหลังก่อนที่งานจะเสร็จสมบูรณ์ก็ตาม

การอ่านในเบื้องหลัง

คุณสามารถขอให้แอปพลิเคชันทำงานในเบื้องหลังและอ่านข้อมูลจาก Health Connect หากคุณขอสิทธิ์อ่านในเบื้องหลัง ผู้ใช้จะอนุญาตให้แอปของคุณเข้าถึงเพื่ออ่านข้อมูลในเบื้องหลังได้