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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

פתרון בעיות

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

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