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

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

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

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