السمات المبسّطة على أجهزة 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 إلى توفّر كلتا السمتَين. ويمكن للمطوّر اختيار استخدام أيّ من السمتَين في عملية التشغيل الآلي.

لمزيد من المعلومات، يُرجى الاطّلاع على إعدادات الصفحة الرئيسية.