כדי להקל על השימוש, גרסאות פשוטות של חלק מהתכונות זמינות לשימוש עם Automation API ב-iOS.
תכונה פשוטה מחליפה תכונה רגילה של Home API, בדומה לאופן שבו פועלת תבנית החזית. תכונות פשוטות מספקות פקודות שמקלות על ביצוע משימות נפוצות בסוגי מכשירים מסוימים. התכונות הפשוטות הן תכונות של Home API, וכמו תכונות אחרות של Home API, הן פועלות גם במכשירי Matter וגם במכשירי Cloud-to-cloud.
תכונה פשוטה מציעה קבוצת משנה חלופית של מאפיינים ופקודות, שהיא ספציפית יותר למכשיר מאשר אלה של התכונה הרגילה התואמת.
לדוגמה, התכונה הסטנדרטית LevelControlTrait היא תכונה כללית שאפשר להשתמש בה בכל מכשיר שיש לו הגדרה שמשתנה באופן רציף בטווח של ערכים מספריים.
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 יציין את הנוכחות של שתי התכונות. המפתח יכול לבחור להשתמש בכל אחת מהתכונות באוטומציה שלו.
מידע נוסף זמין במאמר הגדרת דף הבית.