مخطّط سمة إعداد نسبة الرطوبة في المنزل الذكي

action.devices.traits.HumiditySetting: تنتمي هذه السمة إلى الأجهزة المتوافقة مع إعدادات الرطوبة، مثل أجهزة ترطيب الهواء وأجهزة إزالة الرطوبة.

الجهاز ATTRIBUTES

ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن السمات التالية كجزء من عملية SYNC. لمزيد من المعلومات حول التعامل مع إجراءات SYNC، يُرجى الاطّلاع على تنفيذ الإجراء.

السمات	النوع	الوصف
humiditySetpointRange	العنصر	يحتوي على الحد الأدنى والأقصى لمستويات الرطوبة كنسب مئوية.
minPercent	عدد صحيح	(القيمة التلقائية: 0) تمثّل هذه الخاصية الحد الأدنى لمستوى الرطوبة كنسبة مئوية.
maxPercent	عدد صحيح	(القيمة التلقائية: 100) تمثّل هذه الخاصية الحد الأقصى لمستوى الرطوبة كنسبة مئوية.
commandOnlyHumiditySetting	منطقي	(القيمة التلقائية: false) تشير إلى ما إذا كان الجهاز يتيح استخدام اتصال أحادي الاتجاه (صحيح) أو ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا تعذّر على الجهاز الرد على طلب QUERY أو حالة التقرير لهذه السمة.
queryOnlyHumiditySetting	منطقي	(القيمة التلقائية: false) مطلوبة إذا كان الجهاز يوفر التنفيذ باستخدام طلب البحث فقط. تشير هذه السمة إلى إمكانية طلب الجهاز للحصول على معلومات الحالة فقط، ولا يمكن التحكّم فيها.

أمثلة

الجهاز الذي يتيح نطاق الرطوبة التلقائي

{}

الجهاز الذي يتيح نطاقًا مخصصًا للرطوبة

{
  "humiditySetpointRange": {
    "minPercent": 25,
    "maxPercent": 75
  }
}

حالة الجهاز STATES

ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن الحالات التالية كجزء من عملية QUERY. لمزيد من المعلومات حول التعامل مع إجراءات QUERY، يُرجى الاطّلاع على تنفيذ الإجراء.

الولايات	النوع	الوصف
humiditySetpointPercent	عدد صحيح	يشير إلى نسبة الرطوبة المستهدفة الحالية للجهاز. يجب أن تقع ضمن humiditySetpointRange.
humidityAmbientPercent	عدد صحيح	يشير إلى نسبة الرطوبة المحيطة في الجهاز حاليًا كنسبة مئوية.

أمثلة

ما هو مستوى الرطوبة الذي يعرضه جهازي؟

{
  "humiditySetpointPercent": 20,
  "humidityAmbientPercent": 15
}

مفاتيح COMMAND

قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر التالية كجزء من عملية EXECUTE. لمزيد من المعلومات حول التعامل مع إجراءات EXECUTE، يُرجى الاطّلاع على تنفيذ الإجراء.

action.devices.commands.SetHumidity

اضبط مستوى الرطوبة على قيمة مطلقة.

المَعلمات

المَعلمات	النوع	الوصف
humidity	عدد صحيح	مطلوبة. نسبة الرطوبة. يجب أن تقع ضمن humiditySetpointRange.

أمثلة

ضبط نسبة الرطوبة على 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

أخطاء الجهاز

يمكنك الاطلاع على القائمة الكاملة للأخطاء والاستثناءات.