כדי להקל על השימוש, גרסאות פשוטות של חלק מהמאפיינים זמינות לשימוש עם Automation API ב-iOS.
מאפיין פשוט הוא תחליף למאפיין רגיל של Home API, בדומה לאופן הפעולה של תבנית facade. תכונות פשוטות מספקות פקודות שמקלות על ביצוע משימות נפוצות בסוגים מסוימים של מכשירים. מאפיינים פשוטים הם מאפיינים של Home API, וכמו מאפיינים אחרים של Home API, הם פועלים גם במכשירי Matter וגם במכשירי Cloud-to-cloud.
תכונה פשוטה היא קבוצת משנה חלופית של מאפיינים ופקודות שהם ספציפיים יותר למכשיר מאלה של התכונה התקנית התואמת.
לדוגמה, המאפיין הרגיל
LevelControlTrait
trait הוא מאפיין כללי שאפשר להשתמש בו בכל מכשיר שיש לו הגדרה שמשתנה באופן רציף בטווח של ערכים מספריים.
BrightnessTrait הוא מאפיין פשוט שמחליף את LevelControlTrait ומספק רק את הפקודות והמאפיינים שמכשיר DimmableLightDeviceType צריך. ל-BrightnessTrait יש פקודה moveToBrightness עם ארגומנט brightnessPercent יחיד, ואילו ל-LevelControlTrait יש כמה פקודות move, שלרוב כוללות לפחות ארבעה פרמטרים כדי להתאים למגוון רחב יותר של תרחישי שימוש.
בטבלה הבאה מוצג כל מאפיין פשוט והמאפיינים הרגילים שמהווים את הבסיס שלו. כל שם של מאפיין מקושר לתיעוד ה-API המתאים:
| מאפיין פשוט | מאפיין רגיל |
|---|---|
SimplifiedThermostatTrait
|
ThermostatTrait
|
BrightnessTrait
|
LevelControlTrait
|
SimplifiedOnOffTrait
|
OnOffTrait
|
VolumeTrait
|
LevelControlTraitOnOffTrait
|
תכונות פשוטות ו-Discovery API
Discovery API מדווח על מאפיינים פשוטים וגם על מאפייני הבסיס שלהם, כל עוד שני המאפיינים הוגדרו בצורה נכונה כ-ReferencedAutomationTypes בהגדרה של האפליקציה. לדוגמה, אם מכשיר DimmableLightDeviceType קיים במבנה והמפתח רשם את המאפיינים LevelControlTrait ו-BrightnessTrait, Discovery API יציין את הנוכחות של שני המאפיינים. המפתח יכול לבחור להשתמש בכל אחת מהתכונות האלה באוטומציה שלו.
מידע נוסף זמין במאמר בנושא הגדרת הבית.