مخطّط سمة إعداد نسبة الرطوبة في المنزل الذكي
action.devices.traits.HumiditySetting
: تنتمي هذه السمة إلى الأجهزة المتوافقة مع إعدادات الرطوبة، مثل أجهزة ترطيب الهواء وأجهزة إزالة الرطوبة.
الجهاز ATTRIBUTES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات حول التعامل مع إجراءات SYNC
، يُرجى الاطّلاع على تنفيذ الإجراء.
السمات | النوع | الوصف |
---|---|---|
humiditySetpointRange |
العنصر |
يحتوي على الحد الأدنى والأقصى لمستويات الرطوبة كنسب مئوية. |
minPercent |
عدد صحيح |
(القيمة التلقائية: تمثّل هذه الخاصية الحد الأدنى لمستوى الرطوبة كنسبة مئوية. |
maxPercent |
عدد صحيح |
(القيمة التلقائية: تمثّل هذه الخاصية الحد الأقصى لمستوى الرطوبة كنسبة مئوية. |
commandOnlyHumiditySetting |
منطقي |
(القيمة التلقائية: تشير إلى ما إذا كان الجهاز يتيح استخدام اتصال أحادي الاتجاه (صحيح) أو ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا تعذّر على الجهاز الرد على طلب QUERY أو حالة التقرير لهذه السمة. |
queryOnlyHumiditySetting |
منطقي |
(القيمة التلقائية: مطلوبة إذا كان الجهاز يوفر التنفيذ باستخدام طلب البحث فقط. تشير هذه السمة إلى إمكانية طلب الجهاز للحصول على معلومات الحالة فقط، ولا يمكن التحكّم فيها. |
أمثلة
الجهاز الذي يتيح نطاق الرطوبة التلقائي
{}
الجهاز الذي يتيح نطاقًا مخصصًا للرطوبة
{ "humiditySetpointRange": { "minPercent": 25, "maxPercent": 75 } }
حالة الجهاز STATES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن الحالات
التالية كجزء من عملية QUERY
. لمزيد من المعلومات حول التعامل مع إجراءات QUERY
، يُرجى الاطّلاع على تنفيذ الإجراء.
الولايات | النوع | الوصف |
---|---|---|
humiditySetpointPercent |
عدد صحيح |
يشير إلى نسبة الرطوبة المستهدفة الحالية للجهاز. يجب أن تقع ضمن |
humidityAmbientPercent |
عدد صحيح |
يشير إلى نسبة الرطوبة المحيطة في الجهاز حاليًا كنسبة مئوية. |
أمثلة
ما هو مستوى الرطوبة الذي يعرضه جهازي؟
{ "humiditySetpointPercent": 20, "humidityAmbientPercent": 15 }
مفاتيح COMMAND
قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر
التالية كجزء من عملية EXECUTE
. لمزيد من المعلومات حول التعامل مع إجراءات EXECUTE
، يُرجى الاطّلاع على تنفيذ الإجراء.
action.devices.commands.SetHumidity
اضبط مستوى الرطوبة على قيمة مطلقة.
المَعلمات
المَعلمات | النوع | الوصف |
---|---|---|
humidity |
عدد صحيح |
مطلوبة. نسبة الرطوبة. يجب أن تقع ضمن |
أمثلة
ضبط نسبة الرطوبة على 20 في المئة
{ "command": "action.devices.commands.SetHumidity", "params": { "humidity": 20 } }
الأخطاء ذات الصلة
حدث خطأ أثناء إعداد الرطوبة المستهدفة.
القيم المسموح بها:
maxSettingReached
minSettingReached
valueOutOfRange
action.devices.commands.HumidityRelative
اضبط مستوى الرطوبة بالنسبة إلى القيمة الحالية.
يتطلب هذا الأمر السمات التالية:{ "commandOnlyHumiditySetting": true }
المَعلمات
تحتوي الحمولة على واحد مما يلي:
ضبط نسبة الرطوبة.
المَعلمات | النوع | الوصف |
---|---|---|
humidityRelativePercent |
عدد صحيح |
مطلوبة. قيمة النسبة المئوية لضبط مستوى الرطوبة. |
اضبط رطوبة الجهاز.
المَعلمات | النوع | الوصف |
---|---|---|
humidityRelativeWeight |
عدد صحيح |
مطلوبة. يشير هذا المصطلح إلى تغيّر مستوى الرطوبة المبكّر من مبلغ صغير ("صغير") إلى مقدار كبير ("كمية كبيرة"). |
أمثلة
زيادة نسبة الرطوبة بنسبة 10%
{ "command": "action.devices.commands.HumidityRelative", "params": { "humidityRelativePercent": 10 } }
تقليل نسبة الرطوبة كثيرًا
{ "command": "action.devices.commands.HumidityRelative", "params": { "humidityRelativeWeight": -5 } }
الأخطاء ذات الصلة
حدث خطأ أثناء تعديل الرطوبة.
القيم المسموح بها:
maxSettingReached
minSettingReached
valueOutOfRange