הוספת ממשקי 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.
  • כדי לגשת למכשירי Matter ולשלוט בהם, צריך גם רכזת Google שתומכת בממשקי ה-API של Home. פרטים נוספים זמינים במאמר קישוריות ב-Android .

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

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

צמתים נתמכים

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

כניסה לחשבון

הבא
2. Set up OAuth