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