נתוני גרסה של Home APIs Android SDK

2025-09-08

השקנו את אפליקציית הדוגמה ל-Android בגרסה 1.4.1.

תכונות חדשות

  • יצירה, שינוי שם, עדכון ומחיקה של חדר.
  • הוספה לרשת Matter של צד שלישי.

בעיות מוכרות שתוקנו

  • הקישור לדף ביטול ההרשאות פועל עכשיו.

2025-08-29

  השקה של גרסת בטא ציבורית של Home APIs‏ 1.4.1  

הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של ערכת ה-SDK של Home APIs ל-Android.

גרסאות מינימליות

  • ‫Google Play Services: ‏ 25.33.32
  • גרסאות מינימום של קושחה של Google Hub:
    • Cast: 3.76.495998
    • פוקסיה: 27.20250422.103.3600
  • ‫Android SDK: home.android.sdk_1_4_1
  • אפליקציית Google Home: פועלת עם כל גרסה
  • ‫androidx.core library: פועל בכל גרסה
  • גרסת Matter: 1.4.0.0

תכונות חדשות

בעיות מוכרות

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

בעיות מוכרות שתוקנו

  • אפליקציית הדוגמה ל-Android קורסת כשמשתמש מנסה להגדיר תרמוסטט למצב שהוא לא תומך בו.

2025-07-31

  השקה של גרסת בטא ציבורית של Home APIs‏ 1.4.0  

הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של ערכת ה-SDK של Home APIs ל-Android.

גרסאות מינימליות

  • ‫Google Play Services: ‏ 25.28.34
  • גרסאות מינימום של קושחה של Google Hub:
    • Cast: 3.76.486931
    • פוקסיה: 27.20250422.103.3600
  • ‫Android SDK: home.android.sdk_1_4_0
  • אפליקציית Google Home: פועלת עם כל גרסה
  • ‫androidx.core library: פועל בכל גרסה
  • גרסת Matter: 1.4.0.0

תכונות חדשות

בעיות מוכרות

  • אחרי שיוצאים מהחשבון בטלפון ונכנסים אליו מחדש, אפליקציה עם ממשקי API של Home לא יכולה לשלוט במכשירים.
    • פתרון עקיף: סוגרים את האפליקציה או מעבירים אותה לרקע, ואז מחכים לפחות 10 שניות לפני שמנסים שוב.

בעיות מוכרות שתוקנו

  • מכשירי שאיבה שעוגנו לא נרשמים במצב עגינה.

2025-07-08

עם גרסת הקושחה Cast 3.76.479819, ‏ Nest Wifi Pro יכול עכשיו לפעול כרכזת של ממשקי API של Home.

2025-06-26

  Home APIs Public Beta release 1.3.2  

הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של ערכת ה-SDK של Home APIs ל-Android.

גרסאות מינימליות

  • ‫Google Play Services: ‏ 25.23.31
  • גרסאות מינימום של קושחה של Google Hub:
    • הפעלת Cast:
      • ‫Google Home,‏ Google Home Mini ו-Google Nest Mini: ‏ 3.75.468362
      • ‫Google Nest Audio: ‏ 3.75.476451
    • ‫Fuchsia: ‏ 26.20250116.103.2900
  • ‫Android SDK: home.android.sdk_1_3_2
  • אפליקציית Google Home: פועלת עם כל גרסה
  • ‫androidx.core library: פועל בכל גרסה
  • גרסת Matter: 1.4.0.0

תכונות חדשות

  • ארטיפקט ה-SDK חולק לשני ארטיפקטים נפרדים:
    • מסגרת ה-SDK של Home APIs‏ (play-services-home-17.0.0.aar)
    • מאפייני SDK וסוגי מכשירים (play-services-home-types-17.0.0.aar)

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

אפליקציה לדוגמה ל-Android

  • המשתמשים יכולים להתנתק מהאפליקציה ולבטל את ההרשאות שלה.
  • עדכנו את ארטיפקטים של SDK כך שיכללו את play-services-home-17.0.0 ואת play-services-home-types-17.0.0.

בעיות מוכרות

  • מכשירי שאיבה שעוגנו לא נרשמים במצב עגינה.

2025-06-05

  Home APIs Public Beta release 1.3.1  

הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של ערכת ה-SDK של Home APIs ל-Android.

גרסאות מינימליות

  • ‫Google Play Services: ‏ 25.19.32
  • גרסאות מינימום של קושחה של Google Hub:
    • ‫Cast‏: 3.75.468222
    • ‫Fuchsia: 26.20250116.103.2201
  • ‫Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
  • אפליקציית Google Home: פועלת עם כל גרסה
  • ‫androidx.core library: פועל בכל גרסה
  • גרסת Matter: 1.4.0.0

תכונות חדשות

תכונות

אפליקציה לדוגמה ל-Android

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

בעיות מוכרות

באפליקציית הדוגמה ל-Android, לפעמים צריך להקיש כמה פעמים על הלחצן Create automation כדי להפעיל אותו.

בעיות מוכרות שתוקנו

  • אפליקציית Google Home קורסת עם FailedPreconditionException כשיוצרים פעולות אוטומטיות אם לא מוגדר מיקום הבית באפליקציית Google Home‏ (GHA) (במאמר שינוי הכתובת של הבית ב-Google מוסבר איך להגדיר את מיקום הבית).
  • באפליקציית הדוגמה ל-Android, מכשיר עם connectivityState PARTIALLY_ONLINE הוצג למשתמש קודם כמצב לא מקוון. הסטטוס הזה מיוצג עכשיו כמחובר.

2025-05-12

  גרסת בטא ציבורית 1.3 של Home APIs  

הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של ערכת ה-SDK של Home APIs ל-Android.

גרסאות מינימליות

  • ‫Google Play Services: ‏ 25.16.33
  • גרסאות מינימום של קושחה של Google Hub:
    • ‫Cast‏: 3.75.468222
    • ‫Fuchsia: 26.20250116.103.2201
  • ‫Android SDK: home.android.sdk_202504_EAP_1_3_RC00
  • אפליקציית Google Home: פועלת עם כל גרסה
  • ‫androidx.core library: פועל בכל גרסה
  • גרסת Matter: 1.4.0.0

תכונות חדשות

בעיות מוכרות

אפליקציית Google Home קורסת עם FailedPreconditionException כשיוצרים פעולות אוטומטיות אם מיקום הבית לא מוגדר באפליקציית Google Home‏ (GHA) (כאן מוסבר איך לשנות את כתובת הבית ב-Google).

  • פתרון עקיף: לפני שמנסים ליצור אוטומציות, בודקים באמצעות Discovery API שכתובת הבית מופיעה.

בעיות מוכרות שתוקנו

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

2025-04-09

  Home APIs Public Beta release 1.2.1  

הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של ערכת ה-SDK של Home APIs ל-Android.

גרסאות מינימליות

  • ‫Google Play Services: ‏ 25.09.33
  • גרסאות מינימום של קושחה של Google Hub:
    • ‫Cast‏: 3.75.468222
    • ‫Fuchsia: ‏ 24.20241009.103.19006011
  • ‫Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
  • אפליקציית Google Home: פועלת עם כל גרסה
  • ‫androidx.core library: 1.10.0
  • גרסת Matter: 1.4.0.0
1. הגרסה הזו נמצאת כרגע בתהליך השקה בייצור, והיא תהיה זמינה בכל המכשירים עד 22 באפריל 2025.

תכונות חדשות

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

בעיות מוכרות

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

בעיות מוכרות שתוקנו

  • אם מתבצעת קריאה ל-Discovery API לפני האתחול או לפני שהאתחול מסתיים, מוצגת שגיאת HomeException עם code 14: UNKNOWN וההודעה 'לא נמצא נתיב'.
  • בסביבה שמכילה כמה מבנים וכמה משתמשים, יכול להיות שלא יוחזרו מכשירים אם תעברו בין מבנים ומשתמשים.

2025-03-14

  Home APIs Public Beta release 1.2.0  

הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של ערכת ה-SDK של Home APIs ל-Android.

גרסאות מינימליות

  • גרסה מינימלית של Google Play Services: ‏ 25.06.32
  • גרסאות קושחה מינימליות של Google Hub:
    • גרסת Cast: ‏ 3.75.456944
    • גרסה מינימלית של Fuchsia: ‏ 24.20241009.103.1900601
  • ‫Android SDK: home.android.sdk_1_2_0_RC06
  • הגרסה המינימלית של אפליקציית Google Home: פועלת עם כל גרסה
  • ‫androidx.core library min version: 1.10.0
  • גרסת Matter: 1.3.0.0
    • הערה: אין תמיכה בסוגים ובאשכולות זמניים של מכשירי Matter.

תכונות חדשות

  • Automation API:
    • תמיכה בטווח תאריכים ובתאריכים חלקיים בתנאים של אוטומציה. איך משתמשים בתאריכים עם between
    • בגרסאות קודמות, ה-API של Discovery החזיר NumberSetConstraint עבור חלק מהשדות של מפת הסיביות, במקום BitmapConstraint. השדות האלה מחזירים עכשיו BitmapConstraint כצפוי. הפקודות האלה מוגבלות למפות סיביות (bitmap) של optionsMask ו-optionsOverride בתכונת LevelControl.

בעיות מוכרות

  • יכול להיות שזמן האחזור של השליטה במכשיר יתארך כשעוברים מ-Wi-Fi לרשת סלולרית.
  • אחרי איפוס של הרכזת להגדרות המקוריות, יכול להיות שהמכשירים יופיעו במצב אופליין.
  • אם מתבצעת קריאה ל-Discovery API לפני האתחול או לפני שהאתחול מסתיים, מוצגת שגיאת HomeException עם code 14: UNKNOWN וההודעה 'לא נמצא נתיב'.
    • פתרון עקיף: קוראים ל-Discovery API רק כשבאמת צריך מועמדים לאוטומציה. לא לבצע שליפה מראש של ישויות מועמדות ולשמור אותן במטמון. לפני שמפעילים שיטות של Discovery API על ישות, כדאי לבדוק אם היא אונליין.
  • בסביבה שמכילה כמה מבנים וכמה משתמשים, יכול להיות שלא יוחזרו מכשירים אם תעברו בין מבנים ומשתמשים.

בעיות מוכרות שתוקנו

  • בפעם הראשונה שאפליקציה עם ממשקי API של Home קוראת ל- HomeManager.structures() אחרי ההפעלה שלה, היא מקבלת אפס מבנים, גם אם יש מבנה אחד או יותר. זה יוצר את הרושם השגוי שאין מבנים שמשויכים לחשבון Google.
  • יכול להיות שמשתמשים יחוו זמני המתנה ארוכים בזמן טעינה, יצירה ועריכה של אוטומציות.
  • משתמשים שמתחילים את תהליך ההגדרה מאפליקציית המצלמה צריכים לסרוק את קוד ה-QR פעמיים כדי להשלים את ההפעלה של Matter.
  • במבנה שמכיל יותר מ-200 מכשירים, יכול להיות ש-Discovery API פשוט לא יחזיר מועמדים.

2025-01-29

  השקת גרסת בטא ציבורית של Home APIs‏ 1.1.0  

הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של ערכת ה-SDK של Home APIs ל-Android.

גרסאות מינימליות

  • גרסה מינימלית של Google Play Services: ‏ 25.02.32
  • גרסאות קושחה מינימליות של Google Hub:
    • גרסת Cast: ‏ 3.75.456944
    • גרסה מינימלית של Fuchsia: ‏ 24.20241009.103.1900500
  • ‫Android SDK: home.android.sdk_202412_EAP_1_1_RC04
  • הגרסה המינימלית של אפליקציית Google Home: פועלת עם כל גרסה
  • ‫androidx.core library min version: 1.10.0
  • גרסת Matter: 1.3.0.0
    • הערה: אין תמיכה בסוגים ובאשכולות זמניים של מכשירי Matter.

תכונות חדשות

בעיות מוכרות

  • יכול להיות שמשתמשים יחוו זמני המתנה ארוכים בזמן טעינה, יצירה ועריכה של אוטומציות.
  • משתמשים שמתחילים את תהליך ההגדרה מאפליקציית המצלמה צריכים לסרוק את קוד ה-QR פעמיים כדי להשלים את ההפעלה של Matter.
  • במבנה שמכיל יותר מ-200 מכשירים, יכול להיות ש-Discovery API פשוט לא יחזיר מועמדים.

בעיות מוכרות שתוקנו

  • יכול להיות שהחלפת החשבון שלכם ב-Google שאליו אתם מחוברים תיכשל ותגרום לשגיאה.
  • יכול להיות שמכשירי Google TV לא יפעלו באוטומציות שמשתמשות בתכונה MediaPlayback.
  • במבנה שמכיל רק רכזת Google:
    • יכול להיות שמכשירי Matter יופיעו במצב אופליין באפליקציית Google Home.
    • ‫Google Assistant לא יכולה לשלוט במכשירי Matter.
    • מסכים חכמים לא יכולים לשלוט במכשירי Matter או להציג את המצב של מכשיר Matter כלשהו.
  • במכשירים מסוימים, יכול להיות שהאפליקציה לא תציג תמיד את המצב המדויק, ויכול להיות שהאפליקציה תדווח על מצב ששונה מהמצב שמדווח על ידי אפליקציה של Google, כמו אפליקציית Google Home. בדרך כלל זה קורה בגלל שמכשירים לא מדווחים על המצב ל-Google.
    • פתרון עקיף: בדיקת המצב באמצעות אפליקציית Google פותרת את אי ההתאמה.

2025-01-14

הנחיות מעודכנות לאתחול של ממשקי API של Home.

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

2025-01-07

  השקת גרסת בטא ציבורית של Home APIs  

במהלך הבטא הפתוחה למפתחים, כל המפתחים יכולים להתחיל לפתח ולבדוק את האפליקציות שלהם.

הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK, כולל תמיכה משופרת במכשירי Google Nest Audio ו-Google TV.

גרסאות מינימליות

  • גרסה מינימלית של Google Play Services: ‏ 24.45.34
  • גרסאות קושחה מינימליות של Google Hub:
    • גרסת Cast: 3.74.444798
    • גרסה מינימלית של Fuchsia: ‏ 22.20240805.103.161
  • ‫Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
  • גרסה מינימלית של אפליקציית Google Home‏ (GHA): פועלת עם כל גרסה
  • ‫androidx.core library min version: 1.10.0
  • גרסת Matter: 1.3.0.0
    • הערה: אין תמיכה בסוגים ובאשכולות של מכשירי Matter זמניים.

בעיות מוכרות

  • יכול להיות שהחלפת החשבון שלכם ב-Google שאליו אתם מחוברים תיכשל ותגרום לשגיאה.
    • פתרון עקיף: מריצים מחדש את תהליך ההרשאות או מפעילים מחדש את האפליקציה.
  • יכול להיות שמכשירי Google TV לא יפעלו עם אוטומציות שמשתמשות בתכונה MediaPlayback.
  • במבנה שמכיל רק רכזת Google:
    • יכול להיות שמכשירי Matter יופיעו במצב אופליין באפליקציית Google Home‏ (GHA).
    • ‫Google Assistant לא יכולה לשלוט במכשירי Matter.
    • אי אפשר לשלוט במכשירי Matter באמצעות מסכים חכמים, או להציג את המצב של מכשיר Matter כלשהו.
  • במכשירים מסוימים, יכול להיות שהאפליקציה לא תמיד תשקף מצב מדויק, והיא עשויה לדווח על מצב ששונה מזה שמדווח על ידי אפליקציית Google, כמו אפליקציית Google Home‏ (GHA). בדרך כלל הסיבה לכך היא שמכשירים לא מדווחים על המצב שלהם ל-Google.
    • פתרון עקיף: בדיקת המצב באמצעות אפליקציית Google פותרת את אי ההתאמה.

בעיות מוכרות שתוקנו

  • יכול להיות שההפעלה תיכשל אם האפליקציה תמוזער במהלך התהליך.
    • פתרון עקיף: משתמשים ב- suppressHalfSheetNotification() API כדי להשבית התראות על דפי חצי כשמשתמשים ב-Commissioning API באפליקציה.
  • בעיה בצד השרת עלולה למנוע את הפעלת התכונה 'Ok Google' באוטומציות.
  • כשמשתמשים במרכז בקרה עם מערכת הפעלה Fuchsia שאין בו מכשירי Matter במבנה, אם מרכז הבקרה לא פעיל במשך יותר מ-3 שעות, הפעלת מכשיר Matter הראשון גורמת למכשיר Matter להיות במצב אופליין.
  • אחרי שמבצעים איפוס לנתוני היצרן של רכז, יכול להיות שהפקודות למכשירים חדשים שהוגדרו לא יפעלו, למרות שהמכשיר מדווח כמחובר לאינטרנט.