ביקורים

פעילויות באתר מאפשרות למשתמשים לראות במהירות ובקלות רשימה של כל בפעילויות שהם ביצעו. הן מופיעות בדף היומן של אפליקציית 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 מציג את פרק הזמן בחנות הכושר שבמהלכו האפליקציות A, B ו-C נוספו מערכי נתונים וסשנים מסוימים:

  • אפליקציה א' הוסיפה את מערכי הנתונים 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 במקום זאת. אפשר להשתמש מידע באפליקציה שלך כדי להראות למשתמשים אילו אפליקציות אחרות הכניסו נתוני כושר סשנים. אפשר להציג את הסמל של כל אחת מהאפליקציות האלה כדי לעזור למשתמשים לזהות אותם.

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