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