כדי להוסיף את ממשקי ה-API של Home לאפליקציית Android, צריך לעמוד בכמה תנאים מוקדמים.
דרישות מוקדמות
לפיתוח, תצטרכו מחשב עם הכלים הבאים:
Android Studio, גרסה 2024.2.1 (Ladybug) ואילך. שימו לב: יכול להיות שגרסאות קודמות לא יפעלו כמו שצריך עם Home APIs SDK.
כלי לניפוי באגים ב-Android (
adb).התקנה
adb.אפשר לעשות את זה באמצעות SDK Manager.
כדי לבדוק את ממשקי ה-API של Home, תצטרכו:
- מכשיר Android עם Android מגרסה 10 ואילך, שהוגדר בו חשבון Google שבו אתם מתכוונים להשתמש לפיתוח. מוודאים שמותקנת גרסה עדכנית של Android Studio ושנכנסתם אליה באמצעות חשבון הפיתוח הזה.
- רשת Wi-Fi.
- כדי לגשת למכשירי Matter ולשלוט בהם, צריך גם רכזת של Google שתומכת בממשקי Home API. פרטים נוספים זמינים במאמר בנושא קישוריות ב-Android .
לפחות מכשיר אחד נתמך בבית. אם המכשיר הזה (או כל מכשיר אחר שרוצים לבדוק) משתמש בפרוטוקול Thread, הרכזת צריכה להיות גם נתב גבולות לפרוטוקול Thread. אלה סוגי המכשירים וה-traits שנתמכים באפליקציית הדוגמה ל-Android:
- תאורה עם טמפרטורת צבע (הפעלה וכיבוי, בהירות)
- חיישן מגע (מצב בוליאני)
- תאורה ניתנת לעמעום (הפעלה וכיבוי, בהירות)
- תאורה עם טווח צבעים רחב (הפעלה והשבתה, בהירות)
- Generic Switch
- חיישן נוכחות (גלאי נוכחות)
- הפעלה/השבתה של התאורה (הפעלה והשבתה, בהירות)
- מתג הפעלה/כיבוי של תאורה
- יחידת תוסף הפעלה/השבתה (הפעלה והשבתה)
- חיישן הפעלה/כיבוי
מרכזים נתמכים
רק חלק ממכשירי Google Nest Hub תומכים בממשקי Home API.
הגדרת ה-SDK
ממשקי ה-API של Home בגרסת הבטא הפתוחה הזו עדיין לא נכללים בספריות הסטנדרטיות ש-Google מספקת למפתחים. כדי לפתח אפליקציות באמצעות ממשקי ה-API של Home, צריך להוריד את הספריות ולשמור אותן באופן מקומי.
כדי להוריד את Home APIs Android SDK, קודם צריך להיכנס אל Google Home Developers.