دليل القلايات المنزلية الذكية
action.devices.types.FRYER - قد تشمل التفاعلات مع القلايات بدء تشغيلها وإيقافها، أو ضبط موقّت، أو ضبط أوضاع الطهي أو الإعدادات المسبقة للطعام، أو ضبط إعدادات مختلفة أخرى.
ويشير هذا النوع إلى ظهور رمز المقلاة على الجهاز وبعض المرادفات والأسماء المستعارة.
إمكانيات الجهاز
راجع وثائق السمات المقابلة تفاصيل التنفيذ، مثل السمات والحالات التي يجب أن تتيحها خدمتك، وكيفية إنشاء ردود 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.FRYER",
"traits": [
"action.devices.traits.Cook",
"action.devices.traits.StartStop",
"action.devices.traits.Timer",
"action.devices.traits.OnOff"
],
"name": {
"name": "Simple fryer"
},
"willReportState": true,
"attributes": {
"supportedCookingModes": [
"FRY"
],
"foodPresets": [
{
"food_preset_name": "french_fries_key",
"supported_units": [
"POUNDS",
"OUNCES"
],
"food_synonyms": [
{
"synonym": [
"French fries",
"Fries"
],
"lang": "en"
}
]
},
{
"food_preset_name": "hash_browns_key",
"supported_units": [
"CUPS",
"OUNCES"
],
"food_synonyms": [
{
"synonym": [
"Hash browns",
"Hash potatoes"
],
"lang": "en"
}
]
}
],
"maxTimerLimitSec": 1200,
"pausable": 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,
"on": true,
"isRunning": true,
"isPaused": false,
"timerRemainingSec": 120,
"currentCookingMode": "FRY",
"currentFoodPreset": "NONE"
}
}
}
}
نماذج أوامر التنفيذ
الطهي
للحصول على تفاصيل إضافية حول معاملات الأوامر،
عرض
action.devices.traits.Cook
المرجع.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.Cook",
"params": {
"start": false,
"cookingMode": "FRY"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentCookingMode": "NONE",
"currentFoodPreset": "NONE"
}
}
]
}
}
StartStop
للحصول على تفاصيل إضافية حول معاملات الأوامر،
عرض
action.devices.traits.StartStop
المرجع.
{
"requestId": "6894439706274654518",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.StartStop",
"params": {
"start": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654518",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"isRunning": true,
"isPaused": false
}
}
]
}
}
TimerStart
للحصول على تفاصيل إضافية حول معاملات الأوامر،
عرض
action.devices.traits.Timer
المرجع.
{
"requestId": "6894439706274654522",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerStart",
"params": {
"timerTimeSec": 120
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654522",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": 120
}
}
]
}
}
TimerAdjust
للحصول على تفاصيل إضافية حول معاملات الأوامر،
عرض
action.devices.traits.Timer
المرجع.
{
"requestId": "6894439706274654524",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerAdjust",
"params": {
"timerTimeSec": -10
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654524",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": 110
}
}
]
}
}
TimerPause
للحصول على تفاصيل إضافية حول معاملات الأوامر،
عرض
action.devices.traits.Timer
المرجع.
{
"requestId": "6894439706274654526",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerPause"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654526",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": 120,
"timerPaused": true
}
}
]
}
}
TimerResume
للحصول على تفاصيل إضافية حول معاملات الأوامر،
عرض
action.devices.traits.Timer
المرجع.
{
"requestId": "6894439706274654528",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerResume"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654528",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": 120,
"timerPaused": false
}
}
]
}
}
TimerCancel
للحصول على تفاصيل إضافية حول معاملات الأوامر،
عرض
action.devices.traits.Timer
المرجع.
{
"requestId": "6894439706274654530",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerCancel"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654530",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": -1
}
}
]
}
}
OnOff
للحصول على تفاصيل إضافية حول معاملات الأوامر،
عرض
action.devices.traits.OnOff
المرجع.
{
"requestId": "6894439706274654532",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OnOff",
"params": {
"on": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654532",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"on": true
}
}
]
}
}