אפליקציית Health Connect מאחסנת ומארגנת את נתוני הבריאות והכושר. הוא גם מתייחס לאופן שבו סוגים שונים של נתונים נמדדים. סוגי הנתונים האלה כוללים מדידות של דופק שנלקחות באופן מיידי, מספר צעדים שנאסף לאורך זמן ונתוני שינה שנאספים בסשנים.
חשוב להבין קודם מהם סוגי הנתונים וההרשאות ש-Health Connect מציע, כדי שתוכלו לתכנן את הדרישות של האפליקציה. לכן, עליכם לבדוק את סוגי הנתונים לפני שתוכלו לסיים את הגדרת הדרישות.
קטגוריות של סוגי נתונים
כדי לספק מגוון רחב ככל האפשר, Health Connect תומכת בסוגי נתונים שבהם נעשה שימוש ברוב האפליקציות לבריאות ולכושר. מטרת Health Connect היא לספק תצוגה מקיפה של נתוני הבריאות והכושר ואחסון שלהם. סוגי הנתונים האלה נכללים בקטגוריות הבאות:
- פעילות: הנתון הזה מתעד כל פעילות שמשתמש מבצע. היא יכולה לכלול פעילויות בריאות ופיטנס כמו ריצה ושחייה.
- מדידת גוף: הנתונים האלה מתעדים נתונים נפוצים שקשורים לגוף, כמו המשקל של המשתמש וקצב חילוף החומרים הבסיסי שלו.
- מעקב אחר המחזור: כאן מתועדים מחזורי וסת ונקודות נתונים קשורות, כמו התוצאה הבינארית של בדיקת ביוץ.
- תזונה: כאן מתועדים סוגי הנתונים 'מאזן הנוזלים' ו'תזונה'. המדד הראשון מייצג את כמות המים שמשתמש צורך בתוך משקה אחד. השדה השני כולל שדות אופציונליים כמו קלוריות, סוכר ומגנזיום.
- שינה: הנתונים האלה מתעדים נתוני מרווח זמן שקשורים למשך ולסוג השינה של המשתמש.
- נתונים חיוניים: כאן מתועד מידע חיוני על המצב הבריאותי הכללי של המשתמש. הוא כולל נתונים כמו טמפרטורת הגוף, רמת הסוכר בדם, לחץ הדם ורמת החמצן בדם.
פורמט של סוג נתונים
סוגי הנתונים ב-Health Connect מאוחסנים באובייקטים שהם קבוצות משנה של Record
.
לכל סוג נתונים יש שדות משויכים, שיכולים להיות כלליים כמו time
ו-zoneOffset
, או ספציפיים כמו title
, count
ו-percentage
.
בשדות מסוימים נעשה שימוש בסוגי נתונים פשוטים, כמו long, double או string, ובשדות אחרים נעשה שימוש בסוגי נתונים מורכבים כמו ספירה וסוגי נתונים כמו Instant
ו-ZoneOffset
. המאפיינים של השדות האלה יכולים להיות חובה או אופציונליים. חלק מהמאפיינים הם לקריאה בלבד, וחלק מהמאפיינים מוגבלים לטווח ערכים ספציפי.
רשימה מלאה של סוגי הנתונים הזמינים והשדות שלהם מופיעה בכיתות ב-Jetpack.
מאפייני נתונים נוספים
הנתונים ב-Health Connect API כוללים גם מאפייני מטא-נתונים שמפורטים ברשימה הבאה:
- מזהה Health Connect: לכל נקודה של נתונים מוקצה מזהה ייחודי (UID) בזמן היצירה. האפשרות הזו שימושית לפעולות קריאה וכתיבה רגילות. פרטים נוספים זמינים במאמר Health Connect ID.
- Last modified time: חותמת הזמן של המצב האחרון של הרשומה. הוא נוצר באופן אוטומטי ביצירה הראשונה של הרשומה או בכל עדכון.
- מקור הנתונים: ב-Health Connect מאוחסן מידע על האפליקציה שממנה הגיעו הנתונים. הוא מכיל את שם החבילה של המקור הזה, שמתווסף באופן אוטומטי בזמן היצירה.
- מכשיר: ב-Health Connect מאוחסן מידע על המכשיר שממנו הגיעו הנתונים. הוא מכיל את היצרן והדגם של המכשיר, ואתם צריכים לספק את הערך באופן ידני.
- מזהה לקוח: Health Connect מספק מזהי לקוח כדי שאפליקציות לקוח יוכלו להפנות לנתונים באמצעות המזהים שלהן. כך קל יותר לפתור בעיות של התנגשויות ולבצע סנכרון. צריך לספק את הערך הזה לרשומה באופן ידני.
- גרסת רשומת הלקוח: בנוסף למזהה הלקוח, מערכת Health Connect מספקת ניהול גרסאות כדי לעזור במעקב אחרי שינויים במהלך סנכרון הנתונים. הוא מסופק לרשומה באופן ידני.
- שיטת ההקלטה: אפליקציית Health Connect מאפשרת לכם להבין איך הנתונים מתועדים. השיטות האלה כוללות אפליקציות שמתעדות נתונים באופן פסיבי (אוטומטי), ומשתמשים שמתעדים נתונים באופן פעיל או ידני.
מזהה Health Connect
מערכת Health Connect מקצה מזהי ייחודיים (UID) לאובייקטי נתונים חדשים שמוסיפים, שמזהים אותם ומבדילים אותם מאובייקטים אחרים. מזהי Health Connect שימושיים בבקשות קריאה או כתיבה. מזהי Health Connect שונים ממזהי לקוחות. אפליקציית לקוח מקצה מזהי לקוח, בעוד ש-Health Connect מקצה אך ורק מזהי Health Connect.
חשוב לזכור את ההערות הבאות כשעובדים עם מזהי Health Connect:
- לסשנים יש מזהה Health Connect אחד, אבל לנתונים בתוך הסשנים יש מזהי Health Connect משלהם.
- המזהים של Health Connect לא קשורים לחותמות זמן.
- בתרחישי שימוש מסוימים, יכול להיות שתצטרכו לאחסן מזהה Health Connect ספציפי במהלך תהליך עבודה. לדוגמה, מזהה ספציפי נדרש כדי לאחזר ולהציג למשתמש את הנתונים שהזין ביומן.
זמן ב-Health Connect
כל הנתונים שנכתבים ב-Health Connect חייבים לציין את פרטי ההיסט של האזור. ציון הפרש השעון מאפשר לאפליקציות לקרוא את הנתונים ולהציג אותם לפי שעון אזרחי. הזמן האזרחי הוא הזמן המקומי שרלוונטי למשתמש, אבל לא בהכרח לפי זמן אוניברסלי מותאם (UTC).
במקרים נדירים, יכול להיות שההיסט של האזור לא יהיה זמין. כשהדבר קורה ב-Android 14 (API ברמה 34), Health Connect מגדיר את הפרש השעות לפי אזור הזמן שמוגדר כברירת מחדל במערכת של המכשיר. ב-Android 13 ובגרסאות ישנות יותר (רמת API 33 ומטה), אפשר לכתוב ל-Health Connect בלי לציין מידע על היסט של תחום, ויש להימנע מכך במידת האפשר.
הגדרת השעה ואזור הזמן
ציון פרטי ההיסט של האזור בזמן כתיבת הנתונים מספק מידע על אזור הזמן בזמן קריאת הנתונים ב-Health Connect. עם זאת, יכול להיות שהיא לא תצליח לעשות זאת במצבים מסוימים, למשל אם לא צוין הפרש האזורים. האפליקציה צריכה להיות מוכנה לטפל בשני סוגי הנתונים, באופן שמתאים לנסיבות הספציפיות שלכם.
הרשאות
לפני שמבקשים הרשאות, צריך להצהיר עליהן במניפסט של האפליקציה. בטבלאות הבאות מופיע המיפוי המלא של סוגי הנתונים וההרשאות שלהם.
בגרסה 1.0.0-alpha10 ואילך
מסמך עזר בנושא הרשאות | הצהרת הרשאת קריאה |
---|---|
קריאה ברקע |
android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND
|
קריאות בהיסטוריה |
android.permission.health.READ_HEALTH_DATA_HISTORY
|
סוג סיווג הרשומה | הצהרת הרשאות לקריאה וכתיבה |
---|---|
ActiveCaloriesBurned |
android.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
BasalMetabolicRate |
android.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE |
BloodPressure |
android.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE |
CyclingPedalingCadence |
android.permission.health.READ_CYCLING_PEDALING_CADENCE android.permission.health.WRITE_CYCLING_PEDALING_CADENCE |
מרחק |
android.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE |
ElevationGained |
android.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED |
ExerciseSession |
android.permission.health.READ_EXERCISE_ROUTE android.permission.health.READ_EXERCISE_SESSION android.permission.health.WRITE_EXERCISE_ROUTE android.permission.health.WRITE_EXERCISE_SESSION |
FloorsClimbed |
android.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED |
HeartRate |
android.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE |
גובה |
android.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT |
הידרציה |
android.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION |
MindfulnessSession |
android.permission.health.READ_MINDFULNESS android.permission.health.WRITE_MINDFULNESS |
תזונה |
android.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION |
Power |
android.permission.health.READ_POWER android.permission.health.WRITE_POWER |
RestingHeartRate |
android.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE |
SkinTemperature |
android.permission.health.READ_SKIN_TEMPERATURE android.permission.health.WRITE_SKIN_TEMPERATURE |
SleepSession |
android.permission.health.READ_SLEEP_SESSION android.permission.health.WRITE_SLEEP_SESSION |
מהירות |
android.permission.health.READ_SPEED android.permission.health.WRITE_SPEED |
שלבים |
android.permission.health.READ_STEPS android.permission.health.WRITE_STEPS |
StepsCadence |
android.permission.health.READ_STEPS_CADENCE android.permission.health.WRITE_STEPS_CADENCE |
TotalCaloriesBurned |
android.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED |
משקל |
android.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT |
WheelchairPushes |
android.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES |
בגרסה 1.0.0-alpha09 ובגרסאות קודמות
סוג סיווג הרשומה | הצהרת הרשאות לקריאה וכתיבה |
---|---|
ActiveCaloriesBurned |
androidx.health.permission.ActiveCaloriesBurned.READ androidx.health.permission.ActiveCaloriesBurned.WRITE |
BasalMetabolicRate |
androidx.health.permission.BasalMetabolicRate.READ androidx.health.permission.BasalMetabolicRate.WRITE |
BloodPressure |
androidx.health.permission.BloodPressure.READ androidx.health.permission.BloodPressure.WRITE |
CyclingPedalingCadence |
androidx.health.permission.CyclingPedalingCadence.READ androidx.health.permission.CyclingPedalingCadence.WRITE |
מרחק |
androidx.health.permission.Distance.READ androidx.health.permission.Distance.WRITE |
ElevationGained |
androidx.health.permission.ElevationGained.READ androidx.health.permission.ElevationGained.WRITE |
ExerciseSession |
androidx.health.permission.ExerciseSession.READ androidx.health.permission.ExerciseSession.WRITE |
FloorsClimbed |
androidx.health.permission.FloorsClimbed.READ androidx.health.permission.FloorsClimbed.WRITE |
HeartRate |
androidx.health.permission.HeartRate.READ androidx.health.permission.HeartRate.WRITE |
גובה |
androidx.health.permission.Height.READ androidx.health.permission.Height.WRITE |
הידרציה |
androidx.health.permission.Hydration.READ androidx.health.permission.Hydration.WRITE |
תזונה |
androidx.health.permission.Nutrition.READ androidx.health.permission.Nutrition.WRITE |
Power |
androidx.health.permission.Power.READ androidx.health.permission.Power.WRITE |
RestingHeartRate |
androidx.health.permission.RestingHeartRate.READ androidx.health.permission.RestingHeartRate.WRITE |
SleepSession |
androidx.health.permission.SleepSession.READ androidx.health.permission.SleepSession.WRITE |
מהירות |
androidx.health.permission.Speed.READ androidx.health.permission.Speed.WRITE |
שלבים |
androidx.health.permission.Steps.READ androidx.health.permission.Steps.WRITE |
StepsCadence |
androidx.health.permission.StepsCadence.READ androidx.health.permission.StepsCadence.WRITE |
TotalCaloriesBurned |
androidx.health.permission.TotalCaloriesBurned.READ androidx.health.permission.TotalCaloriesBurned.WRITE |
משקל |
androidx.health.permission.Weight.READ androidx.health.permission.Weight.WRITE |
WheelchairPushes |
androidx.health.permission.WheelchairPushes.READ androidx.health.permission.WheelchairPushes.WRITE |
בדיקת סוגי הנתונים וההרשאות
עכשיו, אחרי שסיימתם לתכנן את סוגי הנתונים וההרשאות, תוכלו להטמיע אותם במהלך הפיתוח.
כשבודקים את האפליקציה לפני ההעלאה שלה ל-Play Store, חשוב לבדוק שוב את רשימת סוגי הנתונים וההרשאות שנדרשים לאפליקציה. כך תוכלו להצהיר בצורה מדויקת על השימוש בנתונים באפליקציה.
כשאתם מתכוננים לפרסם את האפליקציה ב-Play Store, עליכם להצהיר על הגישה לסוגי הנתונים של Health Connect שבהם האפליקציה משתמשת. אחרת, יכול להיות שתוצג למשתמשים הודעת שגיאה על כך שהאפליקציה לא יכולה לגשת לסוגי הנתונים של Health Connect כי נדרשת אישור מיוחד.