ตรวจสอบฟังก์ชันการทำงานของ 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 หากคุณขอสิทธิ์อ่านในเบื้องหลัง ผู้ใช้จะอนุญาตให้แอปของคุณเข้าถึงเพื่ออ่านข้อมูลในเบื้องหลังได้
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-27 UTC
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2025-07-27 UTC"],[],[],null,["# Review Health Connect functionality\n\nThis page describes the main functions of the Health Connect API.\n\nCRUD operations on record and data synchronization\n--------------------------------------------------\n\nThe platform provides standard insert, update, and delete functions for recorded\ndata. Health Connect also includes functionality that allows client apps to\nsynchronize data out of Health Connect. This produces a log of data changes\nthat shows the developer and user whether certain data types have been\ninserted or deleted by other apps.\n\nBasic aggregation functions\n---------------------------\n\nClients can apply an aggregation function over underlying data, providing the\nfollowing:\n\n- The **average, minimum or maximum** values (for example, the minimum and maximum heart rate during an activity session).\n- The **sum total** (for example, the total step count in a daily interval).\n- A **simple count** of the number of underlying measurements (for example, the number of activity sessions in a given week).\n- The **total duration** on supported data types (for example, time spent in deep sleep this week, or total duration of activity sessions today).\n\nAvailability checks\n-------------------\n\nHealth Connect is compatible with Android SDK version 28 (Pie) and higher.\nThe SDK allows client apps to determine whether the Health Connect API is on\nthe user's Android-powered device. If it isn't, Health Connect triggers an\navailability check to determine whether the user's device is compatible.\n\nPermission checks\n-----------------\n\nHealth Connect requires you to request the user's permission to read and\nwrite their health and fitness data on a per-app basis. It also lets you\nsee what permissions have already been granted or denied by the user.\n\nReading with Health Connect\n---------------------------\n\n### Foreground reading\n\nYou can normally read data from Health Connect when your app is\nin the foreground. In these cases, you may consider using a foreground service\nto run this operation in case the user or system places your app\nin the background during a read operation.\n\nFor situations in which your app may expect an interruption, such as displaying\na reading in your application, read directly from Health Connect to your client\napplication.\n\nFor situations in which you prefer your app to run without\ninterruptions, use a\n[foreground service](/develop/background-work/services/fgs):\n\n- [`FOREGROUND_SERVICE_TYPE_HEALTH`](/reference/android/content/pm/ServiceInfo#FOREGROUND_SERVICE_TYPE_HEALTH): Allows app to remain in\n the foreground to collect sensor data, such as a workout app that continues\n to collect data even when the user puts the app in the background.\n\n- [`FOREGROUND_SERVICE_TYPE_SHORT_SERVICE`](/reference/android/content/pm/ServiceInfo#FOREGROUND_SERVICE_TYPE_SHORT_SERVICE): A generic-type\n service that allows an app to continue to collect critical data for\n tasks that take less than three minutes,\n even if the user places the app in the background before it completes.\n\n### Background reading\n\nYou can request that your application run in the background and read data from\nHealth Connect. If you request the\n[Background Read](/health-and-fitness/guides/health-connect/develop/read-data#background-read-example)\npermission, your user can grant your app access to read data in the background."]]
