אפליקציית Health Connect מאחסנת ומארגנת נתונים של אימוני כושר ונתונים של רשומות רפואיות. חשוב להבין קודם אילו סוגי נתונים והרשאות מציעה Health Connect כדי שתוכלו לתכנן את הדרישות של האפליקציה.
אחרי הפיתוח, כשמתכוננים לפרסם את האפליקציה ב-Google Play, צריך להצהיר על השימוש בנתונים באפליקציה וגם על הגישה לסוגי הנתונים של Health Connect שבהם האפליקציה משתמשת. אחרת, יכול להיות שהמשתמשים יקבלו הודעת שגיאה כי לאפליקציה אין גישה לסוגי הנתונים ב-Health Connect, כי הם דורשים אישור מיוחד.
מידע נוסף זמין במאמר בנושא השלמת ההצהרה לגבי אפליקציות בריאות ב-Play Console.
קטגוריות של סוגי נתונים
אפליקציית Health Connect תומכת בסוגי נתונים שמשמשים ברוב אפליקציות הבריאות והכושר, כדי לספק מגוון רחב ככל האפשר. המטרה של Health Connect היא לספק תצוגה מקיפה של נתוני הבריאות ונתונים של אימוני כושר ולאחסן אותם. סוגי הנתונים האלה נכללים בקטגוריות הבאות:
| קטגוריה | תיאור | |
|---|---|---|
| directions_run | פעילות | כך מתועדת כל פעילות שהמשתמש מבצע. הוא יכול לכלול פעילויות בריאות וכושר כמו ריצה ושחייה. |
| straighten | מדדים גופניים | הנתונים האלה כוללים נתונים נפוצים שקשורים לגוף, כמו המשקל של המשתמש וקצב חילוף החומרים הבסיסי שלו. |
| fertile | מעקב אחר המחזור | הנתונים האלה כוללים את המחזורים החודשיים ונקודות נתונים קשורות, כמו התוצאה הבינארית של בדיקת ביוץ. |
| grocery | תזונה | היא אוספת נתונים על סוגי הידרציה ותזונה. האפשרות הראשונה מייצגת את כמות המים שמשתמש צורך בשתייה אחת. האחרון כולל שדות אופציונליים כמו קלוריות, סוכר ומגנזיום. |
| sleep_auto | שינה | הנתונים האלה מתייחסים למשך השינה ולסוג השינה של המשתמש. |
| vital_signs | Vitals | המידע הזה כולל נתונים חיוניים על הבריאות הכללית של המשתמש. היא כוללת נתונים כמו טמפרטורת הגוף, רמת הסוכר בדם, לחץ הדם וריווי החמצן בדם. |
| mindfulness | בריאות וכושר | הנתונים האלה קשורים לבריאות הנפשית ולרווחה של המשתמש. |
מדריכים לחוויית מפתחים
ב-Health Connect יש מדריכים לחוויית מפתחים שמתמקדים בתרחישי שימוש ספציפיים בתחום הבריאות והכושר. במדריכים האלה מוסבר איך להשתמש בסוגי נתונים רלוונטיים יחד כדי ליצור תכונות בתחומים הבאים:
בטבלה הבאה של סוגי הנתונים מצוין גם אילו מדריכים לחוויית משתמש משויכים לכל סוג נתונים.
שדות של סוגי נתונים
טבלת סוגי הנתונים של Health Connect כוללת כמה עמודות של שדות שיעזרו לכם להבין את המבנה והדרישות של כל סוג נתונים. העמודות שיופיעו הן:
| שדה | תיאור | |
|---|---|---|
| schedule | סוג הרשומה | מציין אם הנתונים מתועדים בנקודת זמן מסוימת או לאורך מרווח זמן. הערכים האפשריים הם: Interval, Instantaneous, Series. |
| straighten | היחידה | יחידת המידה של סוג הנתונים (לדוגמה, קלוריות, מטרים, ספירה). |
| star | שדות חובה | אלה שדות חיוניים שצריך לכלול כשכותבים נתונים לסוג הנתונים הזה, כדי לשמור על תקינות הנתונים ועל השימושיות שלהם. |
סוגי נתונים של אימוני כושר ובריאות
לפני שמבקשים הרשאות, צריך להצהיר עליהן במניפסט של האפליקציה. מידע נוסף זמין בקטע הצהרה על הרשאות במדריך למתחילים.
בטבלה הבאה מופיעה רשימה מלאה של סוגי הנתונים, כולל קטגוריה, דגלים של תכונות ומדריכים, והצהרות הרשאה לכל סוג נתונים.
הטבלה הזו מתייחסת לגרסה 1.0.0-alpha09 ומטה של Health Connect SDK. אם אתם משתמשים בגרסה מתקדמת יותר של ה-SDK, תוכלו לעיין במאמר סוגי נתונים של Health Connect לגרסה SDK 1.0.0-alpha10 ואילך.
| סוג הנתונים מדריכים |
קטגוריה | סוג הרשומה הצהרות לגבי הרשאות feature flag |
|---|---|---|
| קלוריות שנשרפו בזמן פעילות מדריך לאימונים
|
פעילות | ActiveCaloriesBurnedRecord
androidx.health.permission.ActiveCaloriesBurned.READ androidx.health.permission.ActiveCaloriesBurned.WRITE סוגי נתונים מצטבריםACTIVE_CALORIES_TOTAL |
| עצימות הפעילות מדריך לאימונים
|
פעילות | ActivityIntensityRecord
FEATURE_ACTIVITY_INTENSITYסוגי נתונים מצטבריםDURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
טמפרטורת הגוף הבסיסית
|
מעקב אחרי המחזור | BasalBodyTemperatureRecord
androidx.health.permission.BasalBodyTemperature.READ androidx.health.permission.BasalBodyTemperature.WRITE |
קצב חילוף החומרים הבסיסי
|
מדדים גופניים | BasalMetabolicRateRecord
androidx.health.permission.BasalMetabolicRate.READ androidx.health.permission.BasalMetabolicRate.WRITE סוגי נתונים מצטבריםBASAL_CALORIES_TOTAL |
| רמת סוכר בדם מדריך Vitals
|
סימנים חיוניים | BloodGlucoseRecord
androidx.health.permission.BloodGlucose.READ androidx.health.permission.BloodGlucose.WRITE |
| לחץ דם מדריך סימנים חיוניים
|
סימנים חיוניים | BloodPressureRecord
androidx.health.permission.BloodPressure.READ androidx.health.permission.BloodPressure.WRITE סוגי נתונים מצטבריםDIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
אחוז השומן בגוף
|
מדדים גופניים | BodyFatRecord
androidx.health.permission.BodyFat.READ androidx.health.permission.BodyFat.WRITE |
| Body temperature Vitals guide
|
סימנים חיוניים | BodyTemperatureRecord
androidx.health.permission.BodyTemperature.READ androidx.health.permission.BodyTemperature.WRITE |
מסת המים בגוף
|
מדדים גופניים | BodyWaterMassRecord
androidx.health.permission.BodyWaterMass.READ androidx.health.permission.BodyWaterMass.WRITE |
מסת עצם
|
מדדים גופניים | BoneMassRecord
androidx.health.permission.BoneMass.READ androidx.health.permission.BoneMass.WRITE |
ריר צוואר הרחם
|
מעקב אחרי המחזור | CervicalMucusRecord
androidx.health.permission.CervicalMucus.READ androidx.health.permission.CervicalMucus.WRITE |
| קצב הדיווש ברכיבה על אופניים מדריך אימונים
|
פעילות | CyclingPedalingCadenceRecord
androidx.health.permission.Exercise.READ androidx.health.permission.Exercise.WRITE סוגי נתונים מצטבריםRPM_AVGRPM_MAXRPM_MIN |
| מרחק מדריך אימונים
|
פעילות | DistanceRecord
androidx.health.permission.Distance.READ androidx.health.permission.Distance.WRITE סוגי נתונים מצטבריםDISTANCE_TOTAL |
| העלייה המצטברת מדריך לאימונים
|
פעילות | ElevationGainedRecord
androidx.health.permission.ElevationGained.READ androidx.health.permission.ElevationGained.WRITE סוגי נתונים מצטבריםELEVATION_GAINED_TOTAL |
| פעילות גופנית מדריך אימונים מדריך הוספת מסלולים לפעילות גופנית
|
פעילות | ExerciseSessionRecord
androidx.health.permission.ExerciseSession.READ androidx.health.permission.ExerciseSession.WRITE סוגי פעילות גופניתהצגת כל סוגי התרגיליםEXERCISE_TYPE_UNKNOWNEXERCISE_TYPE_BADMINTONEXERCISE_TYPE_BASEBALLEXERCISE_TYPE_BASKETBALLEXERCISE_TYPE_BIKINGEXERCISE_TYPE_BIKING_STATIONARYEXERCISE_TYPE_BOOT_CAMPEXERCISE_TYPE_BOXINGEXERCISE_TYPE_CALISTHENICSEXERCISE_TYPE_CRICKETEXERCISE_TYPE_DANCINGEXERCISE_TYPE_ELLIPTICALEXERCISE_TYPE_EXERCISE_CLASSEXERCISE_TYPE_FENCINGEXERCISE_TYPE_FOOTBALL_AMERICANEXERCISE_TYPE_FOOTBALL_AUSTRALIANEXERCISE_TYPE_FRISBEE_DISCEXERCISE_TYPE_GOLFEXERCISE_TYPE_GUIDED_BREATHINGEXERCISE_TYPE_GYMNASTICSEXERCISE_TYPE_HANDBALLEXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAININGEXERCISE_TYPE_HIKINGEXERCISE_TYPE_ICE_HOCKEYEXERCISE_TYPE_ICE_SKATINGEXERCISE_TYPE_MARTIAL_ARTSEXERCISE_TYPE_PADDLINGEXERCISE_TYPE_PARAGLIDINGEXERCISE_TYPE_PILATESEXERCISE_TYPE_RACQUETBALLEXERCISE_TYPE_ROCK_CLIMBINGEXERCISE_TYPE_ROLLER_HOCKEYEXERCISE_TYPE_ROWINGEXERCISE_TYPE_ROWING_MACHINEEXERCISE_TYPE_RUGBYEXERCISE_TYPE_RUNNINGEXERCISE_TYPE_RUNNING_TREADMILLEXERCISE_TYPE_SAILINGEXERCISE_TYPE_SCUBA_DIVINGEXERCISE_TYPE_SKATINGEXERCISE_TYPE_SKIINGEXERCISE_TYPE_SNOWBOARDINGEXERCISE_TYPE_SNOWSHOEINGEXERCISE_TYPE_SOCCEREXERCISE_TYPE_SOFTBALLEXERCISE_TYPE_SQUASHEXERCISE_TYPE_STAIR_CLIMBINGEXERCISE_TYPE_STAIR_CLIMBING_MACHINEEXERCISE_TYPE_STRENGTH_TRAININGEXERCISE_TYPE_STRETCHINGEXERCISE_TYPE_SURFINGEXERCISE_TYPE_SWIMMING_OPEN_WATEREXERCISE_TYPE_SWIMMING_POOLEXERCISE_TYPE_TABLE_TENNISEXERCISE_TYPE_TENNISEXERCISE_TYPE_VOLLEYBALLEXERCISE_TYPE_WALKINGEXERCISE_TYPE_WATER_POLOEXERCISE_TYPE_WEIGHTLIFTINGEXERCISE_TYPE_WHEELCHAIREXERCISE_TYPE_OTHER_WORKOUTEXERCISE_TYPE_YOGAסוגי נתונים מצטבריםEXERCISE_DURATION_TOTAL |
| מספר הקומות שעליתם מדריך אימונים
|
פעילות | FloorsClimbedRecord
androidx.health.permission.FloorsClimbed.READ androidx.health.permission.FloorsClimbed.WRITE סוגי נתונים מצטבריםFLOORS_CLIMBED_TOTAL |
| דופק מדריך Vitals
|
סימנים חיוניים | HeartRateRecord
androidx.health.permission.HeartRate.READ androidx.health.permission.HeartRate.WRITE סוגי נתונים מצטבריםBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
| Heart rate variability Vitals guide
|
סימנים חיוניים | HeartRateVariabilityRmssdRecord
androidx.health.permission.HeartRateVariability.READ androidx.health.permission.HeartRateVariability.WRITE |
גובה
|
מדדים גופניים | HeightRecord
androidx.health.permission.Height.READ androidx.health.permission.Height.WRITE סוגי נתונים מצטבריםHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
הידרציה
|
תזונה | HydrationRecord
androidx.health.permission.Hydration.READ androidx.health.permission.Hydration.WRITE סוגי נתונים מצטבריםVOLUME_TOTAL |
דימום בין וסתי
|
מעקב אחרי המחזור | IntermenstrualBleedingRecord
androidx.health.permission.IntermenstrualBleeding.READ androidx.health.permission.IntermenstrualBleeding.WRITE |
מסת גוף רזה
|
מדדים גופניים | LeanBodyMassRecord
androidx.health.permission.LeanBodyMass.READ androidx.health.permission.LeanBodyMass.WRITE |
| Menstruation For MenstruationFlowRecord:
ב-MenstruationPeriodRecord:
|
מעקב אחרי המחזור | MenstruationFlowRecord
MenstruationPeriodRecord
androidx.health.permission.Menstruation.READ androidx.health.permission.Menstruation.WRITE |
| מיינדפולנס מדריך למעקב אחרי מיינדפולנס
|
בריאות וכושר | MindfulnessSessionRecord
FEATURE_MINDFULNESS_SESSIONסוגי סשנים של מיינדפולנסהצגת כל הסוגים של סשנים של מיינדפולנסMINDFULNESS_SESSION_TYPE_UNKNOWNMINDFULNESS_SESSION_TYPE_MEDITATIONMINDFULNESS_SESSION_TYPE_BREATHINGMINDFULNESS_SESSION_TYPE_MUSICMINDFULNESS_SESSION_TYPE_MOVEMENTMINDFULNESS_SESSION_TYPE_UNGUIDEDסוגי נתונים מצטבריםMINDFULNESS_DURATION_TOTAL |
תזונה
|
תזונה | NutritionRecord
androidx.health.permission.Nutrition.READ androidx.health.permission.Nutrition.WRITE סוגי נתונים מצטבריםBIOTIN_TOTALCAFFEINE_TOTALCALCIUM_TOTALCHLORIDE_TOTALCHOLESTEROL_TOTALCHROMIUM_TOTALCOPPER_TOTALDIETARY_FIBER_TOTALENERGY_FROM_FAT_TOTALENERGY_TOTALFOLATE_TOTALFOLIC_ACID_TOTALIODINE_TOTALIRON_TOTALMAGNESIUM_TOTALMANGANESE_TOTALMOLYBDENUM_TOTALMONOUNSATURATED_FAT_TOTALNIACIN_TOTALPANTOTHENIC_ACID_TOTALPHOSPHORUS_TOTALPOLYUNSATURATED_FAT_TOTALPOTASSIUM_TOTALPROTEIN_TOTALRIBOFLAVIN_TOTALSATURATED_FAT_TOTALSELENIUM_TOTALSODIUM_TOTALSUGAR_TOTALTHIAMIN_TOTALTOTAL_CARBOHYDRATE_TOTALTOTAL_FAT_TOTALTRANS_FAT_TOTALUNSATURATED_FAT_TOTALVITAMIN_A_TOTALVITAMIN_B12_TOTALVITAMIN_B6_TOTALVITAMIN_C_TOTALVITAMIN_D_TOTALVITAMIN_E_TOTALVITAMIN_K_TOTALZINC_TOTAL |
בדיקת ביוץ
|
מעקב אחרי המחזור | OvulationTestRecord
androidx.health.permission.OvulationTest.READ androidx.health.permission.OvulationTest.WRITE |
| רמת החמצן בדם מדריך הנתונים החיוניים
|
סימנים חיוניים | OxygenSaturationRecord
androidx.health.permission.OxygenSaturation.READ androidx.health.permission.OxygenSaturation.WRITE |
| פעילות גופנית מתוכננת מדריך לאימונים מדריך לתוכניות אימונים
|
פעילות | PlannedExerciseSessionRecord
androidx.health.permission.PlannedExerciseSession.READ androidx.health.permission.PlannedExerciseSession.WRITE FEATURE_PLANNED_EXERCISE |
| Power מדריך Workouts
|
פעילות | PowerRecord
androidx.health.permission.Power.READ androidx.health.permission.Power.WRITE סוגי נתונים מצטבריםPOWER_AVGPOWER_MAXPOWER_MIN |
| קצב נשימה מדריך Vitals
|
סימנים חיוניים | RespiratoryRateRecord
androidx.health.permission.RespiratoryRate.READ androidx.health.permission.RespiratoryRate.WRITE |
| הדופק במנוחה מדריך Vitals
|
סימנים חיוניים | RestingHeartRateRecord
androidx.health.permission.RestingHeartRate.READ androidx.health.permission.RestingHeartRate.WRITE סוגי נתונים מצטבריםBPM_AVGBPM_MAXBPM_MIN |
פעילות מינית
|
מעקב אחרי המחזור | SexualActivityRecord
androidx.health.permission.SexualActivity.READ androidx.health.permission.SexualActivity.WRITE |
| טמפרטורת העור מדריך לסימנים החיוניים מדריך למדידת טמפרטורת העור
|
סימנים חיוניים | SkinTemperatureRecord
FEATURE_SKIN_TEMPERATUREסוגי נתונים מצטבריםTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| רשומת שינה מדריך לשינה מדריך למעקב אחרי רשומות שינה
|
שינה | SleepSessionRecord
androidx.health.permission.SleepSession.READ androidx.health.permission.SleepSession.WRITE סוגי נתונים מצטבריםSLEEP_DURATION_TOTAL |
| מהירות מדריך Workouts
|
פעילות | SpeedRecord
androidx.health.permission.Speed.READ androidx.health.permission.Speed.WRITE סוגי נתונים מצטבריםSPEED_AVGSPEED_MAXSPEED_MIN |
| שלבים מדריך Workouts ל-StepsRecord:
ב-StepsCadenceRecord:
|
פעילות | StepsRecord
StepsCadenceRecord
androidx.health.permission.Steps.READ androidx.health.permission.Steps.WRITE סוגי נתונים מצטברים של StepsRecordCOUNT_TOTALסוגי נתונים נצברים עבור StepsCadenceRecordRATE_AVGRATE_MAXRATE_MIN |
| סך הקלוריות שנשרפו מדריך לאימונים
|
פעילות | TotalCaloriesBurnedRecord
androidx.health.permission.TotalCaloriesBurned.READ androidx.health.permission.TotalCaloriesBurned.WRITE סוגי נתונים מצטבריםENERGY_TOTAL |
| צריכת החמצן המרבית (VO2 max) מדריך לאימונים
|
פעילות | Vo2MaxRecord
androidx.health.permission.VO2Max.READ androidx.health.permission.VO2Max.WRITE |
משקל
|
מדדים גופניים | WeightRecord
androidx.health.permission.Weight.READ androidx.health.permission.Weight.WRITE סוגי נתונים מצטבריםWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
| דחיפות כיסא גלגלים מדריך לאימונים
|
פעילות | WheelchairPushesRecord
androidx.health.permission.WheelchairPushes.READ androidx.health.permission.WheelchairPushes.WRITE סוגי נתונים מצטבריםCOUNT_TOTAL |