مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

أخطاء الجهاز

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