הוספת ממשקי Home API לאפליקציה ל-Android

כדי להוסיף את ממשקי ה-API של Home לאפליקציה ל-Android, צריך לעמוד בכמה תנאים מוקדמים.

דרישות מוקדמות

לפיתוח, תצטרכו מחשב עם הכלים הבאים מותקנים בו:

  • Android Studio, גרסה 2024.2.1 ("Ladybug") ואילך. שימו לב: יכול להיות שגרסאות ישנות יותר לא יפעלו כמו שצריך עם ה-SDK של Home APIs.

    הורדת Android Studio

  • תדירת הבאגים של Android‏ (adb).

    מתקינים את adb.

    אפשר לעשות זאת באמצעות מנהל ה-SDK.

כדי לבדוק את ממשקי ה-API של Home, תצטרכו:

  • מכשיר Android עם מערכת הפעלה Android 10 ואילך, שמוגדרת בו חשבון Google שבו אתם מתכוונים להשתמש לפיתוח. מוודאים שגרסה עדכנית של Android Studio מותקנת ומחוברת לחשבון הפיתוח הזה.
  • רשת Wi-Fi.
  • מרכז Google שתומך בממשקי ה-API של Home.

  • מכשיר נתמך אחד לפחות בבית. אם המכשיר הזה (או כל מכשיר אחר שרוצים לבדוק) משתמש ב-Thread, גם הרכז צריך להיות נתב גבולות ל-Thread. סוגי המכשירים והמאפיינים הבאים נתמכים באפליקציית הדוגמה ל-Android:

    • תאורת טמפרטורת צבע (הפעלה והשבתה, בהירות)
    • חיישן מגע (מצב בוליאני)
    • תאורה ניתנת לעמעום (הפעלה וכיבוי, בהירות)
    • תאורת צבעים מורחבת (הפעלה והשבתה, בהירות)
    • Generic Switch
    • חיישן נוכחות (חיישן תנועה)
    • הפעלה/השבתה של התאורה (הפעלה והשבתה, בהירות)
    • מתג תאורה להפעלה/כיבוי
    • יחידת Plug-in להפעלה/השבתה (הפעלה והשבתה)
    • חיישן מצב מופעל/מושבת

צמתים נתמכים

רק מרכזי Google Nest מסוימים תומכים בממשקי ה-API של Home.

טבלה: מרכזי Google Nest עם תמיכה ב-Home APIs
מכשיר מערכת ההפעלה Thread תמיכה בנתב גבולות Google Store
Google Home הפעלת Cast
Google Nest Audio שחקנים
Google Nest Hub הפעלת Cast
Google Nest Hub (2nd gen) Fuchsia
Google Nest Hub Max Fuchsia
Google Nest Mini הפעלת Cast
Google TV Streamer (4k) Android

הגדרת ה-SDK

ממשקי ה-API של Home בגרסה הבטא הפתוחה הזו עדיין לא נכללים בספריות הסטנדרטיות ש-Google מספקת לפיתוח. כדי לפתח אפליקציות באמצעות Home APIs, צריך להוריד את הספריות לאתר המקומי ולארח אותן.

כדי להוריד את ה-SDK של Home APIs ל-Android, תחילה צריך להיכנס לחשבון Google Home Developers.

כניסה לחשבון