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

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 כצפוי. הפונקציה הזו מוגבלת לתמונות ‎bitmap של optionsMask ו-optionsOverride בפקודות המאפיינים של LevelControl.

בעיות מוכרות

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

תכונות חדשות

בעיות מוכרות

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

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

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

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: 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 באפליקציה.
  • בעיה בצד השרת עשויה למנוע מ-OkGoogle להפעיל את ה-starters בתהליכים אוטומטיים.
  • כשמשתמשים ברכז (hub) עם Fuchsia שאין בו מכשירי Matter במבנה, אם הרכז נשאר במצב חוסר פעילות במשך יותר מ-3 שעות, ההפעלה הראשונה של מכשיר Matter תגרום למכשיר Matter להיות אופליין.
  • אחרי שמבצעים איפוס לנתוני היצרן ברכז, יכול להיות שפקדים למכשירים שהוקצו לאחרונה ייכשלו, למרות שהמכשיר מדווח כמקושר לאינטרנט.