שימוש באפליקציה לדוגמה ל-Android

אפליקציית הדוגמה ל-Android מציגה את היכולות הבסיסיות של גישה למכשירים ושליטה בהם באמצעות ממשקי ה-API של Home לסוגי המכשירים שהיא תומכת בהם.

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

אם מכשיר נמצא בחדר, הוא יופיע ברשימה מתחת לחדר. אפליקציית הדוגמה תומכת בסוגי המכשירים הבאים:

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

פעולות במכשירים קיימים ובאוטומציות

אפליקציית הדוגמה מורכבת משתי כרטיסיות – מכשירים ואוטומציות. בכל כרטיסייה מופיע מידע על המבנה, ואפשר לבצע משימות.

כרטיסיית מכשירים

בכרטיסייה מכשירים (איור 1) מוצגים החדרים במבנה (חצר אחורית, עליית גג, נסיעה) והמכשירים בכל חדר, יחד עם הסטטוס של כל מכשיר. כדי לראות או לערוך את המאפיינים של מכשיר, מקישים על שם המכשיר. הפעולה הזו תעביר אתכם למסך הבקרה של המכשיר (איור 2).

כדי להוסיף מכשיר למבנה, מקישים על הוספת מכשיר בכרטיסייה מכשירים (איור 1), ואז פועלים לפי ההוראות להוספת מכשיר עם או בלי שימוש בקוד QR.

הכרטיסייה 'מכשירים' באפליקציית הדוגמה Home APIs.
איור 1: דוגמה למסך אפליקציה: תצוגה של כרטיסיית המכשירים
אמצעי הבקרה של המכשיר באפליקציית הדוגמה של Home APIs.
איור 2: דוגמה לאמצעי בקרה למכשירים באפליקציה

הכרטיסייה 'פעולות אוטומטיות'

בכרטיסייה אוטומציות (איור 3) מוצגת רשימה של כל האוטומציות במבנה. בכל אוטומציה מוצגים הסימנים לתחילת פעולות אוטומטיות והפעולות שלה. יש תמיכה בכמה התחלות ופעולות.

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

בנוסף, בתצוגה המפורטת של פעולה אוטומטית (איור 4), אפשר להפעיל או להשבית את הפעולה האוטומטית באמצעות המתג isActive. השדה isValid מוגדר על ידי ה-SDK והערך שלו הוא false אם יש בעיה בתמיכה במכשיר או בתכונה, או בעיה אחרת.

הכרטיסייה 'אוטומציות' באפליקציית הדוגמה Home APIs.
איור 3: תצוגה של הכרטיסייה 'פעולות אוטומטיות'
תצוגה מפורטת של פעולה אוטומטית שנבחרה.
איור 4: תצוגה מפורטת של פעולה אוטומטית אחת

יצירת פעולה אוטומטית

כדי ליצור אוטומציה חדשה, מקישים על הלחצן יצירה בתצוגת רשימת האוטומציות (איור 3). מופיע המסך New Automation (איור 5).

משתמשים בלחצנים +הוספת סימן לתחילת פעולה ו+הוספת פעולה (איור 5) כדי להוסיף סימן לתחילת פעולה אחד או יותר ופעולה אחת או יותר לפעולות האוטומטיות. באיורים 6 ו-7 מוצגות דוגמאות לבחירת סימן לתחילת פעולה ופעולה, בהתאמה. אחרי שבוחרים את האפשרויות הרצויות ושומרים את ההתחלה או את הפעולה, מוצגים הלחצנים עדכון ההתחלה והסרת ההתחלהעדכון הפעולה והסרת הפעולה). כך תוכלו לערוך את הסימן לתחילת פעולה או את הפעולה, או להסיר אותם, לפני שתשמרו את האוטומציה עצמה.

אחרי שמסיימים להוסיף סימנים לתחילת פעולה ופעולות, אפשר לחזור למסך New Automation (פעולה אוטומטית חדשה) ולהקיש על Create Automation (יצירת פעולה אוטומטית) (איור 8).

מסך אפליקציה לדוגמה להתחלת פעולות אוטומטיות חדשות.
איור 5: התחלת יצירת פעולות אוטומטיות חדשות
מסך לדוגמה של אפליקציה להוספת סימן לתחילת פעולה אוטומטית.
איור 6: הוספת סימן לתחילת פעולה לפעולות אוטומטיות
מסך אפליקציה לדוגמה להוספת פעולה לאוטומציה.
איור 7: הוספת פעולה לאוטומציה
מסך אפליקציה לדוגמה ליצירת פעולה אוטומטית.
איור 8: יצירת האוטומציה

פתרון בעיות

האפליקציה מציגה הודעות בתיבת דו-שיח לגבי אירועים נפוצים מסוימים שעשויים להתרחש. בadb יומנים מופיע מידע על פתרון הבעיות שקשורות לאירועים האלה.

אם נתקלתם בבעיות בשימוש באפליקציית הדוגמה, כדאי לעיין במאמר פתרון בעיות ב-Android.