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