מאפיינים פשוטים יותר ב-iOS

כדי להקל על השימוש, יש גרסאות פשוטות של חלק מהמאפיינים שאפשר להשתמש בהן עם 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	LevelControlTrait OnOffTrait

תכונות פשוטות ו-Discovery API

ה-Discovery API מדווח על מאפיינים פשוטים וגם על מאפייני הבסיס שלהם, כל עוד שני המאפיינים הוגדרו בצורה נכונה כ-ReferencedAutomationTypes בהגדרה של האפליקציה. לדוגמה, אם מכשיר DimmableLightDeviceType נמצא במבנה, והמפתח רשם את המאפיינים LevelControlTrait ו-BrightnessTrait, ה-Discovery API יציין את הנוכחות של שני המאפיינים. המפתחים יכולים לבחור להשתמש בכל אחת מהתכונות האלה באוטומציה שלהם.

מידע נוסף זמין במאמר בנושא הגדרת הבית.