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

action.devices.types.CARBON_MONOXIDE_DETECTOR - قد تُبلغ أجهزة رصد أول أكسيد الكربون عما إذا كان يتم رصد أول أكسيد الكربون حاليًا، وما إذا كان مستوى أول أكسيد الكربون مرتفعًا، ومستوى أول أكسيد الكربون الحالي بالأجزاء في المليون.

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

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

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

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

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

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

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

مثال على الجهاز: جهاز بسيط لرصد أول أكسيد الكربون

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

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

الطلبالردّ
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
 
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.CARBON_MONOXIDE_DETECTOR",
        "traits": [
          "action.devices.traits.SensorState"
        ],
        "name": {
          "name": "Simple carbon monoxide detector"
        },
        "willReportState": true,
        "attributes": {
          "sensorStatesSupported": [
            {
              "name": "CarbonMonoxideLevel",
              "descriptiveCapabilities": {
                "availableStates": [
                  "carbon monoxide detected",
                  "high",
                  "no carbon monoxide detected"
                ]
              },
              "numericCapabilities": {
                "rawValueUnit": "PARTS_PER_MILLION"
              }
            }
          ]
        },
        "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,
        "currentSensorStateData": [
          {
            "name": "CarbonMonoxideLevel",
            "currentSensorState": "high",
            "rawValue": 200
          }
        ]
      }
    }
  }
}

أخطاء الجهاز

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