دليل ترطيب الهواء للمنازل المزوّدة بأجهزة ذكية

action.devices.types.HUMIDIFIER: أجهزة ترطيب الهواء هي أجهزة تضيف الرطوبة إلى الهواء. يمكن تفعيل هذه الميزة وإيقافها، والإبلاغ عن الرطوبة المستهدفة وضبطها، وقد تتوفّر أوضاع مختلفة للضبط أو إعدادات سرعة المروحة.

يشير هذا النوع إلى أنّ الجهاز يحصل على رمز "جهاز ترطيب الهواء" وبعض المرادفات ذات الصلة والأسماء المستعارة.

إمكانات الجهاز

يُرجى الرجوع إلى مستندات السمات المرتبطة للحصول على تفاصيل التنفيذ، مثل السمات والحالة التي يجب أن تدعمها خدمتك، وكيفية إنشاء ردود EXECUTE وQUERY.

السمات المطلوبة

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

ننصحك باستخدام هذه السمات على جهازك، إذا كانت منطبقة. ومع ذلك، يمكنك الاختيار من بين جميع السمات المتاحة لك ومطابقتها مع وظائف منتجاتك الحالية على أفضل نحو.

متطلبات الجودة

  • وقت الاستجابة: يجب أن يكون أقل من أو يساوي 1000 ملي ثانية.
  • الموثوقية: يجب أن تكون أكبر من أو تساوي 97%.

مثال على جهاز: جهاز ترطيب الهواء بسيط

يتضمّن هذا القسم أمثلة على أحمال نيّة تمثّل "مرطب" شائعًا استنادًا إلى نوع الجهاز وسماته أعلاه. في حال إضافة سمات أو إزالتها في عملية التنفيذ، عدِّل ردودك وفقًا لذلك لتعكس هذه التغييرات.

نموذج استجابة المزامنة

طلب
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
الرد
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.HUMIDIFIER",
        "traits": [
          "action.devices.traits.FanSpeed",
          "action.devices.traits.HumiditySetting",
          "action.devices.traits.OnOff"
        ],
        "name": {
          "name": "Simple humidifier"
        },
        "willReportState": true,
        "attributes": {
          "humiditySetpointRange": {
            "minPercent": 30,
            "maxPercent": 100
          },
          "availableFanSpeeds": {
            "speeds": [
              {
                "speed_name": "low_key",
                "speed_values": [
                  {
                    "speed_synonym": [
                      "Low",
                      "Slow"
                    ],
                    "lang": "en"
                  },
                  {
                    "speed_synonym": [
                      "Niedrig",
                      "Schleppend"
                    ],
                    "lang": "de"
                  }
                ]
              },
              {
                "speed_name": "high_key",
                "speed_values": [
                  {
                    "speed_synonym": [
                      "High"
                    ],
                    "lang": "en"
                  },
                  {
                    "speed_synonym": [
                      "Hoch"
                    ],
                    "lang": "de"
                  }
                ]
              }
            ],
            "ordered": true
          }
        },
        "deviceInfo": {
          "manufacturer": "smart-home-inc",
          "model": "hs1234",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        }
      }
    ]
  }
}

نموذج ردّ QUERY

طلب
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
الرد
{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "on": true,
        "currentFanSpeedSetting": "low_key",
        "humiditySetpointPercent": 50,
        "humidityAmbientPercent": 40
      }
    }
  }
}

نماذج أوامر EXECUTE

ضبط السرعة

للحصول على تفاصيل إضافية عن معلَمات الأوامر، يُرجى الاطّلاع على مرجع action.devices.traits.FanSpeed.

طلب
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.SetFanSpeed",
                "params": {
                  "fanSpeed": "high_key"
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
الرد
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "currentFanSpeedSetting": "high_key"
        }
      }
    ]
  }
}

ضبط الرطوبة

للحصول على تفاصيل إضافية عن معلَمات الأوامر، يُرجى الاطّلاع على مرجع action.devices.traits.HumiditySetting.

طلب
{
  "requestId": "6894439706274654518",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.SetHumidity",
                "params": {
                  "humidity": 60
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
الرد
{
  "requestId": "6894439706274654518",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "humiditySetpointPercent": 60,
          "humidityAmbientPercent": 40
        }
      }
    ]
  }
}

غير مفعّل

للحصول على تفاصيل إضافية عن معلَمات الأوامر، يُرجى الاطّلاع على مرجع action.devices.traits.OnOff.

طلب
{
  "requestId": "6894439706274654520",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.OnOff",
                "params": {
                  "on": true
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
الرد
{
  "requestId": "6894439706274654520",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "on": true
        }
      }
    ]
  }
}

أخطاء الجهاز

راجِع القائمة الكاملة للأخطاء والاستثناءات.