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

קריאה ברקע

אתם יכולים לבקש שהאפליקציה תפעל ברקע ותקריא נתונים מ-Health Connect. אם מבקשים את ההרשאה קריאה ברקע, המשתמש יכול להעניק לאפליקציה גישה לקריאת נתונים ברקע.