دليل مشاهد المنزل الذكي
action.devices.types.SCENE: في حالة المشاهد، يتطابق النوع مع السمة بنسبة 1:1، لأنّ المشاهد لا تتضمّن سمات أخرى لتشكيل أجهزة مركّبة. يجب أن تتضمّن المشاهد دائمًا أسماء يقدّمها المستخدم. كل مشهد هو جهاز افتراضي مستقل، وله أسماؤه الخاصة.
يشير هذا النوع إلى أنّ الجهاز يحصل على رمز المشهد وبعض المرادفات والأسماء المستعارة ذات الصلة.
لمزيد من المعلومات، يُرجى الاطّلاع على سمة "مشهد".
إمكانات الجهاز
راجِع مستندات السمة ذات الصلة للحصول على تفاصيل التنفيذ، مثل السمات والحالات التي يجب أن تدعمها خدمتك، وكيفية إنشاء ردود EXECUTE وQUERY.
السمات المطلوبة
هذه السمات والأوامر مطلوبة إذا كانت تنطبق على جهازك. إذا كان جهازك لا يتوافق مع هذه السمات، أدخِل رمز الخطأ
functionNotSupported في رد QUERY أو EXECUTE. يمكنك الاطّلاع على الأخطاء والاستثناءات لمزيد من المعلومات.
مثال على الجهاز: مشهد بسيط
يحتوي هذا القسم على أمثلة على حمولات الأهداف التي تمثّل "مشهدًا" شائعًا استنادًا إلى نوع الجهاز والسمات المذكورة أعلاه. في حال إضافة سمات أو إزالتها في عملية التنفيذ، يجب تعديل الردود وفقًا لذلك لعكس هذه التغييرات.
نموذج استجابة SYNC
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.SCENE", "traits": [ "action.devices.traits.Scene" ], "name": { "name": "Simple scene" }, "willReportState": true, "attributes": { "sceneReversible": 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 } } } }
أمثلة على أوامر EXECUTE
ActivateScene
للحصول على تفاصيل إضافية حول معلَمات الأمر، راجِع
مرجع action.devices.traits.Scene.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true } } ] } }