دليل المجمّد الذكي للأجهزة المنزلية
action.devices.types.FREEZER
- المجمّدات هي أجهزة تُستخدَم لإدارة درجة الحرارة وقد يتم ضبطها على عدة إعدادات، وقد تسمح بمراقبة درجة الحرارة.
يشير هذا النوع إلى حصول الجهاز على رمز المجمّد وبعض المرادفات والأسماء المستعارة ذات الصلة.
إمكانات الجهاز
ارجع إلى وثائق السمات المقابلة للحصول على تفاصيل التنفيذ، مثل السمات والحالات التي يجب أن تدعمها خدمتك، وكيفية إنشاء ردود EXECUTE وQUERY.
السمات المطلوبة
هذه السمات والأوامر مطلوبة، إذا كانت منطبقة على جهازك.
متطلبات الجودة
- وقت الاستجابة: يجب أن يكون أقل من أو يساوي 3000 ملي ثانية.
- الموثوقية: يجب أن تكون أكبر من أو تساوي 97%.
مثال على جهاز: ثلاجة بسيطة
يتضمّن هذا القسم أمثلة عن حمولات نيّة تمثّل "جمّدًا" شائعًا استنادًا إلى نوع الجهاز والسمات المذكورة أعلاه. في حال إضافة سمات أو إزالتها في عملية التنفيذ، عدِّل ردودك وفقًا لذلك لتعكس هذه التغييرات.
نموذج استجابة SYNC
{ "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
ضبط درجة الحرارة
للحصول على تفاصيل إضافية عن معلّمات الأوامر، راجِع مرجع
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 } } ] } }