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