برای سهولت استفاده، نسخههای سادهشده برخیاز ویژگیها برای استفاده با 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 وجود هر دو ویژگی را نشان میدهد. توسعهدهنده میتواند انتخاب کند که از کدام ویژگی در خودکارسازیاش استفاده کند.
برای اطلاعات بیشتر، پیکربندی Home را ببینید.