בדף הזה מתוארות הפונקציות העיקריות של 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: שירות מסוג כללי שמאפשר לאפליקציה להמשיך לאסוף נתונים קריטיים למשימות שנמשכות פחות משלוש דקות, גם אם המשתמש מעביר את האפליקציה לרקע לפני שהיא מסיימת.
קריאה ברקע
אתם יכולים לבקש שהאפליקציה שלכם תפעל ברקע ותקרא נתונים מ-Health Connect. אם תבקשו את ההרשאה קריאה ברקע, המשתמש יוכל להעניק לאפליקציה שלכם גישה לקריאת נתונים ברקע.