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

برای اطلاعات بیشتر، پیکربندی Home را ببینید.