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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

لتسهيل الاستخدام، تتوفّر إصدارات مبسّطة من بعض السمات لاستخدامها مع 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	LevelControlTrait OnOffTrait

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

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

اطّلِع على إعدادات Home للحصول على مزيد من المعلومات.