لتسهيل الاستخدام، تتوفّر إصدارات مبسطة من بعض السمات لاستخدامها مع Automation API على أجهزة iOS.
تمثّل السمة المبسّطة سمة عادية في Home API، على غرار طريقة عمل نمط الواجهة. توفّر السمات المبسّطة أوامر تسهّل تنفيذ المهام الشائعة لأنواع معيّنة من الأجهزة. السمات المبسّطة هي سمات Home API، وهي تعمل مع أجهزة Matter وCloud-to-cloud، تمامًا مثل سمات Home API الأخرى.
تقدّم السمة المبسّطة مجموعة فرعية بديلة من السمات والأوامر تكون أكثر ملاءمة للجهاز من تلك الخاصة بالسمة العادية المقابلة.
على سبيل المثال، السمة القياسية
LevelControlTrait
هي سمة عامة يمكن استخدامها مع أي جهاز يتضمّن
إعدادًا يتغيّر باستمرار ضمن مجموعة من القيم الرقمية.
BrightnessTrait هي سمة مبسطة تحل محل LevelControlTrait وتوفّر فقط الأوامر والسمات التي يتطلبها جهاز DimmableLightDeviceType. يحتوي BrightnessTrait على الأمر
moveToBrightness الذي يقبل وسيطة brightnessPercent واحدة، بينما يحتوي
LevelControlTrait على أوامر move متعددة، معظمها يتضمّن أربع مَعلمات على الأقل لاستيعاب مجموعة أكبر من حالات الاستخدام.
يوضّح الجدول التالي كل سمة مبسطة والسمات الأساسية المعيارية. يرتبط كل اسم سمة بمستندات واجهة برمجة التطبيقات ذات الصلة:
| السمة المبسّطة | السمة العادية |
|---|---|
SimplifiedThermostatTrait
|
ThermostatTrait
|
BrightnessTrait
|
LevelControlTrait
|
SimplifiedOnOffTrait
|
OnOffTrait
|
VolumeTrait
|
LevelControlTraitOnOffTrait
|
السمات المبسّطة وDiscovery API
تعرض Discovery API السمات المبسّطة بالإضافة إلى السمات الأساسية المعيارية، طالما تم ضبط كلتا السمتين بشكل صحيح على ReferencedAutomationTypes في إعدادات تطبيقك. على سبيل المثال، إذا كان جهاز DimmableLightDeviceType متوفّرًا في البنية، وسجّل المطوّر السمتين LevelControlTrait وBrightnessTrait، ستشير Discovery API إلى توفّر كلتا السمتين. يمكن للمطوّر اختيار استخدام أيّ من السمتَين في عملية التشغيل الآلي.
يمكنك الاطّلاع على إعدادات الصفحة الرئيسية لمزيد من المعلومات.