السمات المبسّطة على Android

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

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

تقدّم السمة المبسّطة مجموعة فرعية بديلة من السمات والأوامر تكون أكثر تحديدًا للجهاز من تلك الخاصة بالسمة العادية المقابلة. على سبيل المثال، السمة القياسية LevelControl هي سمة عامة يمكن استخدامها مع أي جهاز يتضمّن إعدادًا يتغيّر باستمرار ضمن مجموعة من القيم الرقمية. ‫Brightness هي سمة مبسطة تحلّ محل LevelControl وتوفّر فقط الأوامر والسمات التي يتطلّبها جهاز DimmableLight. يحتوي Brightness على الأمر moveToBrightness الذي يتضمّن وسيطة brightnessPercent واحدة، بينما يحتوي LevelControl على أوامر move متعددة، معظمها يتضمّن أربع مَعلمات على الأقل لاستيعاب مجموعة أكبر من حالات الاستخدام.

يوضّح الجدول التالي كل سمة مبسطة والسمات الأساسية المعيارية. يرتبط كل اسم سمة بمستندات واجهة برمجة التطبيقات المقابلة:

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

تعرض Discovery API السمات المبسّطة بالإضافة إلى السمات العادية الأساسية، شرط أن تكون كلتا السمتَين مسجّلتَين في FactoryRegistry. على سبيل المثال، إذا كان هناك جهاز DimmableLight في البنية، وسجّل المطوّر السمتَين LevelControl وBrightness في FactoryRegistry، ستشير Discovery API إلى توفّر السمتَين. يمكن للمطوّر اختيار استخدام أيّ من السمتين في عملية التشغيل الآلي.

يمكنك الاطّلاع على Discovery API على Android لمزيد من المعلومات.

استرداد جهاز يتوافق مع سمة مبسطة

عند استخدام Device API للحصول على أجهزة في بنية تتوافق مع سمة مبسطة مثل SimplifiedThermostat، لا يمكنك استخدام طريقة has(trait). استخدِم طريقة has(deviceType) بدلاً من ذلك:

val thermostat = home.devices().list().first { device -> device.has(ThermostatDevice) }