כדי להקל על השימוש, יש גרסאות פשוטות יותר של מאפיינים מסוימים שזמינות לשימוש עם 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
|
LevelControlTrait OnOffTrait
|
מאפיינים פשוטים ו-Discovery API
Discovery API מדווח על מאפיינים פשוטים וגם על המאפיינים הרגילים שעומדים בבסיסם, כל עוד שני המאפיינים הוגדרו כראוי בתור ReferencedAutomationTypes
בהגדרות של האפליקציה. לדוגמה, אם מכשיר DimmableLightDeviceType
נמצא במבנה והמפתח רשם גם את המאפיינים LevelControlTrait
וגם את המאפיינים BrightnessTrait
, Discovery API יציין את נוכחותם של שני המאפיינים. המפתח יכול לבחור להשתמש בכל אחד מהמאפיינים האלה בתהליך האוטומציה.
מידע נוסף זמין במאמר הגדרת דף הבית.