אפליקציית Health Connect מאחסנת ומארגנת נתונים של אימוני כושר ונתונים של רשומות רפואיות. חשוב להבין קודם אילו סוגי נתונים והרשאות מציעה Health Connect כדי שתוכלו לתכנן את הדרישות של האפליקציה.
אחרי הפיתוח, כשמתכוננים לפרסם את האפליקציה בחנות 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 | שדות חובה | אלה שדות חיוניים שצריך לכלול כשכותבים נתונים לסוג הנתונים הזה, כדי לשמור על תקינות הנתונים ועל השימושיות שלהם. |
סוגי נתונים של אימוני כושר ובריאות
לפני שמבקשים הרשאות, צריך להצהיר עליהן במניפסט של האפליקציה. מידע נוסף זמין בקטע הצהרת הרשאות במדריך לתחילת העבודה.
כדי לקרוא נתונים כשהאפליקציה פועלת ברקע, או כדי לקרוא נתונים היסטוריים, צריך להצהיר על קבוצה נוספת של הרשאות קריאה בנפרד מההרשאות של סוג הנתונים:
| הרשאת קריאה נוספת | הצהרת הרשאות |
|---|---|
|
קריאת נתונים ברקע
מדריך לדוגמה של קריאה ברקע |
android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND |
|
קריאת נתונים היסטוריים
מדריך לקריאת נתונים בני יותר מ-30 יום |
android.permission.health.READ_HEALTH_DATA_HISTORY |
בטבלה הבאה מופיעה רשימה מלאה של סוגי הנתונים, כולל קטגוריה, דגלים של תכונות ומדריכים, והצהרות הרשאה לכל סוג נתונים.
הטבלה הזו מתייחסת לגרסה 1.0.0-alpha10 ואילך של Health Connect SDK. אם אתם משתמשים בגרסה ישנה יותר של ה-SDK, תוכלו לעיין בסוגי הנתונים של Health Connect לגרסה SDK 1.0.0-alpha09 ומטה.
| סוג הנתונים מדריכים |
קטגוריה | סוג הרשומה הצהרות לגבי הרשאות 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 |
| רמת סוכר בדם מדריך Vitals
|
סימנים חיוניים | 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 |
אחוז השומן בגוף
|
מדדים גופניים | 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 |
מסת המים בגוף
|
מדדים גופניים | 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 |
| דופק מדריך Vitals
|
סימנים חיוניים | 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_SESSION_TYPE_UNKNOWNMINDFULNESS_SESSION_TYPE_MEDITATIONMINDFULNESS_SESSION_TYPE_BREATHINGMINDFULNESS_SESSION_TYPE_MUSICMINDFULNESS_SESSION_TYPE_MOVEMENTMINDFULNESS_SESSION_TYPE_UNGUIDEDסוגי נתונים מצטברים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 |
| הדופק במנוחה מדריך Vitals
|
סימנים חיוניים | 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 |