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

برای اطلاعات بیشتر به پیکربندی صفحه اصلی مراجعه کنید.