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

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

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

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

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

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

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

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

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

הכרטיסייה "מכשירים" באפליקציה לדוגמה של ממשקי ה-API של Home ל-iOS.
איור 1: תצוגת הכרטיסייה "מכשירים"
אמצעי הבקרה על המכשירים באפליקציה לדוגמה של ממשקי ה-API של Home ל-iOS.
איור 2: ניתוק או עדכון של הרשאות

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

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

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

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

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

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

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

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

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

כדי לערוך את השם והתיאור של האוטומציה, בתצוגה המפורטת של האוטומציה (איור 4), לוחצים על סמל ההגדרות ואז על עריכת השם (איור 8). כפי שמוצג באיור 9, עורכים את השם והתיאור וחוזרים אחורה בסיום (איור 8). כדי לשמור, לוחצים על סמל ההגדרות ואז על שמירה.

מסך של אפליקציה לדוגמה שבו בוחרים את הכפתור לעריכת השם.
איור 8: עריכת שם האוטומציה
מסך של אפליקציה לדוגמה לעריכת השם והתיאור של האוטומציה.
איור 9: עורך השם והתיאור

מחיקת פעולה אוטומטית

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

מסך של אפליקציה לדוגמה למחיקת פעולה אוטומטית.
איור 10: מחיקת פעולה אוטומטית

עורך אוטומציה כללי

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

כדי להוסיף פעולה אוטומטית כללית, לוחצים על פעולה אוטומטית כללית במסך ההצעות לפעולות אוטומטיות (איור 5).

במסך הבא, אתם יכולים לערוך את השם והתיאור של האוטומציה.

הוספת מועמד לתחילת הפעולה

כדי להוסיף גורם אפשרי להפעלה, לוחצים על הוספת גורם להפעלה ותנאי (איור 11). במסך המועמדים להפעלה מוצגים הגורמים הזמינים להפעלה במבנה (איור 12). כדי להמשיך, בוחרים באחת מהאפשרויות הראשוניות (איור 13).

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

בוחרים באפשרות הפעלה או כיבוי או שינוי הבהירות (איור 14 ואיור 15) ומפעילים או מכבים את האפשרות או משנים את הבהירות. בסיום ההגדרה, לוחצים על סיום כדי לחזור למסך העריכה הכללי. התבנית שבחרתם תופיע במסך העריכה הכללי (איור 16).

להדליק או לכבות את האורות.
איור 14: הפעלה או כיבוי של האור
פקדי פס הזזה של בהירות להגדרת גורם מפעיל של בקרת רמה
איור 15: שינוי הבהירות
עורך אוטומציה כללי שבו מוצג הגורם החדש שנוסף לרשימה
איור 16: הוספת גורם להפעלה

הוספת פעולה מועמדת

כדי להוסיף פעולה מועמדת, לוחצים על הוספת פעולה (איור 17). במסך Action Candidates מוצגות הפעולות האפשריות (איור 18). בוחרים אחת מהפעולות האפשריות כדי להמשיך (איור 19).

עורך כללי של פעולות אוטומטיות שבו מוצג הכפתור "הוספת פעולה" מתחת לסימן לתחילת הפעולה
איור 17: הוספת פעולה
רשימת הפעולות האפשריות
איור 18: רשימת פעולות מועמדות
מסך לבחירת פעולה שבו מוצגות התכונות הנתמכות במכשיר שנבחר
איור 19: בחירת פעולה
הדלקה או כיבוי של האורות
איור 20: LevelControlTrait לא נתמך לפעולות

בוחרים באפשרות הפעלה או כיבוי ובוחרים אם המכשיר יופעל או יכובה. לוחצים על סיום כדי לחזור למסך העריכה הכללי (איור 21). לוחצים על שמירה כדי ליצור את האוטומציה (איור 22). הפעולה האוטומטית תופיע בכרטיסייה "פעולות אוטומטיות" (איור 23).

הדלקה או כיבוי של האורות
איור 21: הפעלה או כיבוי של האור
נוספו טריגר ופעולה.
איור 22: הוספת גורם להפעלה ופעולה
הכרטיסייה "פעולות אוטומטיות" שבה מוצגת הפעולה האוטומטית הגנרית החדשה שנוצרה
איור 23: יצירת אוטומציה כללית