دليل أجهزة الاستشعار في المنزل الذكي
action.devices.types.SENSOR - يمكن لجهاز استشعار واحد أن يؤدي وظائف متعددة، مثل مراقبة درجة الحرارة والرطوبة. قد تُبلغ أجهزة الاستشعار عن قياسات كمية (مثل مستوى أول أكسيد الكربون والدخان الذي يتم قياسه بأجزاء في المليون) أو قياسات نوعية (مثل ما إذا كانت جودة الهواء صحية أو غير صحية) أو كليهما.
يشير هذا النوع إلى أنّ الجهاز يحصل على رمز "المستشعر" وبعض المرادفات والأسماء المستعارة ذات الصلة.
إمكانيات الجهاز
راجِع مستندات السمة ذات الصلة للاطّلاع على تفاصيل التنفيذ، مثل السمات والحالات التي يجب أن تدعمها خدمتك، وكيفية إنشاء ردود EXECUTE وQUERY.
السمات المقترَحة
يُنصح باستخدام هذه السمات إذا كانت تنطبق على جهازك. ومع ذلك، يمكنك المزج بين جميع السمات المتاحة ومطابقتها مع بعضها البعض لتحقيق أفضل تطابق مع وظائف منتجك الحالية.
قد تستخدم أجهزة الاستشعار أيضًا سمات أخرى تغطي البيانات التي يمكنها إعداد تقارير عنها، مثل:
- HumiditySetting
- OpenClose
- TemperatureControl: تُستخدَم لقياس درجات الحرارة غير المرتبطة بالمناخ (مثل درجة حرارة المياه أو السطح أو الأجهزة).
- TemperatureSetting: تُستخدَم لدرجات حرارة المناخ (الهواء المحيط).
مثال على جهاز: أداة استشعار بسيطة
يحتوي هذا القسم على أمثلة على حمولات الأهداف التي تمثّل "جهاز استشعار" شائعًا استنادًا إلى نوع الجهاز وسماته المذكورة أعلاه. في حال إضافة سمات أو إزالتها في عملية التنفيذ، عدِّل الردود وفقًا لذلك لعكس هذه التغييرات.
نموذج استجابة SYNC
{
"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.OccupancySensing", "action.devices.traits.SensorState" ], "name": { "name": "Simple sensor" }, "willReportState": true, "attributes": { "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ], "queryOnlyEnergyStorage": true, "occupancySensorConfiguration": [ { "occupancySensorType": "PIR", "occupiedToUnoccupiedDelaySec": 10, "unoccupiedToOccupiedDelaySec": 10, "unoccupiedToOccupiedEventThreshold": 2 } ] }, "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 } ], "occupancy": "OCCUPIED" } } } }