2026-03-13
Home APIs Public Beta release 1.7.1הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services:
- גרסאות מינימום של קושחה של Google Hub:
- הפעלת Cast:
- Nest Wifi Pro: 3.78.518349
- כל שאר הרכזות שמבוססות על Cast: 3.78.516526
- Fuchsia: 29.20251023.103.2201
- Google TV Streamer, 4K: UTTK.260120.001
- הפעלת Cast:
- Android SDK: home.android.sdk_GHP_1_7_1
- אפליקציית Google Home: 1.7.1
androidx.coreספרייה: פועלת בכל גרסה- גרסת Matter: 1.4.1.0, עם תמיכה ניסיונית בגרסה 1.5.0.
תכונות חדשות
- Device API
- הסכמה לשימוש ב-Analytics במצלמה ובפעמון הדלת.
- מצלמה ופעמון דלת השעה האחרונה שבה התבצע חיבור.
- מצב החיבור של המצלמה ופעמון הדלת.
- תרמוסטט בקשות אטומיות.
שינויים חשובים אחרים
- Home APIs Android Sample App v1.7.1. פרטים נוספים זמינים בגרסת GitHub.
בעיות מוכרות שתוקנו
- ב-Nest Cam לשימוש פנימי וחיצוני (עם סוללה או עם חיבור קווי) וב-Nest Doorbell (סוללה, דור שני), האפשרות 'זמן הסוללה שנותר' לא מופיעה בהגדרות הסוללה.
- המערכת מתעלמת מההגדרה של משך הצלצול.
- נורת Philips BLE מופיעה באופן שגוי כ'אונליין' גם כשהמכשיר נמצא בפועל במצב אופליין.
בעיות מוכרות
- אי אפשר לשנות את יחידות הטמפרטורה (C/F) ב-Nest Learning Thermostat גרסה 4.
- יכולים להיות עיכובים ביציבות הרשת ובתגובתיות המכשיר.
- בגרסה לנייד של Google Home לדפדפן, הסמל העליון והכפתור "הקודם" מוסתרים על ידי כותרת. יכול להיות שהמשתמשים לא יוכלו לחזור אחורה או לראות רכיבים מרכזיים בממשק המשתמש.
- יכול להיות שה-Hub ייתקע במצב 'מתחבר...' אחרי OOBE במצב מאוחד.
- יכול להיות שהפעלת מכשיר Matter תיכשל.
- יכול להיות שמרכז של Android TV ידווח בטעות שמכשירי Matter לא מחוברים לאינטרנט.
- יכול להיות שגרסת התוכנה הנכונה לא תופיע בגרסה הנוכחית של תוכנת המצלמה.
- פס הזזה בממשק המשתמש של התרמוסטט מציג טמפרטורות שלא נמצאות בטווח.
- כשהאפשרות 'משך הצלצול' מוגדרת, המכשיר לא מצלצל למשך הזמן שצוין.
2026-02-13
אפליקציית הדוגמה ל-Android של Home APIs עודכנה לגרסה 1.7 של Home APIs.
הערות הגרסה המלאות זמינות בגרסת GitHub.
2026-02-09
השקת גרסת בטא ציבורית של Home APIs 1.7הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 26.02.34
- גרסאות מינימום של קושחה של Google Hub:
- הפעלת Cast:
- Nest WiFi Pro: 3.76.508025
- כל שאר הרכזות שמבוססות על Cast: 3.77.510748
- Fuchsia: 29.20251023.103.2100
- Google TV Streamer, 4K: UTTK.250729.004
- הפעלת Cast:
- Android SDK: home.android.sdk_GHP_1_7
- אפליקציית Google Home: 1.7
androidx.coreספרייה: פועלת בכל גרסה- גרסת Matter: 1.4.1.0, עם תמיכה ניסיונית בגרסה 1.5.0.
תכונות חדשות
- Automations API
- אוטומציות מקומיות: חלק מהאוטומציות יופעלו עכשיו באופן מקומי על סמך תנאים כמו קישוריות, סוגי מכשירים ומאפיינים.
- Device API
- הפעלה של חוויית הגדרה ראשונית (OOBE) של המצלמה באפליקציות.
- תכונות חדשות במצלמות ובפעמוני הדלת
פרטים נוספים זמינים במאמרים מדריך למצלמות למכשירי Android ומדריך לשימוש בפעמון לדלת במכשירי Android.
- הגדרות
- מצב המכשיר
- פרטי המכשיר
- שאילתת הרשאות מאפשרת לאפליקציה לקבוע לאילו סוגי מכשירים המשתמש העניק גישה.
שינויים חשובים אחרים
- הקוד
HomeException.unsupportedהוחלף בקודHomeException.unimplementedכדי להתאים לקודי שגיאה סטנדרטיים. - השתנה מחולל הקוד הארוז לתכונות מותאמות אישית בגרסה 1.7. מפתחים שיש להם מאפיינים בהתאמה אישית צריכים לקמפל מחדש את המאפיינים שלהם אחרי שהם משלבים את ערכת SDK 1.7.
בעיות מוכרות שתוקנו
- History API תמיד מחזיר
nextPageToken, וגורם ללולאה אינסופית. - השגיאה 'המשתמש ביטל את תהליך ההרשאה' מופיעה כשמנסים להיכנס לחשבון חדש.
בעיות מוכרות
- ב-Nest Cam לשימוש פנימי וחיצוני (עם סוללה או עם חיבור קווי) וב-Nest Doorbell (סוללה, דור שני), האפשרות 'זמן הסוללה שנותר' לא מופיעה בהגדרות הסוללה.
- המערכת מתעלמת מההגדרה של משך הצלצול.
- נורת Philips BLE מופיעה באופן שגוי כ'אונליין' גם כשהמכשיר נמצא בפועל במצב אופליין.
- פתרון עקיף: אל תסתמכו רק על סטטוס האונליין של סוג המכשיר לבית חכם (SHDT).
במקום זאת, אפשר להשתמש במפת שירות מצב מכשיר היעד (TDSS) למכשירים עם מקור
LOCAL_SYNC.
- פתרון עקיף: אל תסתמכו רק על סטטוס האונליין של סוג המכשיר לבית חכם (SHDT).
במקום זאת, אפשר להשתמש במפת שירות מצב מכשיר היעד (TDSS) למכשירים עם מקור
2025-12-22
Home APIs Public Beta release 1.6הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 25.47.30
- גרסאות מינימום של קושחה של Google Hub:
- הפעלת Cast:
- Nest Wifi Pro: 3.75.479819
- כל שאר הרכזות שמבוססות על Cast: 3.77.505721
- Fuchsia: 28.20250723.103.2100300
- Google TV Streamer, 4K: UTTK.250729.004
- הפעלת Cast:
- Android SDK: home.android.sdk_GHP_1_6
- אפליקציית Google Home: 1.6
androidx.coreספרייה: פועלת בכל גרסה- גרסת Matter: 1.4.1.0
תכונות חדשות
- Automation API
- תמיכה בתכונות שקשורות למזג האוויר
נוספה תמיכה בתכונת מזג האוויר בסימנים לתחילת פעולות אוטומטיות ובתנאים. אפשר לעיין במאמר בנושא סימן לתחילת פעולה על סמך מזג האוויר.
- תמיכה בתכונות שקשורות למזג האוויר
- Device API
- תמיכה ביכולות נוספות של מצלמות ופעמוני דלת:
- הגדרות חדשות:
- הפעלה או השבתה של ראיית לילה.
- הבהירות של נורית החיווי.
- אזור התצוגה של המצלמה.
- כיוון התמונה.
- הרגישות של יציאה ממצב שינה.
- משך אירוע מקסימלי.
- נשמע צלצול.
מידע נוסף זמין במדריך למכשירי מצלמה ל-Android.
- הגדרות חדשות:
- תמיכה ביכולות נוספות של מצלמות ופעמוני דלת:
- Connectivity
- כניסה לחשבון Google שמתבצעת דרך האפליקציה, שמאפשרת לאפליקציות לאתחל את
HomeClientעם פרטי חשבון Google כדי לייעל את תהליך חוויית המשתמש ולבטל את הצורך לבדוק מי המשתמש שמפעיל את האפליקציה. - מצב ללא רכזת
מעכשיו המשתמשים יכולים להוסיף ולשלוט במכשירי Matter מסוימים בלי רכזת עצמאית.
- כניסה לחשבון Google שמתבצעת דרך האפליקציה, שמאפשרת לאפליקציות לאתחל את
- Structure API
- Hub Activation API חדש, שמאפשר לאפליקציות לגלות ולהפעיל רכזות.
- Android Sample App
- הגדרות המצלמה ופעמון הדלת
- הפעלה או השבתה של המיקרופון.
- הפעלה או השבתה של הקלטת אודיו.
- אוטומציות מוגדרות מראש
- הוספנו תמיכה בסוגי המכשירים Fan (מאוורר) ו-Speaker (רמקול).
- הגדרות המצלמה ופעמון הדלת
- כניסה באמצעות חשבון Google שמתבצעת מתוך האפליקציה.
בעיות מוכרות
- ממשק השליטה במכשירים מפסיק לפעול אחרי תקופות שימוש ממושכות.
- פתרון עקיף: מפעילים מחדש את הרכזת.
- יכול להיות שהפעלת מכשיר Matter לא תצליח.
- השגיאה 'המשתמש ביטל את תהליך ההרשאה' מופיעה כשמנסים להוסיף חשבון חדש באפליקציה לדוגמה ל-Android.
- פתרון עקיף: מוסיפים חשבונות Google דרך הגדרות המכשיר של Android.
- מצלמת אבטחה קווית של Walmart onn שהופעלה באמצעות Android Home APIs SDK לא יכולה להפעיל שידור חי דרך אפליקציית Google Home.
2025-10-23
השקת גרסת בטא ציבורית של Home APIs 1.5.1הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 25.41.30
- גרסאות מינימום של קושחה של Google Hub:
- Cast: 3.76.495998
- Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_5_1
- אפליקציית Google Home: פועלת עם כל גרסה
androidx.coreספרייה: פועלת בכל גרסה- גרסת Matter: 1.4.1.0
תכונות חדשות
- Structure API
- Hub activation API מאפשר לגלות ולהפעיל רכזת Google Home באופן פרוגרמטי. מידע נוסף זמין במאמר בנושא Hub activation API on Android.
- Hub activation API מאפשר לגלות ולהפעיל רכזת Google Home באופן פרוגרמטי. מידע נוסף זמין במאמר בנושא Hub activation API on Android.
- Android Sample App
- תמיכה בסוג המכשיר 'פעמון לדלת' עבור:
- OnOff
- שידור חי
- שיחה באמצעות הרמקול של המצלמה
- Hub Activation API: Activate Hubs
- תמיכה בסוג המכשיר 'פעמון לדלת' עבור:
בעיות מוכרות שתוקנו
- אפליקציית הדוגמה לא מציגה נכון את סטטוס המכשיר בתצוגה Device.
2025-09-26
Home APIs Public Beta release 1.5.0בגרסה הזו הוספנו תמיכה במכשירי מצלמה, תיקנו באגים ושיפרנו את איכות הבטא של ה-SDK של Home APIs ל-Android.
גרסאות מינימליות
- Google Play Services: 25.37.31
- גרסאות מינימום של קושחה של Google Hub:
- Cast: 3.76.492738
- Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_5
- אפליקציית Google Home: פועלת עם כל גרסה
androidx.coreספרייה: פועלת בכל גרסה- גרסת Matter: 1.4.1.0
תכונות חדשות
- Automation API
- הפעולות, התנאים והסימנים לתחילת פעולה מקבלים עכשיו מבני נתונים של Matter כפרמטרים.
- Device API
- נוסף סוג מכשיר המצלמה. גם התכונות הבאות של המצלמה זמינות לסוג המכשיר Doorbell:
- שידור חי מהמצלמה.
- שיחה באמצעות הרמקול של המצלמה.
- התחלה והפסקה של הקלטת סרטון במצלמה.
- Android Sample App
- תמיכה בסוג המכשיר 'מצלמה':
- שידור חי מהמצלמה.
- שיחה באמצעות הרמקול של המצלמה.
- התחלה והפסקה של הקלטת סרטון במצלמה.
- הרשאות מוגבלות לסוגי מכשירים.
- הקצאת הרשאות לכמה אדמינים (שיתוף מכשיר שהוקצו לו הרשאות).
- אוטומציה
OnOffמוגדרת מראש.
- תמיכה בסוג המכשיר 'מצלמה':
בעיות מוכרות
- יכול להיות שזמן האחזור של השליטה במכשיר יתארך כשעוברים מ-Wi-Fi לרשת סלולרית.
- יכול להיות שהשליטה בסוגי מכשירים של מאווררים שמגובים על ידי Cloud-to-Cloud לא תפעל באפליקציית הדוגמה.
בעיות מוכרות שתוקנו
- כשמרכז הבקרה שפעיל כרגע מוסר בכוח, יש חלון של חמש דקות שבמהלכו אי אפשר לשלוט בחלק מהמכשירים. אחרי חמש דקות, היכולת לשלוט במכשירים חוזרת.
- אחרי שהמשתמש בוחר צבע מתוך הגדרות קבועות מראש או מתוך בוחר טמפרטורת הצבע, הצבע של Extended Color Light לא מתעדכן.
2025-09-08
השקנו את גרסה 1.4.1 של אפליקציית הדוגמה ל-Android.
תכונות חדשות
- יצירה, שינוי שם, עדכון ומחיקה של חדר.
- הוספה לרשת Matter של צד שלישי.
בעיות מוכרות שתוקנו
- הקישור לדף ביטול ההרשאות פועל עכשיו.
2025-08-29
השקה של גרסת בטא ציבורית של Home APIs 1.4.1הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 25.33.32
- גרסאות מינימום של קושחה של Google Hub:
- Cast: 3.76.495998
- Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_4_1
- אפליקציית Google Home: פועלת עם כל גרסה
androidx.coreספרייה: פועלת בכל גרסה- גרסת Matter: 1.4.0.0
תכונות חדשות
- Device API
- מוגדר
DecommissionIneligibleReasonחדש לניסיון להוציא משימוש מכשיר עם כמה מקורות. מכשירים עם כמה מקורות
- מוגדר
בעיות מוכרות
- כשמרכז הבקרה שפעיל כרגע מוסר בכוח, יש חלון של חמש דקות שבמהלכו אי אפשר לשלוט בחלק מהמכשירים. אחרי חמש דקות, היכולת לשלוט במכשירים חוזרת.
בעיות מוכרות שתוקנו
- אפליקציית הדוגמה ל-Android קורסת כשמשתמש מנסה להגדיר תרמוסטט למצב שהוא לא תומך בו.
2025-07-31
השקה של גרסת בטא ציבורית של Home APIs 1.4.0הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 25.28.34
- גרסאות מינימום של קושחה של Google Hub:
- Cast: 3.76.486931
- Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_4_0
- אפליקציית Google Home: פועלת עם כל גרסה
androidx.coreספרייה: פועלת בכל גרסה- גרסת Matter: 1.4.0.0
תכונות חדשות
- Automation API
- אפשר להגביל את מספר הפעמים שבהן אוטומציות יפעלו. איך מגבילים את מספר ההרצות
- Device API
- האפשרות להסיר מכשיר Matter באופן פרוגרמטי. כך מסירים מכשיר
- הוסרו חברים מקבוצת
HomeDeviceשהוצאו משימוש:HomeDevice.trait(). אפשר לעיין במאמר גישה למכשירים ולמטא-נתונים של מכשירים ב-Android.HomeDevice.isInRoom. במקום זאת, צריך להשתמש ב-HomeDevice.roomId.HomeDevice.isInStructure. במקום זאת, צריך להשתמש ב-HomeDevice.structureId.
- Structure API
-
Home.hasPermissions()כולל עכשיו גם את מצב ההרשאה של OAuth עבור המשתמש (גישה למבנה) וגם את ההרשאות שניתנו לאפליקציה.
-
- Android Sample App
- החלפנו קריאות ל-API שהוצאו משימוש.
- משנים את השם של מכשיר.
- מחיקת מכשירים שפועלים רק עם Matter.
בעיות מוכרות
- אחרי שיוצאים מהחשבון בטלפון ונכנסים אליו מחדש, אפליקציה של Home APIs לא יכולה לשלוט במכשירים.
- פתרון עקיף: סוגרים את האפליקציה או מעבירים אותה לרקע, ואז מחכים לפחות 10 שניות לפני שמנסים שוב.
בעיות מוכרות שתוקנו
- מכשירי שואב אבק שעוגנו לא נרשמים במצב עגינה.
2025-07-08
עם גרסת הקושחה Cast 3.76.479819, Nest Wifi Pro יכול עכשיו לפעול כרכזת של ממשקי API של Home.
2025-06-26
Home APIs Public Beta release 1.3.2הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- 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
- פוקסיה: 26.20250116.103.2900
- הפעלת Cast:
- Android SDK: home.android.sdk_1_3_2
- אפליקציית Google Home: פועלת עם כל גרסה
androidx.coreספרייה: פועלת בכל גרסה- גרסת 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)
החל מהגרסה הזו, המפתחים צריכים לכלול את שני הארטיפקטים בנתיבי הספריות של הפרויקט בזמן ההידור ובזמן הריצה.
- מסגרת ה-SDK של Home APIs (
אפליקציה לדוגמה ל-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הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 25.19.32
- גרסאות מינימום של קושחה של Google Hub:
- Cast: 3.75.468222
- פוקסיה: 26.20250116.103.2201
- Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
- אפליקציית Google Home: פועלת עם כל גרסה
androidx.coreספרייה: פועלת בכל גרסה- גרסת Matter: 1.4.0.0
תכונות חדשות
תכונות
- הוספנו את המאפיין
SyntheticSwitchשמפשט את הטיפול באירועים שנוצרים על ידי מכשירי Matter Switch ומאפשר למתגים להפעיל התחלות אוטומציה. - בתכונה
ExtendedDoorLockבוצע שינוי שעלול לגרום לבעיות: סוג הנתונים בשדהuser_idהשתנה מ-Stringל-Long. אפשר להיעזר בצריך לקמפל מחדש אפליקציות שמשתמשות בתכונה הזו.
אפליקציה לדוגמה ל-Android
הוספנו פונקציות לרישום מצב המבנים, המכשירים, הסוגים, המאפיינים והאוטומציות כדי להקל על ניפוי הבאגים.
בעיות מוכרות
באפליקציית הדוגמה ל-Android, לפעמים צריך להקיש כמה פעמים על הלחצן Create automation כדי להפעיל אותו.
בעיות מוכרות שתוקנו
- אפליקציית Google Home קורסת עם
FailedPreconditionExceptionכשיוצרים פעולות אוטומטיות אם מיקום הבית לא מוגדר באפליקציית Google Home (GHA) (במאמר שינוי כתובת המגורים ב-Google מוסבר איך להגדיר את מיקום הבית). - באפליקציית הדוגמה ל-Android, מכשיר עם
connectivityStatePARTIALLY_ONLINEהוצג למשתמש בעבר כאופליין. הסטטוס הזה מיוצג עכשיו כמחובר.
2025-05-12
גרסת בטא ציבורית 1.3 של Home APIsהגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 25.16.33
- גרסאות מינימום של קושחה של Google Hub:
- Cast: 3.75.468222
- פוקסיה: 26.20250116.103.2201
- Android SDK: home.android.sdk_202504_EAP_1_3_RC00
- אפליקציית Google Home: פועלת עם כל גרסה
androidx.coreספרייה: פועלת בכל גרסה- גרסת Matter: 1.4.0.0
תכונות חדשות
- Automation API
- הוספנו תמיכה ב
הפעלת אירועים מתוזמנים חוזרים, שמאפשרת למפתחים ליצור אוטומציות שפועלות באופן תקופתי על סמך שעת שעון, שעת שמש ותנאים מבוססי-יומן, באמצעות ביטויי
cron.
- הוספנו תמיכה ב
הפעלת אירועים מתוזמנים חוזרים, שמאפשרת למפתחים ליצור אוטומציות שפועלות באופן תקופתי על סמך שעת שעון, שעת שמש ותנאים מבוססי-יומן, באמצעות ביטויי
- Device API
- הוספנו את האפשרות לשנות את השם של מכשירים. מידע נוסף מופיע במאמר בנושא שינוי השם של מכשיר.
- Structure API
- הוספנו את האפשרות לשנות את השם של החדרים. איך משנים את השם של חדר
בעיות מוכרות
אפליקציית Google Home קורסת עם הודעת השגיאה FailedPreconditionException כשיוצרים פעולות אוטומטיות אם לא מוגדר מיקום הבית באפליקציית Google Home (GHA) (במאמר שינוי כתובת המגורים ב-Google Home מוסבר איך לעשות את זה).
- פתרון עקיף: לפני שמנסים ליצור אוטומציות, בודקים אם כתובת הבית מופיעה באמצעות Discovery API.
בעיות מוכרות שתוקנו
- יכול להיות שזמן האחזור של השליטה במכשיר יתארך כשעוברים מ-Wi-Fi לרשת סלולרית.
- אחרי איפוס של הרכזת להגדרות המקוריות, יכול להיות שהמכשירים יופיעו במצב אופליין.
2025-04-09
Home APIs Public Beta release 1.2.1הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- 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.corelibrary: 1.10.0 - גרסת Matter: 1.4.0.0
תכונות חדשות
- שיפור הביצועים בטעינת אובייקטים מתרשים הבית.
- Automation API
- נוספה תמיכה ב מסנני ישויות, שמאפשרים לפעולות אוטומטיות לבחור מכשירים באופן דינמי על סמך קריטריונים שצוינו בפעולה האוטומטית.
- Device API
- מידע על מכשירים בענן זמין עכשיו ב-
BasicInformationTrait.
- מידע על מכשירים בענן זמין עכשיו ב-
בעיות מוכרות
- יכול להיות שזמן האחזור של השליטה במכשיר יתארך כשעוברים מ-Wi-Fi לרשת סלולרית.
- אחרי איפוס של הרכזת להגדרות המקוריות, יכול להיות שהמכשירים יופיעו במצב אופליין.
בעיות מוכרות שתוקנו
- אם קוראים ל-Discovery API לפני האתחול או לפני שהאתחול מסתיים, מוצג
HomeExceptionעםcode 14: UNKNOWNוההודעה 'לא נמצא נתיב'. - בסביבה שמכילה כמה מבנים וכמה משתמשים, יכול להיות שמעבר בין מבנים ומשתמשים לא יחזיר מכשירים.
2025-03-14
גרסת בטא ציבורית של Home APIs 1.2.0הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- גרסה מינימלית של 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.corelibrary 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 על ישות, כדאי לבדוק אם היא אונליין.
- בסביבה שמכילה כמה מבנים וכמה משתמשים, יכול להיות שמעבר בין מבנים ומשתמשים לא יחזיר מכשירים.
בעיות מוכרות שתוקנו
- בפעם הראשונה שאפליקציה עם Home APIs קוראת ל-
HomeManager.structures()אחרי ההפעלה, היא מקבלת אפס מבנים, גם אם יש מבנה אחד או יותר. כך נוצר הרושם השגוי שאין מבנים שמשויכים לחשבון Google. - יכול להיות שמשתמשים יחוו זמני המתנה ארוכים בזמן טעינה, יצירה ועריכה של אוטומציות.
- משתמשים שמתחילים את תהליך ההגדרה מאפליקציית המצלמה צריכים לסרוק את קוד ה-QR פעמיים כדי להשלים את ההפעלה של Matter.
- במבנה שמכיל יותר מ-200 מכשירים, יכול להיות ש-Discovery API פשוט לא יחזיר מועמדים.
2025-01-29
השקת גרסת בטא ציבורית של Home APIs 1.1.0הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- גרסה מינימלית של 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.corelibrary min version: 1.10.0 - גרסת Matter:
1.3.0.0
- הערה: אין תמיכה בסוגים ובאוספים זמניים של מכשירי תקן Matter.
תכונות חדשות
- Streaming API:
- מספק מקורות נתונים של אירועים ששולחים התראות על מבנים, חדרים ומכשירים שנוספו, שונו והוסרו.
- אפשר לעיין במאמר בנושא הרשמה לאירועים של קשר בין ישויות.
- Batching API (ניסיוני):
- מאפשר למפתח לשלוח כמה פקודות באצוות שמופעלות בו-זמנית.
- איך שולחים כמה פקודות בבת אחת
בעיות מוכרות
- יכול להיות שמשתמשים יחוו זמני המתנה ארוכים בזמן טעינה, יצירה ועריכה של אוטומציות.
- משתמשים שמתחילים את תהליך ההגדרה מאפליקציית המצלמה צריכים לסרוק את קוד ה-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 APIבמהלך הבטא הציבורית למפתחים, כל המפתחים יכולים להתחיל לפתח ולבדוק את האפליקציות שלהם.
הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של 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.corelibrary 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 להיות אופליין.
- אחרי שמבצעים איפוס לנתוני היצרן של רכז, יכול להיות שהפקודות למכשירים חדשים שהוגדרו לא יפעלו, למרות שהמכשיר מדווח כמחובר לאינטרנט.