ویژگی های ساده شده در iOS

برای سهولت استفاده، نسخه‌های ساده‌شده‌ای از برخی ویژگی‌ها برای استفاده با 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

ویژگی‌های ساده‌شده و رابط برنامه‌نویسی کاربردی اکتشاف

API دیسکاوری، ویژگی‌های ساده‌شده و همچنین ویژگی‌های استاندارد زیربنایی آن‌ها را گزارش می‌دهد، البته تا زمانی که هر دو ویژگی به درستی به عنوان ReferencedAutomationTypes در پیکربندی برنامه شما پیکربندی شده باشند. به عنوان مثال، اگر یک دستگاه DimmableLightDeviceType در ساختار وجود داشته باشد و توسعه‌دهنده هر دو ویژگی LevelControlTrait و BrightnessTrait را ثبت کرده باشد، API دیسکاوری وجود هر دو ویژگی را نشان می‌دهد. توسعه‌دهنده می‌تواند از هر یک از این ویژگی‌ها در اتوماسیون خود استفاده کند.

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