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

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

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

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

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