دليل سخّانات المنازل المزوّدة بأجهزة ذكية

action.devices.types.BOILER : يمكن تشغيل أجهزة تدفئة المياه وإيقافها، وقد تتيح تعديل درجة الحرارة.

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

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

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

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

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

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

مثال على جهاز: سخّان بسيط

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

مثال على استجابة SYNC

Request
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
Response
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.BOILER",
        "traits": [
          "action.devices.traits.TemperatureControl",
          "action.devices.traits.OnOff"
        ],
        "name": {
          "name": "Simple boiler"
        },
        "willReportState": true,
        "attributes": {
          "temperatureRange": {
            "minThresholdCelsius": 10,
            "maxThresholdCelsius": 50
          },
          "temperatureUnitForUX": "F"
        },
        "deviceInfo": {
          "manufacturer": "smart-home-inc",
          "model": "hs1234",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        }
      }
    ]
  }
}

مثال على استجابة QUERY

Request
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
Response
{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "on": true,
        "temperatureSetpointCelsius": 35
      }
    }
  }
}

أمثلة على أوامر EXECUTE

SetTemperature

لمزيد من التفاصيل حول مَعلمات الأمر، اطّلِع على action.devices.traits.TemperatureControl مرجع.

Request
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.SetTemperature",
                "params": {
                  "temperature": 40
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Response
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "temperatureSetpointCelsius": 40
        }
      }
    ]
  }
}

OnOff

لمزيد من التفاصيل حول مَعلمات الأمر، اطّلِع على action.devices.traits.OnOff مرجع.

Request
{
  "requestId": "6894439706274654518",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.OnOff",
                "params": {
                  "on": true
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Response
{
  "requestId": "6894439706274654518",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "on": true
        }
      }
    ]
  }
}

أخطاء الجهاز

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