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

action.devices.types.FREEZER - المجمدات هي أجهزة لإدارة درجة الحرارة يمكن ضبطها حسب إعدادات الأوضاع المختلفة، وقد تسمح بمراقبة درجة الحرارة.

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

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

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

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

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

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

  • وقت الاستجابة: يجب أن يكون أقل من 3000 ملي ثانية أو يساويها.
  • الموثوقية: يجب أن تزيد عن 97% أو تساويها.

مثال على الجهاز: ثلاجة بسيطة

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

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

طلب
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
الرد
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.FREEZER",
        "traits": [
          "action.devices.traits.TemperatureControl"
        ],
        "name": {
          "name": "Simple freezer"
        },
        "willReportState": true,
        "attributes": {
          "temperatureRange": {
            "minThresholdCelsius": -10,
            "maxThresholdCelsius": 5
          },
          "temperatureUnitForUX": "C"
        },
        "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,
        "temperatureSetpointCelsius": 0,
        "temperatureAmbientCelsius": 2
      }
    }
  }
}

نموذج أوامر EXECUTE

SetTemperature

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

طلب
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.SetTemperature",
                "params": {
                  "temperature": 0
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
الرد
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "temperatureSetpointCelsius": 0,
          "temperatureAmbientCelsius": 2
        }
      }
    ]
  }
}

أخطاء الجهاز

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