دليل شاحن المنزل الذكي
action.devices.types.CHARGER
- قد تشمل التفاعلات مع أجهزة الشحن بدء الشحن وإيقافه والتحقّق من مستوى الشحن الحالي والسعة المتبقية والسعة حتى القيم الكاملة.
يشير هذا النوع إلى حصول الجهاز على رمز الشاحن وبعض المرادفات والأسماء المستعارة ذات الصلة.
إمكانات الجهاز
ارجع إلى وثائق السمات المقابلة للحصول على تفاصيل التنفيذ، مثل السمات والحالات التي يجب أن تدعمها خدمتك، وكيفية إنشاء ردود EXECUTE وQUERY.
السمات المطلوبة
هذه السمات والأوامر مطلوبة، إذا كانت منطبقة على جهازك.
متطلبات الجودة
- وقت الاستجابة: يجب أن يكون أقل من أو يساوي 800 مللي ثانية.
- الموثوقية: يجب أن تكون أكبر من أو تساوي 97%.
مثال على جهاز: شاحن بسيط
يتضمّن هذا القسم أمثلة عن حمولات نيّة تمثّل "شاحنًا" شائعًا استنادًا إلى نوع الجهاز والسمات المذكورة أعلاه. في حال إضافة سمات أو إزالتها في عملية التنفيذ، عدِّل ردودك وفقًا لذلك لتعكس هذه التغييرات.
نموذج استجابة SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.CHARGER", "traits": [ "action.devices.traits.EnergyStorage" ], "name": { "name": "Simple charger" }, "willReportState": true, "attributes": { "isRechargeable": true, "queryOnlyEnergyStorage": false }, "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, "descriptiveCapacityRemaining": "MEDIUM", "capacityRemaining": [ { "unit": "PERCENTAGE", "rawValue": 50 } ], "capacityUntilFull": [ { "unit": "SECONDS", "rawValue": 3600 } ], "isCharging": true } } } }
نماذج أوامر EXECUTE
تحميل نفقات
للحصول على تفاصيل إضافية عن معلّمات الأوامر، راجِع مرجع
action.devices.traits.EnergyStorage
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.Charge", "params": { "charge": false } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "capacityRemaining": [ { "unit": "PERCENTAGE", "rawValue": 50 } ], "isCharging": false } } ] } }