אפליקציית Health Connect מאחסנת ובונה את נתוני הבריאות והכושר. הוא גם כולל לאופן שבו סוגים שונים של נתונים נמדדים. סוגי הנתונים האלה כוללים דופק מדידות שמתבצעות באופן מיידי, מספר הצעדים שנמדד לאורך זמן ונתוני השינה שנמדדו. בסשנים.
חשוב להבין קודם אילו סוגי נתונים והרשאות גישה לנתונים מחברים מבצעים כדי שתוכלו לתכנן את דרישות האפליקציה. עכשיו אפשר עליכם לבדוק את סוגי הנתונים לפני שתוכלו להשלים את הדרישות.
קטגוריות של סוגי נתונים
Health Connect תומכת בסוגי הנתונים שמשמשים את רוב סוגי הנתונים הבריאות והכושר כדי לספק מגוון רב ככל האפשר. המטרה של Health Connect היא להציע תצוגה מקיפה ואחסון של נתוני הבריאות והכושר. סוגי הנתונים האלה נופלים לקטגוריות הבאות:
- פעילות: בהגדרה הזו מתועדת כל הפעילות של המשתמש. הוא יכול לכלול פעילויות בריאות וכושר כמו ריצה, שחייה ושינה.
- מדדים גופניים: מדידה זו מתעדת נתונים נפוצים שקשורים לגוף, כמו משקל המשתמש והקצב המטבולי הבסיסי שלו.
- מעקב אחר המחזור: מציין את המחזור החודשי ונקודות נתונים קשורות, כמו התוצאה הבינארית של בדיקת ביוץ.
- תזונה: סוג הנתונים הזה לגבי מאזן הנוזלים ותזונה. הקודם מייצג את כמות המים שמשתמש שותה במשקה אחד. האחרון כולל שדות אופציונליים כמו קלוריות, סוכר ומגנזיום.
- שינה: תיעוד של נתוני הפוגות הקשורים לאורך ולסוג של המשתמש של שינה.
- סימנים חיוניים: לתעד מידע חיוני לגבי המצב הכללי של המשתמש. בריאות. הוא כולל נתונים כמו טמפרטורת הגוף, רמת הסוכר בדם, לחץ ורמות חמצן בדם.
פורמט של סוג הנתונים
סוגי הנתונים ב-Health Connect מאוחסנים באובייקטים שהם מחלקות משנה של
Record
לכל סוג נתונים יש שדות משויכים שהם גנריים, כמו
time
וגם zoneOffset
, או ספציפיים כמו title
, count
ו-percentage
.
בשדות מסוימים נעשה שימוש בסוגים פשוטים, כמו 'ארוך', 'כפול' או 'מחרוזת'. אחרים משתמשים
סוגים מורכבים כמו ספירה ומחלקות כמו Instant
ZoneOffset
המאפיינים של השדות האלה יכולים להיות חובה או
אופציונלי. חלק מהמאפיינים מוגדרים לקריאה בלבד, וחלק מהמאפיינים מוצמדים
טווח ערכים ספציפי.
הרשימה המלאה של סוגי הנתונים הזמינים והשדות שלהם זמינה בכיתות. ב-Jetpack.
מאפייני נתונים נוספים
הנתונים ב-Health Connect API כוללים גם מאפייני מטא-נתונים שמתוארים ברשימה הבאה:
- Health Connect ID: לכל נקודת נתונים מוקצית מזהה ייחודי (UID) בזמן היצירה. האפשרות הזאת שימושית לפעולות רגילות של קריאה וכתיבה. למידע נוסף, אפשר לעיין ב-Health Connect ID.
- מועד השינוי האחרון: מציין את חותמת הזמן של המופע האחרון שבו רשומה יש עדכון. הוא נוצר באופן אוטומטי ביצירה הראשונה של או בכל עדכון.
- מקור נתונים: Health Connect מאחסנת מידע על האפליקציה שבה הגיעו נתונים מ-. הוא מכיל את שם החבילה של המקור הזה, כלומר נוסף באופן אוטומטי כשיוצרים אותם.
- מכשיר: אפליקציית Health Connect שומרת מידע על המכשיר שבו נמצאים הנתונים הגיעו מ-. היא מכילה את היצרן והדגם של המכשיר, שאותו לספק את הערך באופן ידני.
- Client ID: Health Connect מספקת מזהי לקוח כדי שאפליקציות של לקוחות יוכלו יתייחסו לנתונים באמצעות מזהים משלהם, דבר שיעזור לפתור סכסוכים שהופך את הסנכרון לפשוט יותר. הערך מסופק לרשומה באופן ידני.
- גרסת רשומת הלקוח: יחד עם ה-Client ID, אפליקציית Health Connect מספקת ניהול גרסאות כדי לעזור במעקב אחר שינויים במהלך סנכרון נתונים. הנתון הזה מסופק ל את הרשומה באופן ידני.
- שיטת ההקלטה: Health Connect מאפשרת לכם להבין איך הנתונים מתועדים. השיטות האלה כוללות אפליקציות שמתעדות נתונים באופן פסיבי (אוטומטי) ומשתמשים לתעד נתונים באופן פעיל או ידני.
מזהה Health Connect
Health Connect מקצה מזהים ייחודיים (UID) לאובייקטים חדשים של נתונים שנוספו, שמזהים אובייקטים של נתונים ומבדילים אותם מאחרים. מזהים של Health Connect שימושיים בבקשות קריאה או כתיבה. מזהי Health Connect לא זהים ל- מזהי לקוח. אפליקציית לקוח מקצה מזהי Client-ID, ואילו 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 ואילך
הקלטת סוג הכיתה | הצהרה על הרשאות קריאה וכתיבה |
---|---|
ActiveCaloriesBurned |
android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
טמפרטורת גוף קבועה |
android.permission.health.READ_BASAL_BODY_NETWORK
android.permission.health.WRITE_BASAL_BODY_NETWORK |
BasalMetabolicRate |
android.permission.health.READ_BASAL_metaBOLIC_RATE
android.permission.health.WRITE_BASAL_metaBOLIC_RATE |
BloodGlucose |
android.permission.health.READ_BLOOD_GLUCOSE
android.permission.health.WRITE_BLOOD_GLUCOSE |
לחץ דם |
android.permission.health.READ_BLOOD_PRESSURE
android.permission.health.WRITE_BLOOD_PRESSURE |
BodyFat |
android.permission.health.READ_BODY_FAT
android.permission.health.WRITE_BODY_FAT |
טמפרטורת הגוף |
android.permission.health.READ_BODY_CREATOR
android.permission.health.WRITE_BODY_NETWORK |
BodyWaterMass |
android.permission.health.READ_BODY_WATER_MASS
android.permission.health.WRITE_BODY_WATER_MASS |
BoneMass |
android.permission.health.READ_BONE_MASS
android.permission.health.WRITE_BONE_MASS |
CervicalMucus |
android.permission.health.READ_CERVtrial_MUCUS
android.permission.health.WRITE_CERVtrial_MUCUS |
CyclingPedalingCadence |
android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE |
מרחק |
android.permission.health.READ_DISTANCE
android.permission.health.WRITE_DISTANCE |
הגובה |
android.permission.health.READ_ELEVATION_GAINED
android.permission.health.WRITE_ELEVATION_GAINED |
סשן פעילות |
android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE |
טיפסת קומות |
android.permission.health.READ_FLOORS_CLIMBED
android.permission.health.WRITE_FLOORS_CLIMBED |
קצב הלב |
android.permission.health.READ_HEART_RATE
android.permission.health.WRITE_HEART_RATE |
HeartRateVariabilityRmssd |
android.permission.health.READ_HEART_RATE_VARIABILITY
android.permission.health.WRITE_HEART_RATE_VARIABILITY |
גובה |
android.permission.health.READ_HEIGHT
android.permission.health.WRITE_HEIGHT |
התייבשות |
android.permission.health.READ_HYDRATION
android.permission.health.WRITE_HYDRATION |
דימום בין-וסתי |
android.permission.health.READ_INTERMENSTRUAL_BLEEDING
android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
LeanBodyMass |
android.permission.health.READ_LEAN_BODY_MASS
android.permission.health.WRITE_LEAN_BODY_MASS |
MenstruationFlow |
android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION |
תקופת מחזור |
android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION |
תזונה |
android.permission.health.READ_NUTRITION
android.permission.health.WRITE_NUTRITION |
בדיקת ביוץ |
android.permission.health.READ_OVULATION_TEST
android.permission.health.WRITE_OVULATION_TEST |
ריווי חמצן |
android.permission.health.READ_OXYGEN_SATURATION
android.permission.health.WRITE_OXYGEN_SATURATION |
הפעלה |
android.permission.health.READ_POWER
android.permission.health.WRITE_POWER |
שיעור נשימה |
android.permission.health.READ_RESPIRATORY_RATE
android.permission.health.WRITE_RESPIRATORY_RATE |
RestingHeartRate |
android.permission.health.READ_RESTING_HEART_RATE
android.permission.health.WRITE_RESTING_HEART_RATE |
פעילות מינית |
android.permission.health.READ_SEXUAL_ACTIVITY
android.permission.health.WRITE_SEXUAL_ACTIVITY |
שינה |
android.permission.health.READ_SLEEP
android.permission.health.WRITE_SLEEP |
מהירות |
android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED |
StepsCadence |
android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS |
שלבים |
android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS |
TotalCaloriesBurned |
android.permission.health.READ_TOTAL_CALORIES_BURNED
android.permission.health.WRITE_TOTAL_CALORIES_BURNED |
Vo2Max |
android.permission.health.READ_VO2_MAX
android.permission.health.WRITE_VO2_MAX |
משקל |
android.permission.health.READ_WEIGHT
android.permission.health.WRITE_WEIGHT |
דחיפת גלגלים |
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 |
טמפרטורת גוף קבועה |
androidx.health.permission.BasalBodyTemperature.READ
androidx.health.permission.BasalBodyTemperature.WRITE |
BasalMetabolicRate |
androidx.health.permission.BasalMetabolicRate.READ
androidx.health.permission.BasalMetabolicRate.WRITE |
BloodGlucose |
androidx.health.permission.BloodGlucose.READ
androidx.health.permission.BloodGlucose.WRITE |
לחץ דם |
androidx.health.permission.BloodClickure.READ
androidx.health.permission.BloodClickure.WRITE |
BodyFat |
androidx.health.permission.BodyFat.READ
androidx.health.permission.BodyFat.WRITE |
טמפרטורת הגוף |
androidx.health.permission.BodyTemperature.READ
androidx.health.permission.BodyTemperature.WRITE |
BodyWaterMass |
androidx.health.permission.BodyWaterMass.READ
androidx.health.permission.BodyWaterMass.WRITE |
BoneMass |
androidx.health.permission.BoneMass.READ
androidx.health.permission.BoneMass.WRITE |
CervicalMucus |
androidx.health.permission.CervicalMucus.READ
androidx.health.permission.CervicalMucus.WRITE |
CyclingPedalingCadence |
androidx.health.permission.CyclingPedalingCadence.READ
androidx.health.permission.CyclingPedalingCadence.WRITE |
מרחק |
androidx.health.permission.מרחק.READ
androidx.health.permission.where.WRITE |
הגובה |
androidx.health.permission.תוספים נצברים.READ
androidx.health.permission.Overlifted.WRITE |
סשן פעילות |
androidx.health.permission.ExerciseSession.READ
androidx.health.permission.ExerciseSession.WRITE |
טיפסת קומות |
androidx.health.permission.FloorsClimbed.READ
androidx.health.permission.FloorsClimbed.WRITE |
קצב הלב |
androidx.health.permission.HeartRate.READ
androidx.health.permission.HeartRate.WRITE |
HeartRateVariabilityRmssd |
androidx.health.permission.HeartRateVariabilityRmssd.READ
androidx.health.permission.HeartRateVariabilityRmssd.WRITE |
גובה |
androidx.health.permission.Height.READ
androidx.health.permission.Height.WRITE |
התייבשות |
androidx.health.permission.Hydration.READ
androidx.health.permission.Hydration.WRITE |
דימום בין-וסתי |
androidx.health.permission.IntermenstrualBleeding.READ
androidx.health.permission.IntermenstrualBleeding.WRITE |
LeanBodyMass |
androidx.health.permission.LeanBodyMass.READ
androidx.health.permission.LeanBodyMass.WRITE |
MenstruationFlow |
androidx.health.permission.MenstruationFlow.READ
androidx.health.permission.MenstruationFlow.WRITE |
תזונה |
androidx.health.permission.Nutrition.READ
androidx.health.permission.Nutrition.WRITE |
בדיקת ביוץ |
androidx.health.permission.OvulationTest.READ
androidx.health.permission.OvulationTest.WRITE |
ריווי חמצן |
androidx.health.permission.OxygenSaturation.READ
androidx.health.permission.OxygenSaturation.WRITE |
הפעלה |
androidx.health.permission.Power.READ
androidx.health.permission.Power.WRITE |
שיעור נשימה |
androidx.health.permission.RespiratoryRate.READ
androidx.health.permission.RespiratoryRate.WRITE |
RestingHeartRate |
androidx.health.permission.RestingHeartRate.READ
androidx.health.permission.RestingHeartRate.WRITE |
פעילות מינית |
androidx.health.permission.BINActivity.READ
androidx.health.permission.VoiceActivity.WRITE |
שינה |
androidx.health.permission.SleepSession.READ
androidx.health.permission.SleepSession.WRITE |
מהירות |
androidx.health.permission.speed.READ
androidx.health.permission.speed.WRITE |
StepsCadence |
androidx.health.permission.StepsCadence.READ
androidx.health.permission.StepsCadence.WRITE |
שלבים |
androidx.health.permission.Steps.READ
androidx.health.permission.Steps.WRITE |
TotalCaloriesBurned |
androidx.health.permission.TotalCaloriesBurned.READ
androidx.health.permission.TotalCaloriesBurned.WRITE |
Vo2Max |
androidx.health.permission.Vo2Max.READ
androidx.health.permission.Vo2Max.WRITE |
משקל |
androidx.health.permission.weight.READ
androidx.health.permission.weight.WRITE |
דחיפת גלגלים |
androidx.health.permission.Wheel {1/}Pushes.READ
androidx.health.permission.WheelchairPushes.WRITE |
בדיקת ההרשאות וסוגי הנתונים
אחרי שסיימתם להגדיר את סוגי הנתונים וההרשאות שלכם, אתם יכולים להטמיע במהלך הפיתוח.
כשבודקים את האפליקציה לפני שמעלים אותה לחנות Play, חשוב לוודא את רשימת ההרשאות וסוגי הנתונים שנדרשים לאפליקציה שלכם. כך אפשר להצהיר בצורה מדויקת על השימוש בנתונים באפליקציה.
כשמתכוננים לפרסם את האפליקציה בחנות Play, להצהיר על גישה לסוגי הנתונים של Health Connect שהאפליקציה שלכם מספקת לשימושים אחרים. אחרת, יכול להיות שתוצג למשתמשים הודעת שגיאה במיקום של האפליקציה לא יכולים לגשת לסוגי הנתונים של Health Connect כי הם מחייבים אישור.