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