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

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

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

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

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

    להורדת 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 לדוגמה תומכת בסוגי המכשירים והתכונות הבאים:

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

רכזות נתמכות

רק חלק מהרכזות של 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

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

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

כניסה לחשבון

הבא
2. Set up OAuth