אפליקציית Health Connect מאחסנת ומארגנת נתוני בריאות ונתונים של אימוני כושר ונתונים של רשומות רפואיות. חשוב להבין קודם אילו סוגי נתונים והרשאות זמינים ב-Health Connect כדי שתוכלו לתכנן את הדרישות של האפליקציה.
אחרי הפיתוח, כשמתכוננים לפרסם את האפליקציה בחנות Play, צריך להצהיר על השימוש בנתונים באפליקציה וגם על הגישה לסוגי הנתונים של Health Connect שבהם האפליקציה משתמשת. אחרת, יכול להיות שהמשתמשים יקבלו הודעת שגיאה כי לאפליקציה אין גישה לסוגי הנתונים ב-Health Connect, כי הם דורשים אישור מיוחד.
מידע נוסף זמין במאמר בנושא השלמת ההצהרה לגבי אפליקציות בריאות ב-Play Console.
קטגוריות של סוגי נתונים
אפליקציית Health Connect תומכת בסוגי נתונים שמשמשים ברוב אפליקציות הבריאות והכושר, כדי לספק מגוון רחב ככל האפשר. המטרה של Health Connect היא לספק תצוגה מקיפה של נתוני הבריאות ונתונים של אימוני כושר ולאחסן אותם. סוגי הנתונים האלה נכללים בקטגוריות הבאות:
| קטגוריה | תיאור | |
|---|---|---|
| directions_run | פעילות | כך מתועדת כל פעילות שהמשתמש מבצע. הוא יכול לכלול פעילויות בריאות וכושר כמו ריצה ושחייה. |
| יישור | מדדים גופניים | הנתונים האלה כוללים מידע נפוץ שקשור לגוף, כמו המשקל של המשתמש וקצב חילוף החומרים הבסיסי שלו. |
| fertile | מעקב אחר המחזור | הנתונים האלה כוללים את המחזורים החודשיים ונקודות נתונים קשורות, כמו התוצאה הבינארית של בדיקת ביוץ. |
| מצרכים | תזונה | הנתונים שמתועדים הם סוגי נתונים של הידרציה ותזונה. האפשרות הראשונה מייצגת את כמות המים שמשתמש צורך במשקה אחד. האפשרות השנייה כוללת שדות אופציונליים כמו קלוריות, סוכר ומגנזיום. |
| sleep_auto | שינה | הנתונים האלה כוללים מידע על משך השינה וסוג השינה של המשתמש. |
| vital_signs | Vitals | המידע הזה כולל נתונים חיוניים על הבריאות הכללית של המשתמש. הוא כולל נתונים כמו חום גוף, רמת סוכר בדם, לחץ דם ורמת החמצן בדם. |
| מיינדפולנס | בריאות וכושר | הנתונים האלה קשורים לבריאות הנפשית ולרווחה של המשתמש. |
מדריכים לחוויית מפתחים
אפליקציית Health Connect מספקת מדריכים לחוויית מפתחים שמתמקדים בתרחישי שימוש ספציפיים בתחום הבריאות והכושר. במדריכים האלה מוסבר איך להשתמש בסוגי נתונים רלוונטיים יחד כדי ליצור תכונות ל:
בטבלה הבאה של סוגי הנתונים מצוין גם אילו מדריכים לחוויית משתמש משויכים לכל סוג נתונים.
שדות של סוגי נתונים
טבלת סוגי הנתונים של Health Connect כוללת כמה עמודות של שדות שיעזרו לכם להבין את המבנה והדרישות של כל סוג נתונים. העמודות שיופיעו הן:
| שדה | תיאור | |
|---|---|---|
| לוח זמנים | סוג הרשומה | מציין אם הנתונים מתועדים בנקודת זמן מסוימת או במרווח זמן. הערכים האפשריים הם: Interval, Instantaneous, Series. |
| יישור | היחידה | יחידת המידה של סוג הנתונים (לדוגמה, קלוריות, מטרים, ספירה). |
| כוכב | שדות חובה | אלה השדות החיוניים שצריך לכלול כשכותבים נתונים לסוג הנתונים הזה, כדי לשמור על תקינות הנתונים ועל השימושיות שלהם. |
סוגי נתונים של בריאות ואימוני כושר
לפני שמבקשים הרשאות כלשהן, צריך להצהיר עליהן במניפסט של האפליקציה. מידע נוסף זמין בקטע הצהרת הרשאות במדריך לתחילת העבודה.
כדי לקרוא נתונים כשהאפליקציה פועלת ברקע, או כדי לקרוא נתונים היסטוריים, צריך להצהיר על קבוצה נוספת של הרשאות קריאה בנפרד מההרשאות לסוגי נתונים:
| הרשאת קריאה נוספת | הצהרת הרשאות |
|---|---|
|
קריאת נתונים ברקע
מדריך לדוגמה של קריאה ברקע |
android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND |
|
קריאת נתונים היסטוריים
מדריך לקריאת נתונים בני יותר מ-30 יום |
android.permission.health.READ_HEALTH_DATA_HISTORY |
1. בחירת גרסת Jetpack
הצהרות ההרשאות שונות בין גרסאות Jetpack, לכן חשוב לבחור את טווח גרסאות Jetpack שבו האפליקציה משתמשת.
2. סינון הטבלה של סוגי הנתונים
בטבלה הבאה מופיעה רשימה מלאה של סוגי הנתונים, כולל קטגוריה, דגלים של תכונות ומדריכים, והצהרות הרשאה.
| סוג הנתונים מדריכים |
קטגוריה | סוג הרשומה הצהרות לגבי הרשאות מתג feature flag |
|---|---|---|
| קלוריות שנשרפו בזמן פעילות מדריך לאימונים
|
פעילות | ActiveCaloriesBurnedRecord
android.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED סוגים של נתונים מצטבריםACTIVE_CALORIES_TOTAL |
| עצימות הפעילות מדריך אימונים
|
פעילות | ActivityIntensityRecord
android.permission.health.READ_ACTIVITY_INTENSITY android.permission.health.WRITE_ACTIVITY_INTENSITY FEATURE_ACTIVITY_INTENSITYסוגים של נתונים מצטבריםDURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
טמפרטורת הגוף הבסיסית
|
מעקב אחר המחזור | BasalBodyTemperatureRecord
android.permission.health.READ_BASAL_BODY_TEMPERATURE android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
קצב חילוף החומרים הבסיסי
|
מדדים גופניים | BasalMetabolicRateRecord
android.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE סוגים של נתונים מצטבריםBASAL_CALORIES_TOTAL |
| רמת סוכר בדם מדריך מדדים חיוניים
|
סימנים חיוניים | BloodGlucoseRecord
android.permission.health.READ_BLOOD_GLUCOSE android.permission.health.WRITE_BLOOD_GLUCOSE |
| לחץ דם מדריך מדדים חיוניים
|
סימנים חיוניים | BloodPressureRecord
android.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE סוגים של נתונים מצטבריםDIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
Body fat
|
מדדים גופניים | BodyFatRecord
android.permission.health.READ_BODY_FAT android.permission.health.WRITE_BODY_FAT |
| Body temperature Vitals guide
|
סימנים חיוניים | BodyTemperatureRecord
android.permission.health.READ_BODY_TEMPERATURE android.permission.health.WRITE_BODY_TEMPERATURE |
Body water mass
|
מדדים גופניים | BodyWaterMassRecord
android.permission.health.READ_BODY_WATER_MASS android.permission.health.WRITE_BODY_WATER_MASS |
מסת עצם
|
מדדים גופניים | BoneMassRecord
android.permission.health.READ_BONE_MASS android.permission.health.WRITE_BONE_MASS |
ריר צוואר הרחם
|
מעקב אחר המחזור | CervicalMucusRecord
android.permission.health.READ_CERVICAL_MUCUS android.permission.health.WRITE_CERVICAL_MUCUS |
| קצב הדיווש ברכיבה על אופניים מדריך אימוני כושר
|
פעילות | CyclingPedalingCadenceRecord
android.permission.health.READ_EXERCISE android.permission.health.WRITE_EXERCISE סוגים של נתונים מצטבריםRPM_AVGRPM_MAXRPM_MIN |
| מרחק מדריך אימונים
|
פעילות | DistanceRecord
android.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE סוגים של נתונים מצטבריםDISTANCE_TOTAL |
| עלייה מדריך לאימונים
|
פעילות | ElevationGainedRecord
android.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED סוגים של נתונים מצטבריםELEVATION_GAINED_TOTAL |
| פעילות גופנית מדריך אימונים מדריך הוספת מסלולים לפעילות גופנית
|
פעילות | ExerciseSessionRecord
android.permission.health.READ_EXERCISE android.permission.health.READ_EXERCISE_ROUTE android.permission.health.WRITE_EXERCISE android.permission.health.WRITE_EXERCISE_ROUTE סוגי פעילות גופניתהצגת כל סוגי הפעילות הגופנית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
android.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED סוגים של נתונים מצטבריםFLOORS_CLIMBED_TOTAL |
| דופק מדריך סימנים חיוניים
|
סימנים חיוניים | HeartRateRecord
android.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE סוגים של נתונים מצטבריםBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
| Heart rate variability Vitals guide
|
סימנים חיוניים | HeartRateVariabilityRmssdRecord
android.permission.health.READ_HEART_RATE_VARIABILITY android.permission.health.WRITE_HEART_RATE_VARIABILITY |
גובה
|
מדדים גופניים | HeightRecord
android.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT סוגים של נתונים מצטבריםHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
הידרציה
|
תזונה | HydrationRecord
android.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION סוגים של נתונים מצטבריםVOLUME_TOTAL |
דימום בין וסתי
|
מעקב אחר המחזור | IntermenstrualBleedingRecord
android.permission.health.READ_INTERMENSTRUAL_BLEEDING android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
מסת גוף רזה
|
מדדים גופניים | LeanBodyMassRecord
android.permission.health.READ_LEAN_BODY_MASS android.permission.health.WRITE_LEAN_BODY_MASS |
| Menstruation For MenstruationFlowRecord:
ב-MenstruationPeriodRecord:
|
מעקב אחר המחזור | MenstruationFlowRecord
MenstruationPeriodRecord
android.permission.health.READ_MENSTRUATION android.permission.health.WRITE_MENSTRUATION |
| מיינדפולנס מדריך מעקב אחרי מיינדפולנס
|
בריאות וכושר | MindfulnessSessionRecord
android.permission.health.READ_MINDFULNESS android.permission.health.WRITE_MINDFULNESS FEATURE_MINDFULNESS_SESSIONסוגים של נתונים מצטבריםMINDFULNESS_DURATION_TOTAL |
תזונה
|
תזונה | NutritionRecord
android.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION סוגים של נתונים מצטברים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
android.permission.health.READ_OVULATION_TEST android.permission.health.WRITE_OVULATION_TEST |
| רמת החמצן בדם מדריך נתונים חיוניים
|
סימנים חיוניים | OxygenSaturationRecord
android.permission.health.READ_OXYGEN_SATURATION android.permission.health.WRITE_OXYGEN_SATURATION |
| פעילות גופנית מתוכננת מדריך אימונים מדריך תוכניות אימונים
|
פעילות | PlannedExerciseSessionRecord
android.permission.health.READ_PLANNED_EXERCISE android.permission.health.WRITE_PLANNED_EXERCISE FEATURE_PLANNED_EXERCISE |
| Power מדריך Workouts
|
פעילות | PowerRecord
android.permission.health.READ_POWER android.permission.health.WRITE_POWER סוגים של נתונים מצטבריםPOWER_AVGPOWER_MAXPOWER_MIN |
| קצב נשימה מדריך Vitals
|
סימנים חיוניים | RespiratoryRateRecord
android.permission.health.READ_RESPIRATORY_RATE android.permission.health.WRITE_RESPIRATORY_RATE |
| הדופק במנוחה מדריך סימנים חיוניים
|
סימנים חיוניים | RestingHeartRateRecord
android.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE סוגים של נתונים מצטבריםBPM_AVGBPM_MAXBPM_MIN |
פעילות מינית
|
מעקב אחר המחזור | SexualActivityRecord
android.permission.health.READ_SEXUAL_ACTIVITY android.permission.health.WRITE_SEXUAL_ACTIVITY |
| טמפרטורת העור מדריך לסימנים החיוניים מדריך למדידת טמפרטורת העור
|
סימנים חיוניים | SkinTemperatureRecord
android.permission.health.READ_SKIN_TEMPERATURE android.permission.health.WRITE_SKIN_TEMPERATURE FEATURE_SKIN_TEMPERATUREסוגים של נתונים מצטבריםTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| רשומת שינה מדריך לשינה מדריך למעקב אחרי רשומות שינה
|
שינה | SleepSessionRecord
android.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP סוגים של נתונים מצטבריםSLEEP_DURATION_TOTAL |
| מהירות מדריך Workouts
|
פעילות | SpeedRecord
android.permission.health.READ_SPEED android.permission.health.WRITE_SPEED סוגים של נתונים מצטבריםSPEED_AVGSPEED_MAXSPEED_MIN |
| שלבים מדריך Workouts ל-StepsRecord:
ב-StepsCadenceRecord:
|
פעילות | StepsRecord
StepsCadenceRecord
android.permission.health.READ_STEPS android.permission.health.WRITE_STEPS סוגי נתונים מצטברים של StepsRecordCOUNT_TOTALסוגי נתונים נצברים עבור StepsCadenceRecordRATE_AVGRATE_MAXRATE_MIN |
| סך הקלוריות שנשרפו מדריך לאימונים
|
פעילות | TotalCaloriesBurnedRecord
android.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED סוגים של נתונים מצטבריםENERGY_TOTAL |
| צריכת החמצן המרבית (VO2 max) מדריך לאימונים
|
פעילות | Vo2MaxRecord
android.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
משקל
|
מדדים גופניים | WeightRecord
android.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT סוגים של נתונים מצטבריםWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
| דחיפות כיסא גלגלים מדריך לאימונים
|
פעילות | WheelchairPushesRecord
android.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES סוגים של נתונים מצטבריםCOUNT_TOTAL |