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

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

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

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

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

    הורדת Android Studio

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

    התקנה adb.

    אפשר לעשות זאת באמצעות SDK Manager.

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

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

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

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

מרכזים נתמכים

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

טבלה: מכשירי Google Nest Hub עם תמיכה בממשקי Home API
מכשיר תמיכה בנתב גבולות Thread Google Store
Google Home
Google Nest Audio
Google Nest Hub
Google Nest Hub (2nd gen)
Google Nest Hub Max
Google Nest Mini
Google TV Streamer (4k)
Nest WiFi Pro

הגדרת ה-SDK

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

כדי להוריד את Home APIs Android SDK, קודם צריך להיכנס אל Google Home Developers.

כניסה לחשבון

הבא
2. Set up OAuth