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

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

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