2026-10-22
גרסה 1.11.1 של Home APIs זמינה לכלל המשתמשיםהגרסה הזו כוללת תיקוני באגים ושיפורים באיכות של GA ב-Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 26.40.32
- קושחה של Google Hub, Cast, Nest WiFi Pro: 3.78.556638
- קושחה של Google Hub, Cast, כל שאר הרכזות שמבוססות על Cast: 3.79.558061
- קושחה של Google Hub, Fuchsia: 31.20260429.103.8713700
- קושחה של Google Hub, Google TV Streamer (4k): UTTK.260317.003
- Android SDK: home.android.sdk_1_11_1.zip
- אפליקציית Google Home: פועלת עם כל גרסה
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.1.0
- גרסת Matter: תמיכה ניסיונית ב-1.5.0
תכונות חדשות
- תמיכה ביצירה, בעדכון ובמחיקה של עקומות תאורה אוטומטיות שמתאימות את הבהירות ואת טמפרטורת הצבע לאורך היום בחדרים או במכשירי תאורה ספציפיים.
- הוספנו הנחיות לגבי האופן שבו הפלטפורמה מטפלת במחיקה אוטומטית של נתוני משתמשים כשמשתמש עוזב מבנה או מוחק את חשבון Google שלו, ואיך משתמשים יכולים לייצא את הנתונים שלהם באמצעות Google Takeout.
-
תמיכה בהגדרה ובאחזור של שילוב השפה והאזור של האפליקציה באמצעות
setLocale()ו-getLocale()לתהליכים בממשק המשתמש שמתארחים ב-SDK, וגם שדות טקסט מותאמים לשוק המקומי (localizedTextsו-localizedBodies) באירועים בענן של תיאורים שנוצרים על ידי AI וסיכומי AI. -
תמיכה בשליטה ב
DeviceGroupכישות אחת באמצעות החלקים של סוג המכשיר, וגם בדיקת החברויות בקבוצה במכשירים נפרדים ופקודות באצווה בין חברי הקבוצה.
שינויים חשובים אחרים
בעיות מוכרות
-
אחרי הפעלה מחדש של המצלמה, יכול להיות שמצב הקישוריות שלה ידווח כ-
PARTIAL_ONLINEבמקום כ-ONLINE. כל התכונות של מצלמת הענן ממשיכות לפעול כרגיל, חוץ מהוצאת Matter משימוש.
2026-09-23
גרסה 1.11 של Home APIs GAהגרסה הזו כוללת תיקוני באגים ושיפורים באיכות של GA ב-Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 26.36.25
- קושחה של Google Hub, Cast, Nest WiFi Pro: 3.78.548779
- קושחה של Google Hub, Cast, כל שאר הרכזות שמבוססות על Cast: 3.79.550760
- קושחה של Google Hub, Fuchsia: 31.20260429.103.8712702
- קושחה של Google Hub, Google TV Streamer (4k): UTTK.260317.003
- Android SDK: home.android.sdk_GHP_1_11
- אפליקציית Google Home: פועלת עם כל גרסה
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.1.0
- גרסת Matter: תמיכה ניסיונית ב-1.5.0
עדכונים חשובים
-
החל מגרסה 1.11, ממשקי Home API דורשים את Kotlin 2.4.0. אם אתם מקמפלים אפליקציה של Home APIs עם גרסה קודמת של Kotlin, אתם צריכים להשתמש באפשרות הקומפיילר
-Xskip-metadata-version-checkכדי למנוע שגיאות שקשורות למטא-נתונים. - החל מגרסה 1.11, כדי להמשיך לתמוך ב-Kotlin Coroutines העדכני, המפתחים נדרשים לעדכן את קובץ ה-gradle שלהם כדי לייבא את ספריות kotlinx.coroutines. אם לא תבצעו את העדכון הזה, תתרחש שגיאת זמן ריצה חוסמת בכל אפליקציות Kotlin שמשתמשות בממשקי ה-API של Home.
תכונות חדשות
שינויים חשובים אחרים
2026-09-16
השקנו שני שרתי MCP חדשים. Home MCP מאפשר לסוכנים אישיים לתקשר עם הבית החכם שלכם בצורה בטוחה, ו-Home Developer MCP מאפשר לסוכנים האהובים עליכם לחפש ולשאול שאלות במסמכי התיעוד של Home Developer Center ובמקורות מידע אחרים על הבית החכם.
תכונות חדשות
2026-09-16
האפליקציה לדוגמה של Home APIs ל-Android עודכנה לגרסה 1.10.1 של Home APIs.
אפליקציה לדוגמה
2026-08-28
גרסה 1.10.1 של Home APIs שזמינה לכלל המשתמשיםהגרסה הזו כוללת תיקוני באגים ושיפורים באיכות של GA ב-Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 26.34.30
- קושחה של Google Hub, Cast, Nest WiFi Pro: 3.78.548779
- קושחת Google Hub, Cast, כל שאר הרכזות שמבוססות על Cast: 3.79.547681
- קושחה של Google Hub, Fuchsia: 31.20260429.103.8712702
- קושחה של Google Hub, Google TV Streamer (4k): UTTK.260317.003
- Android SDK: home.android.sdk_GHP_1_10_1
- אפליקציית Google Home: פועלת עם כל גרסה
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.1.0
- גרסת Matter: תמיכה ניסיונית ב-1.5.0
עדכונים חשובים
תכונות חדשות
- עכשיו יש תמיכה בפרמטרים דינמיים של פקודות ב-Automation API.
- עכשיו יש תמיכה בלוגיקה של If/else ב-Automation API.
שינויים חשובים אחרים
2026-08-07
האפליקציה לדוגמה של Home APIs ל-Android עודכנה לגרסה 1.10 של Home APIs.
אפליקציה לדוגמה
2026-08-03
גרסה 1.10 של Home APIs GAהגרסה הזו כוללת תיקוני באגים ומשדרגת את Android SDK של Home APIs לאיכות GA.
גרסאות מינימליות
- Google Play Services: 26.28.31
- קושחה של Google Hub, Cast, Nest WiFi Pro: 3.78.518349
- קושחה של Google Hub, Cast, כל שאר הרכזות שמבוססות על Cast: 3.78.540761
- קושחה של Google Hub, Fuchsia: 30.20260121.103.1602904
- קושחה של Google Hub, Google TV Streamer (4k): UTTK.260317.003
- Android SDK: home.android.sdk_GHP_1_10
- אפליקציית Google Home: פועלת עם כל גרסה
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.1.0
- גרסת Matter: תמיכה ניסיונית ב-1.5.0
2026-07-09
הדגל forceLaunch הוצא משימוש. כדי לציין את ההתנהגות של ממשק המשתמש לבקשת הסכמה, צריך להעביר את האפליקציות לערך המenum- ForcePermissionFlow.
השינויים הקרובים
-
API שהוצא משימוש: השיטה
requestPermissions(forceLaunch: Boolean, ...)הוצאה משימוש ב-Android Google Home SDK. -
שלב ההעברה: מחליפים את הדגלים הבוליאניים ב-
ForcePermissionFlow.FORCE_LAUNCH(בשבילtrue) או ב-ForcePermissionFlow.DO_NOT_FORCE_LAUNCH(בשבילfalse).
2026-07-08
המדריך למכשירי נתב גבולות ל-Android זמין עכשיו.
תוכן חדש
2026-07-07
האפליקציה לדוגמה של Home APIs ל-Android עודכנה לגרסה 1.9.1 של Home APIs.
אפליקציה לדוגמה
2026-06-26
גרסה 1.9.1 של גרסת הבטא לציבור הרחב של Home APIsהגרסה הזו כוללת תיקוני באגים ומשפרת את איכות גרסת הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 26.24.22
- קושחה של Google Hub, Cast, Nest WiFi Pro: 3.78.518349
- קושחת Google Hub, Cast, כל שאר הרכזות שמבוססות על Cast: 3.78.538123
- קושחה של Google Hub, Fuchsia: 30.20260121.103.1602904
- קושחה של Google Hub, Google TV Streamer (4k): UTTK.250729.004 (14748786)
- Android SDK: home.android.sdk_1_9_1.zip
- אפליקציית Google Home: פועלת עם כל גרסה
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.1.0
- גרסת Matter: תמיכה ניסיונית ב-1.5.0
תכונות חדשות
- מצלמה ופעמון דלת: סטטוס החלפת הסוללה
- תמיכה בתמונות ממוזערות של המצלמה ופעמון הדלת, לשימוש כתצוגה מקדימה במהלך ההגדרה של אזור הפעילות והתצוגה החיה.
בעיות מוכרות שתוקנו
- התאמה מהירה לא נתמכת בדגמי המכשירים הבאים: Google Nest Cam Outdoor (עם כבל, דור 2), Google Nest Cam Indoor (עם כבל, דור 3) ו-Doorbell (עם כבל, דור 3).
2026-06-09
אפליקציית Home APIs Android Sample App עודכנה לגרסה 1.9.0 של Home APIs.
אפליקציה לדוגמה
2026-05-29
גרסת בטא לציבור הרחב של Home APIs, גרסה 1.9הגרסה הזו כוללת תיקוני באגים ומשפרת את איכות גרסת הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 26.20.31
- קושחה של Google Hub, Cast, Nest WiFi Pro: 3.78.518349
- קושחה של Google Hub, Cast, כל שאר הרכזות שמבוססות על Cast: 3.78.526062
- קושחה של Google Hub, Fuchsia: 30.20260121.103.1602904
- קושחה של Google Hub, Google TV Streamer (4k): UTTK.250729.004 (14748786)
- Android SDK: home.android.sdk_GHP_1_9
- אפליקציית Google Home: פועלת עם כל גרסה
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.1.0
- גרסת Matter: תמיכה ניסיונית ב-1.5.0
תכונות חדשות
- הגדרות של מצלמה ופעמון דלת: סוג התושבת של המצלמה
- הגדרות של מצלמות ופעמוני דלת: הכרזה על הגעת אורחים
- הגדרות המצלמה ופעמון הדלת: העדפת איכות השידור החי
- תגובות מהירות בפעמון הדלת
- בחירה אוטומטית של תבנית (structure hinting) כדי לאפשר לשותפים לבחור מראש תבניות לתהליך ההרשאות
- תמיכה במכשירים עם כמה חלקים בתהליכים אוטומטיים
-
עדכונים למאפיינים המותאמים אישית הבאים של Google:
ExtendedFanControl, ExtendedThermostat -
עדכונים בתכונות הבאות של Matter:
ArmDisarm, FanControl, Thermostat, ThermostatFanControl, ThermostatUserInterfaceConfiguration
בעיות מוכרות
- התאמה מהירה לא נתמכת בדגמי המכשירים הבאים: Google Nest Cam Outdoor (עם כבל, דור 2), Google Nest Cam Indoor (עם כבל, דור 3) ו-Doorbell (עם כבל, דור 3).
2026-05-26
אפליקציית Home APIs Android Sample App עודכנה לגרסה 1.8.1 של Home APIs.
אפליקציה לדוגמה
2026-05-01
גרסת בטא לציבור הרחב של Home APIs, גרסה 1.8.1הגרסה הזו כוללת תיקוני באגים ומשפרת את איכות גרסת הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 26.16.31
- קושחה של Google Hub, Cast, Nest WiFi Pro: 3.78.518349
- קושחה של Google Hub, Cast, כל שאר הרכזות שמבוססות על Cast: 3.78.526062
- קושחה של Google Hub, Fuchsia: 30.20260121.103.1602802
- קושחה של Google Hub, Google TV Streamer, 4K: UTTK.250729.004
- Android SDK: home.android.sdk_GHP_1_8_1
- אפליקציית Google Home: גרסה 4.8 ואילך
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.1.0
- גרסת Matter: תמיכה ניסיונית ב-1.5.0
תכונות חדשות
- התכונה "תרמוסטט" תומכת עכשיו ביכולות קריאה/עדכון, הפעלה/כיבוי וטיימר
בעיות מוכרות שתוקנו
- יכול להיות שההפעלה של מכשיר Matter תיכשל.
- הנורה של Philips BLE לא מציגה את המצב הנכון.
- זמן אחזור שגורם לחוסר יציבות ברשת ולזמני תגובה איטיים.
בעיות מוכרות
- אי אפשר להפעיל מכשירים מסוימים באמצעות Google TV Streamer, 4K.
- כשהרכזת היא Nest Wifi Pro, Google Nest Hub או Google Nest Hub Max, אפליקציית Google Home מציגה מכשירים עם כמה חלקים ככמה משבצות.
2026-04-10
האפליקציה לדוגמה ל-Android של Home APIs עודכנה לגרסה 1.8 של Home APIs.
אפליקציה לדוגמה
2026-04-09
גרסת בטא לציבור הרחב של Home APIs, גרסה 1.8הגרסה הזו כוללת תיקוני באגים ומשפרת את איכות גרסת הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 26.12.32
- קושחה של Google Hub, Cast, Nest WiFi Pro: 3.78.518349
- קושחה של Google Hub, Cast, כל שאר הרכזות שמבוססות על Cast: 3.78.526062
- קושחה של Google Hub, Fuchsia: 29.20251023.103.2101601
- קושחה של Google Hub, Google TV Streamer, 4K: UTTK.250729.004
- Android SDK: home.android.sdk_GHP_1_8_0
- אפליקציית Google Home: פועלת עם כל גרסה
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.1.0
- גרסת Matter: תמיכה ניסיונית ב-1.5.0
תכונות חדשות
- הצעות לפעולות אוטומטיות ב-Automations API.
- תמיכה במכשירים עם כמה חלקים ב-Device API.
- הגדרת אזור פעילות של מצלמה ופעמון דלת ב-Device API.
- הגדרת זיהוי צלילים במצלמה ובפעמון הדלת ב-Device API.
- מצב הקלטה של מצלמה ופעמון דלת (CVR/EVR/ללא היסטוריה) ב-Device API.
בעיות מוכרות שתוקנו
- אי אפשר לשנות את יחידות המידה לטמפרטורה (צלזיוס/פרנהייט) ב-Google Nest Learning Thermostat (דור רביעי).
- בגרסה לניידים של Google Home לדפדפן, הסמל העליון והכפתור "הקודם" מוסתרים על ידי כותרת. יכול להיות שהמשתמשים לא יוכלו לחזור אחורה או לראות רכיבים מרכזיים בממשק המשתמש.
- רכזת Android TV עלולה לדווח בטעות על מכשירי Matter כ "לא מחוברים".
בעיות מוכרות
- יכול להיות שההפעלה של מכשיר Matter תיכשל.
2026-03-13
גרסת בטא לציבור הרחב של Home APIs, גרסה 1.7.1הגרסה הזו כוללת תיקוני באגים ומשפרת את איכות גרסת הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services:
- קושחה של Google Hub, Cast, Nest WiFi Pro: 3.78.518349
- קושחה של רכזת Google, Cast, כל שאר הרכזות שמבוססות על Cast: 3.78.516526
- קושחה של Google Hub, Fuchsia: 29.20251023.103.2201
- קושחה של Google Hub, Google TV Streamer, 4K: UTTK.250729.004
- Android SDK: home.android.sdk_GHP_1_7_1
- אפליקציית Google Home: 1.7.1
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.1.0
- גרסת Matter: תמיכה ניסיונית ב-1.5.0
תכונות חדשות
- הבעת הסכמה לניתוח נתונים של מצלמות ופעמוני דלת ב-Device API.
- הזמן האחרון שבו המצלמה ופעמון הדלת היו מחוברים ב-Device API.
- מצב הקישוריות של המצלמה ופעמון הדלת ב-Device API.
- בקשות אטומיות של תרמוסטט ב-Device API.
שינויים חשובים אחרים
- מצב Hubless הוסר.
אפליקציה לדוגמה
בעיות מוכרות שתוקנו
- במצלמות Nest Cam לשימוש פנימי או חיצוני (עם סוללה או עם כבל) ובפעמוני Nest Doorbell (עם סוללה, דור שני), האפשרות "זמן הסוללה שנותר" לא מופיעה בהגדרות הסוללה.
- המערכת מתעלמת מההגדרה של משך הצלצול.
- נורת Philips BLE מופיעה בטעות כ "מחוברת" גם כשהמכשיר לא מחובר.
בעיות מוכרות
- אי אפשר לשנות את יחידות המידה לטמפרטורה (צלזיוס/פרנהייט) ב-Google Nest Learning Thermostat (דור רביעי).
- עיכובים אפשריים ביציבות הרשת ובתגובתיות של המכשיר.
- בגרסה לניידים של Google Home לדפדפן, הסמל העליון והכפתור "הקודם" מוסתרים על ידי כותרת. יכול להיות שהמשתמשים לא יוכלו לחזור אחורה או לראות רכיבים מרכזיים בממשק המשתמש.
- יכול להיות שה-Hub ייתקע במצב "מתחבר…" אחרי הגדרה ראשונית (OOBE) במצב מאוחד.
- יכול להיות שההפעלה של מכשיר Matter תיכשל.
- יכול להיות שרכזת Android TV תדווח בטעות שמכשירי Matter נמצאים במצב אופליין.
- יכול להיות שגרסת התוכנה הנכונה לא תופיע בגרסת התוכנה הנוכחית של מכשיר המצלמה.
- פס הזזה בממשק המשתמש של התרמוסטט מציג טמפרטורות מחוץ לטווח.
- כשהתכונה "משך הצלצול" מוגדרת, המכשיר לא מצלצל במשך הזמן שצוין.
2026-02-13
אפליקציית Home APIs Android Sample App עודכנה לגרסה 1.7 של Home APIs.
אפליקציה לדוגמה
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
- קושחת Google Hub, Cast, כל שאר הרכזות שמבוססות על Cast: 3.77.510748
- קושחה של Google Hub, Fuchsia: 29.20251023.103.2100
- קושחה של Google Hub, Google TV Streamer, 4K: UTTK.250729.004
- Android SDK: home.android.sdk_GHP_1_7
- אפליקציית Google Home: 1.7
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.1.0
- גרסת Matter: תמיכה ניסיונית ב-1.5.0
תכונות חדשות
- משימות אוטומטיות מקומיות: בהתאם לתנאים כמו קישוריות, סוגי מכשירים ותכונות, חלק מהמשימות האוטומטיות יכולות עכשיו לפעול באופן מקומי ב-Automations API.
- הפעלת חוויית הגדרה ראשונית (OOBE) של המצלמה באפליקציות ב-Device API.
- עיצובים של צלצולים למצלמה ולפעמון הדלת ב-Device API.
- מצב חיסכון אוטומטי בסוללה של המצלמה ופעמון הדלת ב-Device API.
- העדפות השימוש בסוללה של המצלמה ופעמון הדלת ב-Device API.
- מצב הטעינה של הסוללה במצלמה ובפעמון הדלת ב-Device API.
- רמות הטעינה של המצלמה ופעמון הדלת ב-Device API.
- המספר הסידורי של המצלמה ופעמון הדלת ב-Device API.
- דגם המצלמה ופעמון הדלת ב-Device API.
- גרסת התוכנה של המצלמה ופעמון הדלת ב-Device API.
- Custom Key-Value API ב-Device API.
- שאילתת הרשאות מאפשרת לאפליקציה לקבוע לאילו סוגי מכשירים המשתמש העניק גישה ב-Permissions API.
שינויים חשובים אחרים
-
הערך
HomeException.unsupportedהוחלף בערךHomeException.unimplementedכדי להתאים לקודי השגיאה הרגילים. - מחולל הקוד הארוז למאפיינים מותאמים אישית השתנה בגרסה 1.7. מפתחים שיש להם תכונות בהתאמה אישית צריכים לקמפל מחדש את התכונות שלהם אחרי שהם משלבים את גרסה 1.7 של ה-SDK.
בעיות מוכרות שתוקנו
-
History API תמיד מחזיר
nextPageToken, מה שגורם ללולאה אינסופית. - השגיאה "המשתמש ביטל את תהליך ההרשאה" מופיעה כשמנסים להתחבר לחשבון חדש.
בעיות מוכרות
- במצלמות Nest Cam לשימוש פנימי או חיצוני (עם סוללה או עם כבל) ובפעמוני Nest Doorbell (עם סוללה, דור שני), האפשרות "זמן הסוללה שנותר" לא מופיעה בהגדרות הסוללה.
- המערכת מתעלמת מההגדרה של משך הצלצול.
-
נורת Philips BLE מופיעה בטעות כ "מחוברת" גם כשהמכשיר לא מחובר. פתרון עקיף: אל תסתמכו רק על הסטטוס אונליין של סוג המכשיר לבית החכם (SHDT). במקום זאת, צריך להשתמש במפה של Target Device State Service (TDSS) למכשירי יעד עם המקור
LOCAL_SYNC.
2025-12-22
גרסה 1.6 של גרסת הבטא לציבור הרחב של Home APIsהגרסה הזו כוללת תיקוני באגים ומשפרת את איכות גרסת הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 25.47.30
- קושחה של Google Hub, Cast, Nest WiFi Pro: 3.75.479819
- קושחת Google Hub, Cast, כל הרכזות האחרות שמבוססות על Cast: 3.77.505721
- קושחה של Google Hub, Fuchsia: 28.20250723.103.2100300
- קושחה של Google Hub, Google TV Streamer, 4K: UTTK.250729.004
- Android SDK: home.android.sdk_GHP_1_6
- אפליקציית Google Home: 1.6
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.1.0
תכונות חדשות
- תמיכה בתכונת מזג האוויר ב-Automation API. הוספנו תמיכה בתכונת מזג האוויר בתנאים ובסימנים לתחילת פעולות אוטומטיות.
- תמיכה ביכולות נוספות של מצלמות ופעמוני דלת: הגדרות חדשות (ראיית לילה, נורית סטטוס, אזור תצוגה, כיוון, רגישות, משך אירוע, פעמון).
- כניסה באמצעות חשבון Google שמתבצעת דרך האפליקציה כדי לייעל את תהליך חוויית המשתמש ולבטל את הצורך בבדיקות של משתמשים פעילים.
- מצב Hubless מאפשר למשתמשים להגדיר מכשירי Matter מסוימים ולשלוט בהם בלי רכזת נפרדת.
- Hub Activation API כדי למצוא ולהפעיל רכזות.
שינויים חשובים אחרים
- באפליקציה לדוגמה ל-Android נוספו הגדרות מצלמה, תרחישים אוטומטיים מוגדרים מראש ותמיכה במאוורר וברמקול.
בעיות מוכרות
- אמצעי הבקרה במכשיר מפסיקים לפעול אחרי תקופות שימוש ארוכות. פתרון עקיף: מפעילים מחדש את הרכזת.
- יכול להיות שההפעלה של מכשיר Matter תיכשל.
- השגיאה "המשתמש ביטל את תהליך ההרשאה" מופיעה כשמנסים להוסיף חשבון חדש באפליקציה לדוגמה ל-Android. פתרון עקיף: מוסיפים חשבונות Google דרך הגדרות המכשיר של Android.
- מצלמת אבטחה קווית של Walmart onn שהוגדרה באמצעות Android Home APIs SDK לא יכולה לשדר בשידור חי באפליקציית Google Home.
- מצלמות שהוגדרו באפליקציות של Home APIs לא יכולות להתחיל סשנים של שידור חי מאפליקציית Google Home.
2025-10-23
גרסת בטא לציבור הרחב של Home APIs, גרסה 1.5.1הגרסה הזו כוללת תיקוני באגים ומשפרת את איכות גרסת הבטא של Home APIs Android SDK.
גרסאות מינימליות
- גרסה 25.41.30 של Google Play Services
- קושחה של Google Hub, Cast: 3.76.495998
- קושחה של Google Hub, Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_5_1
- אפליקציית Google Home: פועלת עם כל גרסה
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.1.0
תכונות חדשות
שינויים חשובים אחרים
- האפליקציה לדוגמה ל-Android מוסיפה תמיכה בסוג מכשיר פעמון לדלת (הפעלה/כיבוי, סטרימינג בשידור חי, שיחה באמצעות הרמקול של המצלמה) והטמעה של Hub Activation API.
בעיות מוכרות שתוקנו
- האפליקציה לדוגמה לא מציגה בצורה נכונה את סטטוס המכשיר בתצוגת המכשיר.
2025-09-26
גרסת בטא לציבור הרחב של Home APIs, גרסה 1.5.0בגרסה הזו הוספנו תמיכה במכשירי מצלמה, תיקנו באגים ושיפרנו את האיכות של גרסת הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 25.37.31
- קושחת Google Hub, Cast: 3.76.492738
- קושחה של Google Hub, Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_5
- אפליקציית Google Home: פועלת עם כל גרסה
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.1.0
תכונות חדשות
- עכשיו אפשר להשתמש במבני Matter כפרמטרים של גורמים מפעילים, תנאים ופעולות ב-Automation API.
- סוג מכשיר המצלמה נוסף ל-Device API (שידור חי, שיחה באמצעות הרמקול של המצלמה, התחלה/הפסקה של ההקלטה).
שינויים חשובים אחרים
-
באפליקציה לדוגמה ל-Android נוספה תמיכה במצלמה, בהפעלה של מספר אדמינים ובאוטומציה מוגדרת מראש של
OnOff.
בעיות מוכרות שתוקנו
- כשמסירים את הרכזת הפעילה, יש חלון של חמש דקות שבו אי אפשר לשלוט במכשירים מסוימים. אחרי חמש דקות, האפשרות לשלוט במכשירים חוזרת.
- אחרי שהמשתמש בוחר צבע מתוך הגדרה קבועה מראש או מתוך בורר טמפרטורת הצבע, הצבע של Extended Color Light לא מתעדכן.
בעיות מוכרות
- יכול להיות שזמן האחזור של השליטה במכשיר יתארך כשעוברים מ-Wi-Fi לרשת סלולרית.
- יכול להיות שהשליטה בסוגי מכשירים של מאווררים שמגובים ב-Cloud-to-cloud לא תפעל באפליקציה לדוגמה.
2025-08-29
גרסה 1.4.1 של גרסת הבטא לציבור הרחב של Home APIsהגרסה הזו כוללת תיקוני באגים ומשפרת את איכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 25.33.32
- קושחה של Google Hub, Cast: 3.76.495998
- קושחה של Google Hub, Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_4_1
- אפליקציית Google Home: פועלת עם כל גרסה
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.0.0
תכונות חדשות
בעיות מוכרות שתוקנו
- האפליקציה לדוגמה ל-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
- קושחה של Google Hub, Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_4_0
- אפליקציית Google Home: פועלת עם כל גרסה
-
ספריית
androidx.core: פועלת עם כל גרסה - גרסת Matter: 1.4.0.0
תכונות חדשות
- אפשר להגביל את מספר הפעמים שבהן פעולות אוטומטיות יופעלו ב-Automation API.
- אפשרות להסיר מכשיר בתקן Matter באופן פרוגרמטי ב-Device API.
-
הוסרו איברים שהוצאו משימוש ב-
HomeDevice(trait(), isInRoom, isInStructure). -
Home.hasPermissions()כולל עכשיו גם גישה למבנה של OAuth וגם הענקת הרשאות שניתנות לאפליקציה.
שינויים חשובים אחרים
- האפליקציה לדוגמה ל-Android מוחקת מכשירים שתומכים רק ב-Matter, משנה את השמות של המכשירים ומחליפה קריאות ל-API שהוצאו משימוש.
בעיות מוכרות שתוקנו
- שואבי אבק רובוטיים שהוצבו בעמדת העגינה לא רושמים את המצב "בעמדת העגינה".
בעיות מוכרות
- אחרי שמתנתקים מהחשבון בטלפון ומתחברים אליו מחדש, אפליקציה שמשתמשת ב-Home APIs לא יכולה לשלוט במכשירים. פתרון עקיף: סוגרים את האפליקציה וממתינים לפחות 10 שניות.
2025-06-26
גרסת בטא לציבור הרחב של Home APIs, גרסה 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 Hub, Cast, Google Nest Audio: 3.75.476451
- קושחה של Google Hub, Fuchsia: 26.20250116.103.2900
- 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). החל מהגרסה הזו, המפתחים צריכים לכלול את שני החלקים בנתיבי הספרייה של הפרויקט בזמן ההידור ובזמן הריצה.
שינויים חשובים אחרים
- אפליקציית Android לדוגמה מוסיפה: המשתמשים יכולים להתנתק מהאפליקציה ולבטל את ההרשאות שלה.
-
הוספת אפליקציה לדוגמה ל-Android: עדכון של פריטי ה-SDK כך שיכללו את
play-services-home-17.0.0ו-play-services-home-types-17.0.0.
בעיות מוכרות
- שואבי אבק רובוטיים שהוצבו בעמדת העגינה לא רושמים את המצב "בעמדת העגינה".
2025-06-05
גרסה 1.3.1 של גרסת הבטא לציבור הרחב של Home APIsהגרסה הזו כוללת תיקוני באגים ושיפורים באיכות של גרסת הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 25.19.32
- קושחת Google Hub, Cast: 3.75.468222
- קושחה של Google Hub, Fuchsia: 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, ומאפשרת למתגים להפעיל גורמים מפעילים של אוטומציה. -
התכונה
ExtendedDoorLockכוללת שינוי תוכנה שעלול לגרום לכשל: סוג הנתונים של השדהuser_idהשתנה מ-Stringל-Long. צריך לקמפל מחדש אפליקציות שמשתמשות בתכונה הזו.
שינויים חשובים אחרים
- באפליקציה לדוגמה ל-Android נוספו פונקציות לרישום ביומן של מצב המבנים, המכשירים, הסוגים, התכונות והאוטומציות, כדי שיהיה קל יותר לנפות באגים.
בעיות מוכרות שתוקנו
-
אפליקציית Google Home קורסת עם
FailedPreconditionExceptionכשיוצרים פעולות אוטומטיות אם מיקום הבית לא מוגדר באפליקציית Google Home. -
באפליקציה לדוגמה ל-Android, מכשיר עם
connectivityStatePARTIALLY_ONLINEהוצג בעבר כלא מחובר. המצב הזה מיוצג עכשיו כ"אונליין".
בעיות מוכרות
- באפליקציה לדוגמה ל-Android, לפעמים צריך ללחוץ כמה פעמים על הכפתור "יצירת פעולה אוטומטית" כדי להפעיל אותה.
2025-05-12
גרסה 1.3 של גרסת הבטא לציבור הרחב של Home APIsהגרסה הזו כוללת תיקוני באגים ושיפורים באיכות של גרסת הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 25.16.33
- קושחת Google Hub, Cast: 3.75.468222
- קושחה של Google Hub, Fuchsia: 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.
בעיות מוכרות שתוקנו
- יכול להיות שזמן האחזור של השליטה במכשיר יתארך כשעוברים מ-Wi-Fi לרשת סלולרית.
- אחרי שמאפסים את הרכזת להגדרות המקוריות, יכול להיות שהמכשירים יופיעו במצב אופליין.
בעיות מוכרות
2025-04-09
גרסה 1.2.1 של Home APIs בגרסת בטא לציבור הרחבהגרסה הזו כוללת תיקוני באגים ושיפורים באיכות של גרסת הבטא של 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.core: 1.10.0 - גרסת Matter: 1.4.0.0
תכונות חדשות
- שיפרנו את הביצועים בטעינת אובייקטים מתרשים הבית.
- Automation API
- הוספנו תמיכה ב מסנני ישויות, שמאפשרים לפעולות אוטומטיות לבחור מכשירים באופן דינמי על סמך קריטריונים שצוינו בפעולה האוטומטית.
- Device API
- פרטי המכשיר ב-Cloud-to-cloud זמינים עכשיו ב-
BasicInformationTrait.
- פרטי המכשיר ב-Cloud-to-cloud זמינים עכשיו ב-
בעיות מוכרות
- יכול להיות שזמן האחזור של השליטה במכשיר יתארך כשעוברים מ-Wi-Fi לרשת סלולרית.
- אחרי שמאפסים את הרכזת להגדרות המקוריות, יכול להיות שהמכשירים יופיעו במצב אופליין.
בעיות מוכרות שתוקנו
- אם מתבצעת קריאה ל-Discovery API לפני ההפעלה או לפני שההפעלה מסתיימת, נזרקת השגיאה
HomeExceptionעםcode 14: UNKNOWNוההודעה "No route found". - בסביבה שכוללת כמה מבנים וכמה משתמשים, מעבר בין מבנים ומשתמשים עלול לגרום לכך שלא יוחזרו מכשירים.
2025-03-14
גרסה 1.2.0 של גרסת הבטא לציבור הרחב של Home APIsהגרסה הזו כוללת תיקוני באגים ושיפורים באיכות של גרסת הבטא של 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.core: 1.10.0 - גרסת Matter:
1.3.0.0
- הערה: אין תמיכה בסוגי מכשירים ובאשכולות זמניים של Matter.
תכונות חדשות
- Automation API:
- תמיכה בטווחי תאריכים ובתאריכים חלקיים בתנאים של פעולות אוטומטיות. אפשר לעיין במאמר שימוש בתאריכים עם between.
- בגרסאות קודמות, Discovery API החזיר
NumberSetConstraintבשדות מסוימים של מפת סיביות (bitmap) במקום להחזירBitmapConstraint. השדות האלה מחזירים עכשיו ערךBitmapConstraintכמו שצריך. האפשרות הזו מוגבלת למפות סיביות שלoptionsMaskו-optionsOverrideבפקודות המאפייןLevelControl.
בעיות מוכרות
- יכול להיות שזמן האחזור של השליטה במכשיר יתארך כשעוברים מ-Wi-Fi לרשת סלולרית.
- אחרי שמאפסים את הרכזת להגדרות המקוריות, יכול להיות שהמכשירים יופיעו במצב אופליין.
- אם מתבצעת קריאה ל-Discovery API לפני ההפעלה או לפני שההפעלה הושלמה, נזרקת השגיאה
HomeExceptionעםcode 14: UNKNOWNוההודעה "No route found".- פתרון עקיף: קוראים ל-Discovery API רק כשבאמת צריך מועמדים לאוטומציה. אל תבצעו אחזור מראש ושמירה במטמון של ישויות מועמדות. לפני שמפעילים שיטות של Discovery API על ישות, צריך לבדוק אם היא אונליין.
- בסביבה שכוללת כמה מבנים וכמה משתמשים, מעבר בין מבנים ומשתמשים עלול לגרום לכך שלא יוחזרו מכשירים.
בעיות מוכרות שתוקנו
- בפעם הראשונה שאפליקציה של Home APIs מפעילה את
HomeManager.structures()אחרי ההפעלה, היא מקבלת אפס מבנים, גם אם יש מבנה אחד או יותר. זה יוצר רושם מוטעה שאין מבנים שמשויכים לחשבון Google. - בזמן הטעינה, היצירה והעריכה של פעולות אוטומטיות, יכול להיות שהמשתמשים יצטרכו להמתין זמן רב.
- משתמשים שמתחילים את תהליך ההגדרה מאפליקציית המצלמה צריכים לסרוק את קוד ה-QR פעמיים כדי להשלים את ההפעלה של Matter.
- במבנה שמכיל יותר מ-200 מכשירים, יכול להיות ש-Discovery API פשוט לא יחזיר מועמדים.
2025-01-29
גרסה 1.1.0 של גרסת הבטא לציבור הרחב של Home APIsהגרסה הזו כוללת תיקוני באגים ושיפורים באיכות של גרסת הבטא של 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.core: 1.10.0 - גרסת Matter:
1.3.0.0
- הערה: אין תמיכה בסוגי מכשירים ובאשכולות זמניים של Matter.
תכונות חדשות
- Streaming API:
- מספקת מקורות נתונים של אירועים שמודיעים על בתים, חדרים ומכשירים שנוספו, שונו והוסרו.
- מידע נוסף זמין במאמר הרשמה לאירועים של קשרי ישויות.
- Batching API (ניסיוני):
- מאפשר למפתח לשלוח כמה פקודות באצוות שמופעלות בו-זמנית.
- איך שולחים כמה פקודות בבת אחת
בעיות מוכרות
- בזמן הטעינה, היצירה והעריכה של פעולות אוטומטיות, יכול להיות שהמשתמשים יצטרכו להמתין זמן רב.
- משתמשים שמתחילים את תהליך ההגדרה מאפליקציית המצלמה צריכים לסרוק את קוד ה-QR פעמיים כדי להשלים את ההפעלה של Matter.
- במבנה שמכיל יותר מ-200 מכשירים, יכול להיות ש-Discovery API פשוט לא יחזיר מועמדים.
בעיות מוכרות שתוקנו
- יכול להיות שהמעבר בין חשבונות Google המחוברים ייכשל ותופיע הודעת שגיאה.
- יכול להיות שמכשירי Google TV לא יפעלו באוטומציות שמשתמשות בתכונה
MediaPlayback. - במבנה שיש בו רק Google Hub:
- יכול להיות שמכשירים בתקן Matter יופיעו במצב אופליין באפליקציית Google Home.
- Google Assistant לא יכולה לשלוט במכשירי Matter.
- אי אפשר לשלוט במכשירי Matter באמצעות מסכים חכמים, או להציג את המצב של מכשירי Matter.
- במכשירים מסוימים, יכול להיות שהאפליקציה לא תמיד תשקף את המצב המדויק, והאפליקציה שלכם עשויה לדווח על מצב שונה מזה שמדווח על ידי אפליקציה של Google, כמו אפליקציית Google Home. בדרך כלל זה קורה כי המכשירים לא מדווחים על המצב ל-Google.
- פתרון עקיף: בדיקת המצב באמצעות אפליקציית Google פותרת את אי-ההתאמה.
2025-01-14
הנחיות מעודכנות להפעלת ממשקי Home API.
הבהרנו שצריך לאתחל מופע של Home כ-context singleton. כך חוויית המשתמש באפליקציה תהיה חלקה יותר, ולא יהיו שגיאות שקשורות לסשנים לא חוקיים.
2025-01-07
גרסת בטא לציבור הרחב של Home APIsבמהלך גרסת הבטא הציבורית למפתחים, כל המפתחים יכולים להתחיל לפתח ולבדוק את האפליקציות שלהם.
הגרסה הזו כוללת תיקוני באגים ומשפרת את איכות הבטא של Android SDK של Home APIs, כולל תמיכה משופרת במכשירי 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: 1.10.0 - גרסת Matter:
1.3.0.0
- הערה: אין תמיכה בסוגי מכשירים ובאשכולות זמניים של Matter.
בעיות מוכרות
- יכול להיות שהמעבר בין חשבונות Google המחוברים ייכשל ותופיע הודעת שגיאה.
- פתרון עקיף: מפעילים מחדש את תהליך ההרשאות או את האפליקציה.
- יכול להיות שמכשירי Google TV לא יפעלו באוטומציות שמשתמשות בתכונה
MediaPlayback. - במבנה שיש בו רק Google Hub:
- יכול להיות שמכשירים בתקן 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 גורמת למכשיר להיות במצב אופליין.
- אחרי איפוס לנתוני היצרן של רכזת, יכול להיות שפקודות למכשירים שהופעלו לאחרונה ייכשלו, למרות שהמכשיר מדווח כמחובר לאינטרנט.