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

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

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

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

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

    הורדת Android Studio

  • תכונת ניפוי הבאגים של Android‏ (adb).

    מתקינים את adb.

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

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

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

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

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

צמתים נתמכים

רק מרכזי 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.

כניסה לחשבון