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

action.devices.types.SENSOR - يمكن أن يؤدي جهاز استشعار واحد وظائف متعددة، مثل رصد درجة الحرارة والرطوبة أو درجة الحرارة ومعدّل الإشغال. قد تُبلِغ أجهزة الاستشعار عن قيمة الكمية أو كليهما، مثل مستوى أول أكسيد الكربون والدخان الذي يتم قياسه بالأجزاء في المليون، بالإضافة إلى المقاييس النوعية مثل ما إذا كانت جودة الهواء صحية أو غير صحية.

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

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

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

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

قد تستخدم أدوات الاستشعار أيضًا سمات أخرى تغطي البيانات التي يمكنها الإبلاغ عنها، مثل:

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

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

مثال على الجهاز: أداة استشعار بسيطة

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

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

طلب
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
الرد
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.SENSOR",
        "traits": [
          "action.devices.traits.EnergyStorage",
          "action.devices.traits.SensorState"
        ],
        "name": {
          "name": "Simple sensor"
        },
        "willReportState": true,
        "attributes": {
          "sensorStatesSupported": [
            {
              "name": "AirQuality",
              "descriptiveCapabilities": {
                "availableStates": [
                  "healthy",
                  "moderate",
                  "unhealthy",
                  "very unhealthy"
                ]
              }
            }
          ],
          "queryOnlyEnergyStorage": 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,
        "currentSensorStateData": [
          {
            "name": "AirQuality",
            "currentSensorState": "healthy"
          }
        ],
        "descriptiveCapacityRemaining": "HIGH",
        "capacityRemaining": [
          {
            "unit": "PERCENTAGE",
            "rawValue": 90
          }
        ]
      }
    }
  }
}

أخطاء الجهاز

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