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

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