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

כדי להקל על השימוש, גרסאות פשוטות של חלק מהמאפיינים זמינות לשימוש עם Automation API ב-Android.

מאפיין פשוט מייצג מאפיין רגיל של Home API, בדומה לאופן הפעולה של תבנית חזיתית. תכונות פשוטות מספקות פקודות שמקלות על ביצוע משימות נפוצות בסוגים מסוימים של מכשירים. מאפיינים פשוטים הם מאפיינים של Home API, וכמו מאפיינים אחרים של Home API, הם פועלים גם במכשירי Matter וגם במכשירי Cloud-to-cloud.

מאפיין פשוט הוא קבוצת משנה חלופית של מאפיינים ופקודות, שהיא ספציפית יותר למכשיר מאשר המאפיינים והפקודות של המאפיין הרגיל המקביל. לדוגמה, מאפיין LevelControl רגיל הוא מאפיין כללי שאפשר להשתמש בו לכל מכשיר שיש לו הגדרה שמשתנה באופן רציף בטווח של ערכים מספריים. Brightness הוא מאפיין פשוט שמחליף את LevelControl ומספק רק את הפקודות והמאפיינים שמכשיר DimmableLight צריך. למאפיין Brightness יש פקודה moveToBrightness שמקבלת ארגומנט brightnessPercent יחיד, בעוד שלמאפיין LevelControl יש כמה פקודות move, שלרוב יש לפחות ארבעה פרמטרים כדי להתאים למגוון רחב יותר של תרחישי שימוש.

בטבלה הבאה מפורטים כל מאפיין פשוט ומאפייני הבסיס הרגילים. כל שם של מאפיין מקושר למאמרי העזרה של ה-API המתאימים:

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

‫Discovery API מדווח על תכונות פשוטות וגם על תכונות סטנדרטיות בסיסיות, בתנאי ששתי התכונות נרשמו ב-FactoryRegistry. לדוגמה, אם מכשיר DimmableLight נמצא במבנה, והמפתח רשם את המאפיינים LevelControl ו-Brightness ב-FactoryRegistry, ‏ Discovery API יציין את הנוכחות של שני המאפיינים. המפתח יכול לבחור להשתמש בכל אחת מהתכונות האלה באוטומציה שלו.

מידע נוסף זמין במאמר בנושא Discovery API ב-Android.

אחזור מכשיר שתומך ב-trait פשוט

כשמשתמשים ב-Device API כדי לקבל מכשירים במבנה שתומך בתכונה פשוטה כמו SimplifiedThermostat, אי אפשר להשתמש בשיטה has(trait). במקום זאת, צריך להשתמש ב-method‏ has(deviceType):

val thermostat = home.devices().list().first { device -> device.has(ThermostatDevice) }