ביקורים

פעילויות באתר מאפשרות למשתמשים לראות במהירות ובקלות רשימה של כל בפעילויות שהם ביצעו. הן מופיעות בדף היומן של אפליקציית Google Fit. עבור לדוגמה, פעילות נשימה, הליכה, ריצה או שנת לילה, דוגמאות לסשן.

מערכי נתונים קבוצתיים של סשנים מתקופה ספציפית שנאספו במהלך פעילות. לדוגמה, אם משתמש עקב אחר כך מתי הוא התחיל וסיים 3 ק"מ לרוץ, ניתן ליצור פעילות באתר ואת כל נתוני הכושר Google (למשל צעדים, מהירות, מרחק) תשויך לסשן הזה.

הסשנים עצמם לא מכילים פרטים על הפעילות. בתוך של הכיתובים. לסשנים יש מאפיינים אלה:

  • שם תיאורי וקליט (לדוגמה, 'ריצה בוקר')
  • תיאור
  • מזהה ייחודי
  • סוג הפעילות שמתועדת (למשל, ריצה)

היתרונות של שימוש בסשנים

  • מועיל למשתמשים: סשנים עוזרים לארגן את נתוני הפעילות ואימוני הכושר בדרך משמעותית למשתמשים. הם יכולים לראות את כל הפעילויות שלהם באותו יום בדף היומן באפליקציית Google Fit.
  • חוויית משתמש עקבית: אם האפליקציה או המכשיר הנלווה מאפשרים פעילות. מעקב (שבו משתמשים יכולים להתחיל ולהפסיק פעילות), קיום סשנים במשך אימוני הכושר האלה מאפשרים למשתמשים לראות את הפעילות שלהם בשתי האפליקציות.
  • נתונים מלאים יותר: אפליקציית Google Fit גם משלבת נתונים ממספר מקורות כדי להשלים את פרטי הסשן ולהעשיר אותם. כך המשתמשים מקבלים תמונה מלאה יותר של הפעילות שלהם.
  • ממנפים את פלטפורמת Google Fit: אם המשתמשים לא עוקבים אחרי הפעילות שלהם או שהאפליקציה שלכם לא תומכת במעקב, עדיין תוכלו לקרוא את הסשנים ב-Google Fit. אפשר להריץ שאילתה על נתונים מפורטים או נצברים בחנות הכושר ללא צורך להטמיע סכימה משלכם אחסון.
  • הגברת המעורבות של משתמשים: אתם יכולים להציג למשתמשים סשנים זמינים האפליקציות שיצרו אותם. אינטראקציה עם אפליקציות כושר אחרות בדרך הזו עשויה להגביר את המעורבות של המשתמשים.

קבלת הרשאת משתמשים לסשנים

אם ברצונך לקרוא או לכתוב סשנים, האפליקציה שלך חייבת לקבל את הפרטים הרשאה. הגישה לסשנים מתבססת על אותם היקפי הרשאה כמו סוגי הנתונים, שצריך לבקש באופן הבא:

Android

מציינים את סוג הסשן שאליו האפליקציה צריכה גישה, באמצעות השיטות המתאימות מ-FitnessOptions. לדוגמה, כדי לקרוא סשנים שקשורים לריצה, אפשר לבחור באפשרויות הבאות:

    val fitnessOptions = FitnessOptions.builder()
        .accessActivitySessions(FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_HEART_RATE_BPM, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_SPEED, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_LOCATION_SAMPLE, FitnessOptions.ACCESS_READ)
        .build()

בדוגמה הזו מצוין שהאפליקציה שלכם רוצה לגשת למטא-נתונים של סשן הפעילות. והוא גם מציין את סוגי הנתונים שהוא רוצה לקרוא בסשנים האלה. ה בדוגמה הזו נעשה שימוש בסוגי נתוני דופק, מהירות ומיקום.

REST

היקפי הבקשות הם:

  • סשנים עם סוגים של פעילות שינה:
    • https://www.googleapis.com/auth/fitness.sleep.read
    • https://www.googleapis.com/auth/fitness.sleep.write
  • כל שאר הסשנים:
    • https://www.googleapis.com/auth/fitness.activity.read
    • https://www.googleapis.com/auth/fitness.activity.write

שימוש בסשנים

Android

אתם יכולים להשתמש ב-Sessions API כדי:

  • יצירת סשנים בזמן אמת
  • הוספת סשנים בחנות הכושר
  • הוספת קטעי פעילות כדי לתמוך בהשהיות במהלך אימוני כושר
  • קריאת סשנים ומערכי נתונים שמשויכים אליהם
  • אפשר להפעיל אפליקציה אחרת כדי להציג מידע על סשן שהיא יצרה
  • קבלת Intent כשאפליקציה אחרת מתחילה סשן

REST

אתם יכולים להשתמש ב-Sessions API כדי:

  • יצירת סשנים בזמן אמת
  • הוספת פעילויות בחנות הכושר
  • הוספת קטעי פעילות כדי לתמוך בהשהיות במהלך אימוני כושר
  • לקרוא סשנים ומערכי נתונים שמשויכים אליהם

איך מערך נתונים ופלחים מקיימים אינטראקציה עם סשנים

ב-Google Fit:

  • מערך נתונים מייצג קבוצה של נקודות נתונים ממקור נתונים מסוים במהלך תקופה ספציפית. אפשר להוסיף מערכי נתונים בעצמם. עם זאת, אם אתם יוצרים סשן, יכול להיות שיהיה קל יותר ליצור את הסשן ואת מערכי הנתונים שלו יחד.
  • פלח מקבץ את מערכי הנתונים בסשן לפי הפעילות המדויקת של המשתמש בסשן. לדוגמה, אם המשתמש עוקב אחר ריצה של 30 דקות ( אבל הלכתי עוד קצת זמן במשך הזמן הזה, יכול להיות שהוא התחלק פלחים. יהיה קטע של הריצה, ואז ההפסקה לצעידה, ואז הריצה שוב.
איור 1: אפליקציות שונות מוסיפות סשנים ומערכי נתונים ל'מאגר הכושר'.

באיור 1 מוצג מרווח זמן בחנות הכושר, שבמהלכו האפליקציות א', ב' ו-ג' הוסיפו כמה מערכי נתונים וסשנים:

  • אפליקציה א' הוסיפה את מערכי הנתונים A1 ו-A2 יחד עם סשן 1, ואת A3 בנפרד מכל סשן.
  • אפליקציה ב' הוסיפה את מערכי הנתונים B1 ו-B2 יחד עם סשן 2.
  • אפליקציה ג' הוסיפה את מערך הנתונים C1 בנפרד מסשנים כלשהם.

בקריאת נתוני סשנים מחנות הכושר, כל נתוני הכושר שמתאימים במהלך מרווח הזמן של סשן, משויך באופן אוטומטי גם אם הזנת את הנתונים לאחר יצירת הפעילות באתר, או אם יצרת סשן אחרי ביצוע מעקב פסיבי. לדוגמה, שאילתה בנושא כושר גופני נתונים מסשן 1 יחזירו:

  • מערך נתונים A1
  • מערך נתונים A2
  • החלק של מערך הנתונים A3 בין t1 ל-t2
  • החלק של מערך הנתונים C1 בין t1 ל-t2

אפשר לדעת איזו אפליקציה הוסיפה כל סשן וקבוצת נתונים.

יצירת סשנים

יש כמה דרכים ליצור סשנים:

  • האפליקציה שלך יכולה ליצור סשן באופן פעיל
    • בזמן אמת כשמשתמש עוקב באופן פעיל אחרי פעילות במכשיר (Android בלבד), או
    • על ידי הוספה ידנית.
  • כשמשתמש מוסיף אימון או פעילות באופן ידני לאפליקציית Google Fit.

מתי יוצרים סשן

האם בחרת להוסיף נתוני שינה?

  • כן – יוצרים סשן ומוסיפים אותו באופן ידני לחנות הפיזיולוגיה. לדוגמה, הוספת סשן שינה. הסיבה לכך היא שמשתמשים עם אפליקציות או מכשירים למעקב אחר שינה לא יתנהלו אינטראקציה עם המכשירים כדי להתחיל ולעצור את פעילות השינה שלהם (המעקב אחר הפעילות הזו מתבצע באופן פסיבי).
  • לא – האם האפליקציה מאפשרת למשתמשים להתחיל ולהפסיק פעילויות?

סשנים של קריאה

האפליקציה יכולה לקרוא סשנים במספר דרכים:

  • חיפוש סשן ספציפי שנוצר או הוטמע על ידו:
    • שם או
    • מזהה
  • אפשר לחפש את כל הסשנים שנוצרו או נוספו על ידי המערכת, לפי תקופת זמן
  • חיפוש של כל הסשנים הזמינים שנוצרו על ידי כל האפליקציות (כולל Google Fit) לפי תקופת זמן

אילו מקורות יצרו סשן

אתם יכולים להציג למשתמשים באיזו אפליקציה או באיזה מכשיר נוצר כל אחד מהסשנים שלהם. כל אחד המשויך לסשן כולל מקור נתונים, שכולל מידע על האפליקציה או המכשיר שאסף את הנתונים או שינה אותם.

Android

בשלב זה אפשר לקבל את שם החבילה של סשן שנכתב על ידי לקוח Android בלבד. כדי למצוא את שם החבילה של האפליקציה שיצרה סשן, משתמשים ב getAppPackageName. אפשר להשתמש במידע הזה באפליקציה כדי להציג משתמשים באפליקציות אחרות שהוסיפו סשנים של כושר. אתם יכולים להציג את הסמל של כל אחת מהאפליקציות האלה כדי לעזור למשתמשים לזהות אותן.

אפשר גם להפעיל intent מפעילים אפליקציות אחרות כדי להציג פרטים על הסשנים שנוצרו. גם אפליקציות אחרות יכולות להפעיל כוונה להפעיל את האפליקציה.

אפשר לקרוא מידע נוסף על מציאת המקור שיצר סשן.

REST

כדי למצוא את שם החבילה של האפליקציה ל-Android שיצרה סשנים, צריך להשתמש ב- session.application. עבור סשנים שנוצרו באמצעות ב-API ל-REST, צריך להשתמש בנכס session.name במקום זאת. אפשר להשתמש מידע באפליקציה שלך כדי להראות למשתמשים אילו אפליקציות אחרות הכניסו נתוני כושר סשנים. אתם יכולים להציג את הסמל של כל אחת מהאפליקציות האלה כדי לעזור למשתמשים לזהות אותן.

אפשר לקרוא מידע נוסף על מציאת המקור שיצר סשן.