السمات المبسّطة على أجهزة iOS

لتسهيل الاستخدام، تتوفّر إصدارات مبسطة من بعض السمات لاستخدامها مع Automation API على أجهزة iOS.

تمثّل السمة المبسّطة سمة عادية في Home API، على غرار طريقة عمل نمط الواجهة . توفّر السمات المبسّطة أوامر تسهّل تنفيذ المهام الشائعة لأنواع معيّنة من الأجهزة. السمات المبسّطة هي سمات Home API، وعلى غرار سمات Home API الأخرى، تعمل مع أجهزة Matter وأجهزة Cloud-to-cloud.

توفّر السمة المبسّطة مجموعة فرعية بديلة من السمات والأوامر تكون أكثر ملاءمة لنوع الجهاز من تلك الخاصة بالسمة العادية المقابلة. على سبيل المثال، السمة العادية LevelControlTrait هي سمة عامة يمكن استخدامها لأي جهاز يتضمّن إعدادًا يتغيّر باستمرار ضمن نطاق من القيم الرقمية. BrightnessTrait هي سمة مبسّطة تحلّ محلّ LevelControlTrait وتوفّر الأوامر والسمات التي يتطلّبها جهاز DimmableLightDeviceType فقط. BrightnessTrait تتضمّن moveToBrightness الأمر الذي يأخذ وسيطة واحدة هي brightnessPercent، بينما تتضمّن LevelControlTrait عدة أوامر move، يتضمّن معظمها أربع مَعلمات على الأقل لاستيعاب نطاق أوسع من حالات الاستخدام.

يعرض الجدول التالي كل سمة مبسّطة والسمات العادية الأساسية: يرتبط كل اسم سمة بمستندات واجهة برمجة التطبيقات المقابلة:

الجدول: السمات المبسّطة

السمة المبسّطة	السمة العادية
SimplifiedThermostatTrait	ThermostatTrait
BrightnessTrait	LevelControlTrait
SimplifiedOnOffTrait	OnOffTrait
VolumeTrait	LevelControlTrait OnOffTrait

السمات المبسّطة وDiscovery API

تعرض Discovery API السمات المبسّطة وسماتها العادية الأساسية، طالما تم ضبط كلتا السمتَين بشكلٍ صحيح على أنّهما ReferencedAutomationTypes في إعدادات تطبيقك. على سبيل المثال، إذا كان هناك جهاز DimmableLightDeviceType في البنية، وسجّل المطوّر سمتَي LevelControlTrait وBrightnessTrait، ستشير Discovery API إلى توفّر كلتا السمتَين. يمكن للمطوّر اختيار استخدام أيّ من السمتَين في التشغيل الآلي.

لمزيد من المعلومات، يُرجى الاطّلاع على إعدادات المنزل.