2026-05-01
Home APIs Public Beta release 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.corelibrary: פועל בכל גרסה - גרסת Matter: 1.4.1.0
- גרסת Matter: תמיכה ניסיונית בגרסה 1.5.0
תכונות חדשות
- מאפיין התרמוסטט תומך עכשיו ביכולות Read/Update, On/Off ו-Timer
בעיות מוכרות שתוקנו
- יכול להיות שהפעלת מכשיר Matter תיכשל.
- מנורת Philips BLE לא מציגה את המצב הנכון.
- זמן האחזור גורם לחוסר יציבות ברשת ולזמני תגובה איטיים.
בעיות מוכרות
- אי אפשר להפעיל חלק מהמכשירים באמצעות Google TV Streamer, 4K.
- אם הרכזת היא Nest Wifi Pro, Google Nest Hub או Google Nest Hub Max, מכשירים מרובי חלקים מוצגים באפליקציית Google Home בתור כמה משבצות.
2026-04-10
אפליקציית הדוגמה של Home APIs ל-Android עודכנה לגרסה 1.8 של Home APIs.
אפליקציה לדוגמה
2026-04-09
Home APIs Public Beta release 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.corelibrary: פועל בכל גרסה - גרסת Matter: 1.4.1.0
- גרסת Matter: תמיכה ניסיונית בגרסה 1.5.0
תכונות חדשות
- הצעות לאוטומציות ב-Automations API.
- תמיכה במכשירים מרובי חלקים ב-Device API.
- הגדרה של אזור פעילות במצלמה ובפעמון הדלת ב-Device API
- הגדרת זיהוי צלילים במצלמה ובפעמון הדלת ב-Device API.
- מצב הקלטה של מצלמה ופעמון דלת (CVR/EVR/No History) ב-Device API.
בעיות מוכרות שתוקנו
- אי אפשר לשנות את יחידות הטמפרטורה (C/F) ב-Google Nest Learning Thermostat (דור רביעי).
- בגרסה לנייד של Google Home לדפדפן, הסמל העליון והכפתור "הקודם" מוסתרים על ידי כותרת. יכול להיות שהמשתמשים לא יוכלו לחזור אחורה או לראות רכיבים מרכזיים בממשק המשתמש.
- יכול להיות שמרכז שליטה של Android TV ידווח בטעות על מכשירי Matter כ'לא מקוונים'.
בעיות מוכרות
- יכול להיות שהפעלת מכשיר Matter תיכשל.
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
- הקושחה של רכזת 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.corelibrary: פועל בכל גרסה - גרסת Matter: 1.4.1.0
- גרסת Matter: תמיכה ניסיונית בגרסה 1.5.0
תכונות חדשות
- הבעת הסכמה לשימוש בנתוני ניתוח של מצלמות ופעמוני דלת ב-Device API.
- השדה 'השעה האחרונה שבה המצלמה ופעמון הדלת היו מחוברים' ב-Device API.
- מצב הקישוריות של המצלמה ופעמון הדלת ב-Device API.
- בקשות אטומיות של תרמוסטט ב-Device API.
שינויים חשובים אחרים
- הסרנו את מצב ללא רכזת.
אפליקציה לדוגמה
בעיות מוכרות שתוקנו
- ב-Nest Cam לשימוש פנימי וחיצוני (עם סוללה או עם חיבור קווי) וב-Nest Doorbell (סוללה, דור שני), האפשרות 'זמן הסוללה שנותר' לא מופיעה בהגדרות הסוללה.
- המערכת מתעלמת מההגדרה של משך הצלצול.
- נורת Philips BLE מופיעה באופן שגוי כ'אונליין' גם כשהמכשיר נמצא במצב אופליין.
בעיות מוכרות
- אי אפשר לשנות את יחידות הטמפרטורה (C/F) ב-Google Nest Learning Thermostat (דור רביעי).
- יכולים להיות עיכובים ביציבות הרשת ובתגובתיות המכשיר.
- בגרסה לנייד של Google Home לדפדפן, הכותרת מסתירה את הסמל העליון ואת הכפתור "הקודם". יכול להיות שהמשתמשים לא יוכלו לחזור אחורה או לראות רכיבים מרכזיים בממשק המשתמש.
- יכול להיות שה-Hub יישאר תקוע במצב 'מתחבר...' אחרי OOBE במצב מאוחד.
- יכול להיות שהפעלת מכשיר Matter תיכשל.
- יכול להיות שמרכז של Android TV ידווח בטעות שמכשירי Matter לא מחוברים לאינטרנט.
- יכול להיות שגרסת התוכנה הנכונה לא תופיע ב'גרסת התוכנה הנוכחית של המצלמה'.
- פס הזזה בממשק המשתמש של התרמוסטט מציג טמפרטורות שלא נמצאות בטווח.
- כשהאפשרות 'משך הצלצול' מוגדרת, המכשיר לא מצלצל למשך הזמן שצוין.
2026-02-13
אפליקציית הדוגמה ל-Android של Home APIs עודכנה לגרסה 1.7 של Home APIs.
אפליקציה לדוגמה
2026-02-09
השקה של גרסת בטא ציבורית של Home APIs 1.7הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 26.02.34
- קושחה של רכזת Google, 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.corelibrary: פועל בכל גרסה - גרסת 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 in Device API
- שאילתת הרשאות מאפשרת לאפליקציה לקבוע לאילו סוגי מכשירים המשתמש העניק גישה ב-Permissions API.
שינויים חשובים אחרים
-
הקוד
HomeException.unsupportedהוחלף בקודHomeException.unimplementedכדי להתאים לקודי שגיאה סטנדרטיים. - כלי ליצירת הקוד הארוז לתכונות מותאמות אישית השתנה בגרסה 1.7. מפתחים שיש להם מאפיינים מותאמים אישית צריכים לקמפל מחדש את המאפיינים שלהם אחרי שהם משלבים את ערכת SDK 1.7.
בעיות מוכרות שתוקנו
-
History API תמיד מחזיר
nextPageToken, וגורם ללולאה אינסופית. - השגיאה 'המשתמש ביטל את תהליך ההרשאה' מופיעה כשמנסים להיכנס לחשבון חדש.
בעיות מוכרות
- ב-Nest Cam לשימוש פנימי וחיצוני (עם סוללה או עם חיבור קווי) וב-Nest Doorbell (סוללה, דור שני), האפשרות 'זמן הסוללה שנותר' לא מופיעה בהגדרות הסוללה.
- המערכת מתעלמת מההגדרה של משך הצלצול.
-
נורת Philips BLE מופיעה באופן שגוי כ'אונליין' גם כשהמכשיר נמצא במצב אופליין. פתרון עקיף: אל תסתמכו רק על הסטטוס אונליין של סוג המכשיר לבית חכם (SHDT). במקום זאת, אפשר להשתמש במפת שירות מצב מכשיר היעד (TDSS) למכשירים עם מקור
LOCAL_SYNC.
2025-12-22
Home APIs Public Beta release 1.6הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 25.47.30
- הקושחה של הרכזת של Google, Cast, Nest Wifi Pro: 3.75.479819
- קושחה של רכזת Google, 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.corelibrary: פועל בכל גרסה - גרסת Matter: 1.4.1.0
תכונות חדשות
- תמיכה בתכונת מזג האוויר ב-Automation API. נוספה תמיכה בתכונת מזג האוויר בסימנים לתחילת פעולות אוטומטיות ובתנאים.
- תמיכה ביכולות נוספות של מצלמות ומכשירי פעמון לדלת: הגדרות חדשות (ראיית לילה, נורית סטטוס, חלון תצוגה, כיוון, רגישות, משך האירוע, צלצול).
- כניסה לחשבון Google שמתחילה באפליקציה כדי לייעל את תהליך חוויית המשתמש ולבטל בדיקות של משתמשים פעילים.
- במצב 'ללא רכזת' המשתמשים יכולים להוסיף מכשירי Matter מסוימים ולשלוט בהם בלי רכזת עצמאית.
- Hub Activation API (ממשק API להפעלת מרכזים) כדי לגלות ולהפעיל מרכזים.
שינויים חשובים אחרים
- אפליקציית הדוגמה ל-Android מוסיפה הגדרות מצלמה, אוטומציות מוגדרות מראש ותמיכה במאוורר וברמקול.
בעיות מוכרות
- ממשק השליטה במכשירים מפסיק לפעול אחרי תקופות שימוש ארוכות. פתרון עקיף: מפעילים מחדש את הרכזת.
- יכול להיות שהפעלת מכשיר Matter תיכשל.
- השגיאה 'המשתמש ביטל את תהליך ההרשאה' מופיעה כשמנסים להוסיף חשבון חדש באפליקציית הדוגמה ל-Android. פתרון עקיף: מוסיפים חשבונות Google דרך הגדרות המכשיר של Android.
- אי אפשר להפעיל סטרימינג בשידור חי של מצלמת אבטחה קווית של Walmart onn שהופעלה באמצעות Android Home APIs SDK באפליקציית Google Home.
- אי אפשר להתחיל סשנים של שידור חי באפליקציית Google Home ממצלמות שהופעלו באפליקציות של Home APIs.
2025-10-23
השקת גרסת בטא ציבורית של Home APIs 1.5.1הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של Home APIs Android SDK.
גרסאות מינימליות
- Google Play Services: 25.41.30
- הקושחה של Google Hub, Cast: 3.76.495998
- קושחה של Google Hub, Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_5_1
- אפליקציית Google Home: פועלת עם כל גרסה
-
androidx.corelibrary: פועל בכל גרסה - גרסת Matter: 1.4.1.0
תכונות חדשות
שינויים חשובים אחרים
- אפליקציית הדוגמה ל-Android מוסיפה תמיכה בסוג המכשיר 'פעמון דלת' (הפעלה/השבתה, שידור חי, שיחה באמצעות הרמקול של המצלמה) והטמעה של Hub Activation API.
בעיות מוכרות שתוקנו
- אפליקציית הדוגמה לא מציגה נכון את סטטוס המכשיר בתצוגת המכשיר.
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
- קושחה של Google Hub, Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_5
- אפליקציית Google Home: פועלת עם כל גרסה
-
androidx.corelibrary: פועל בכל גרסה - גרסת Matter: 1.4.1.0
תכונות חדשות
- ה-API לאוטומציה תומך עכשיו במבני נתונים של תקן Matter כפרמטרים של סימנים לתחילת פעולה, תנאים ופעולות.
- סוג מכשיר המצלמה נוסף ל-Device API (שידור חי, שיחה באמצעות הרמקול של המצלמה, התחלה/הפסקה של הקלטה).
שינויים חשובים אחרים
-
אפליקציית הדוגמה ל-Android מוסיפה תמיכה במצלמה, בהקצאת הרשאות לכמה אדמינים וב
OnOffאוטומציה מוגדרת מראש.
בעיות מוכרות שתוקנו
- כשמרכז הבקרה הפעיל מוסר בכוח, יש חלון של חמש דקות שבמהלכו אי אפשר לשלוט בחלק מהמכשירים. אחרי חמש דקות, היכולת לשלוט במכשירים חוזרת.
- אחרי שהמשתמש בוחר צבע מתוך הגדרות קבועות מראש או מתוך בוחר טמפרטורת הצבע, הצבע של נורת ה-Extended Color לא מתעדכן.
בעיות מוכרות
- יכול להיות שזמן האחזור של השליטה במכשיר יתארך כשעוברים מ-Wi-Fi לרשת סלולרית.
- יכול להיות שהשליטה בסוגי מכשירים של מאווררים שמגובה על ידי Cloud-to-Cloud לא תפעל באפליקציית הדוגמה.
2025-08-29
השקה של גרסת בטא ציבורית של Home APIs 1.4.1הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של 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.corelibrary: פועל בכל גרסה - גרסת 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.corelibrary: פועל בכל גרסה - גרסת 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 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, 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.corelibrary: פועל בכל גרסה - גרסת 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
Home APIs Public Beta release 1.3.1הגרסה הזו כוללת תיקוני באגים ושיפורים באיכות הבטא של 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.corelibrary: פועל בכל גרסה - גרסת Matter: 1.4.0.0
תכונות חדשות
-
הוספנו את המאפיין
SyntheticSwitchשמפשט את הטיפול באירועים שנוצרים על ידי מכשירי Matter Switch ומאפשר למתגים להפעיל התחלות אוטומציה. -
בתכונה
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.corelibrary: פועל בכל גרסה - גרסת Matter: 1.4.0.0
תכונות חדשות
-
הוספנו תמיכה בהפעלת אירועים מתוזמנים חוזרים ב-Automation API, שמאפשרת למפתחים ליצור אוטומציות שפועלות מעת לעת על סמך שעת שעון, שעת שמש ותנאים מבוססי-יומן, באמצעות ביטויי
cron. - נוספה האפשרות לשנות את השם של מכשירים ב-Device API.
- הוספנו את האפשרות לשנות את השם של חדרים ב-Structure 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 להיות אופליין.
- אחרי שמבצעים איפוס לנתוני היצרן של רכז, יכול להיות שהפקודות למכשירים חדשים שהוגדרו לא יפעלו, למרות שהמכשיר מדווח כמחובר לאינטרנט.