הוספת ממשקי 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. אפליקציית הדוגמה ל-Android תומכת בסוגי המכשירים וב-traits הבאים:

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

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

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

טבלה: רכזות Google Nest עם תמיכה ב-Home APIs
מכשיר 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 מספקת למפתחים. כדי לפתח אפליקציות באמצעות ממשקי ה-API של Home, צריך להוריד את הספריות ולשמור אותן באופן מקומי.

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

כניסה לחשבון

הבא
2. Set up OAuth