स्मार्ट होम अवन गाइड
action.devices.types.OVEN - अवन के साथ इंटरैक्शन में, कुछ खास तापमान पर बेक करने या भूनने की क्षमता शामिल होती है. अवन के गर्म होने के दौरान, उसके अंदर का तापमान अलग-अलग होता है. इसलिए, इस पर भी नज़र रखी जा सकती है. अवन में पकाने में लगने वाला समय कम होता है, जिससे बेकिंग में ज़्यादा समय लगता है.
इस टाइप से पता चलता है कि डिवाइस को अवन आइकॉन और इससे मिलते-जुलते कुछ समानार्थी शब्द और उपनाम मिलते हैं.
ओवन में,action.devices.traits.OnOff और
action.devices.traits.TemperatureControl के लिए टाइप-आधारित व्याकरण होता है:
- अगर डिवाइस पर
OnOffकाम करता है, तो अवन को पहले से गर्म करने के लिए,action.devices.commands.OnOffनिर्देश भेजेगा. - अगर डिवाइस पर
TemperatureControlकाम करता है, तो अवन को पहले से 350 डिग्री पर गर्म कर लें. इससे आपको अवन को उस तापमान पर सेट करने का निर्देश मिलेगा.
डिवाइस की क्षमताएं
लागू करने के बारे में जानकारी के लिए, Trait से जुड़ा दस्तावेज़ देखें. जैसे, एट्रिब्यूट और यह जानकारी कि आपकी सेवा के साथ काम करना चाहिए. साथ ही, EXECUTE और QUERY रिस्पॉन्स बनाने का तरीका जानें.
ज़रूरी traits
अगर आपके डिवाइस पर लागू हो, तो ये विशेषताएं और निर्देश ज़रूरी हैं. अगर आपके डिवाइस में ये विशेषताएं काम नहीं करती हैं, तो QUERY या EXECUTE जवाब में
functionNotSupported का गड़बड़ी कोड डालें. ज़्यादा जानकारी के लिए
गड़बड़ियां और अपवाद देखें.
सुझाए गए traits
अगर आपके डिवाइस पर लागू हो, तो इन विशेषताओं के इस्तेमाल का सुझाव दिया जाता है. हालांकि, अपने मौजूदा प्रॉडक्ट की सुविधाओं को अपने हिसाब से बनाने के लिए, आपको सभी उपलब्ध विशेषताओं को एक साथ मिलाने की सुविधा मिलती है.
क्वालिटी के लिए ज़रूरी शर्तें
- इंतज़ार का समय: 3,000 मि॰से॰ या उससे कम होना चाहिए.
- भरोसेमंद: 97% से ज़्यादा या इसके बराबर होना चाहिए.
डिवाइस का उदाहरण: सादा अवन
इस सेक्शन में, ऐसे इंटेंट पेलोड के उदाहरण शामिल हैं जो सामान्य "ओवन" को दिखाते हैं. ये उदाहरण, डिवाइस के टाइप और ऊपर दी गई विशेषताओं के आधार पर होते हैं. अगर लागू करने की प्रक्रिया में कोई एट्रिब्यूट जोड़ा या हटाया जाता है, तो उन बदलावों को दिखाने के लिए अपने जवाबों में उसके हिसाब से बदलाव करें.
सिंक के जवाब का नमूना
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.OVEN",
"traits": [
"action.devices.traits.Cook",
"action.devices.traits.OnOff",
"action.devices.traits.TemperatureControl",
"action.devices.traits.Timer",
"action.devices.traits.StartStop"
],
"name": {
"name": "Simple oven"
},
"willReportState": true,
"attributes": {
"supportedCookingModes": [
"BAKE",
"CONVECTION_BAKE",
"ROAST"
],
"maxTimerLimitSec": 3600,
"temperatureRange": {
"minThresholdCelsius": 65,
"maxThresholdCelsius": 288
},
"temperatureUnitForUX": "F"
},
"deviceInfo": {
"manufacturer": "smart-home-inc",
"model": "hs1234",
"hwVersion": "3.2",
"swVersion": "11.4"
}
}
]
}
}
क्वेरी के जवाब का उदाहरण
{
"requestId": "6894439706274654514",
"inputs": [
{
"intent": "action.devices.QUERY",
"payload": {
"devices": [
{
"id": "123"
}
]
}
}
]
}
{
"requestId": "6894439706274654514",
"payload": {
"devices": {
"123": {
"status": "SUCCESS",
"online": true,
"on": true,
"isRunning": true,
"temperatureSetpointCelsius": 175,
"currentCookingMode": "BAKE",
"timerRemainingSec": -1
}
}
}
}
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": true,
"cookingMode": "ROAST"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentCookingMode": "ROAST"
}
}
]
}
}
OnOff
कमांड पैरामीटर के बारे में ज़्यादा जानकारी के लिए,
action.devices.traits.OnOff
रेफ़रंस देखें.
{
"requestId": "6894439706274654518",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OnOff",
"params": {
"on": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654518",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"on": true
}
}
]
}
}
SetTemperature
कमांड पैरामीटर के बारे में ज़्यादा जानकारी के लिए,
action.devices.traits.TemperatureControl
रेफ़रंस देखें.
{
"requestId": "6894439706274654520",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.SetTemperature",
"params": {
"temperature": 200
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654520",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"temperatureSetpointCelsius": 200,
"temperatureAmbientCelsius": 100
}
}
]
}
}
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": 300
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654522",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": 300
}
}
]
}
}
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": 290
}
}
]
}
}
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": 300,
"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": 300,
"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
}
}
]
}
}
StartStop
कमांड पैरामीटर के बारे में ज़्यादा जानकारी के लिए,
action.devices.traits.StartStop
रेफ़रंस देखें.
{
"requestId": "6894439706274654532",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.StartStop",
"params": {
"start": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654532",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"isRunning": true
}
}
]
}
}