स्मार्ट होम बॉयलर के लिए गाइड
action.devices.types.BOILER - बॉयलर को चालू और बंद किया जा सकता है. साथ ही, इनमें तापमान को अडजस्ट करने की सुविधा भी हो सकती है.
इस टाइप से पता चलता है कि डिवाइस को बॉयलर का आइकॉन और इससे जुड़े कुछ मिलते-जुलते शब्द और उपनाम मिलते हैं.
डिवाइस की क्षमताएं
इन्हें लागू करने के बारे में ज़्यादा जानकारी के लिए, इनसे जुड़ी खास जानकारी वाला दस्तावेज़ देखें. जैसे, एट्रिब्यूट और स्थितियां जिनकी सुविधा आपकी सेवा में होनी चाहिए. साथ ही, EXECUTE और QUERY के जवाब कैसे तैयार किए जाएं.
ज़रूरी ट्रेट
अगर ये ट्रेट और निर्देश आपके डिवाइस पर लागू होते हैं, तो इनका इस्तेमाल करना ज़रूरी है. अगर आपका डिवाइस इन ट्रेट के साथ काम नहीं करता है, तो QUERY या EXECUTE के जवाब में, functionNotSupported का गड़बड़ी कोड डालें. ज़्यादा जानकारी के लिए,
गड़बड़ियां और अपवाद देखें.
सुझाए गए ट्रेट
अगर ये ट्रेट आपके डिवाइस पर लागू होते हैं, तो इनका इस्तेमाल करने का सुझाव दिया जाता है. हालांकि, अपने मौजूदा प्रॉडक्ट की सुविधाओं के हिसाब से, उपलब्ध सभी ट्रेट को मिलाकर इस्तेमाल किया जा सकता है.
डिवाइस का उदाहरण: सामान्य बॉयलर
इस सेक्शन में, इंटेंट पेलोड के उदाहरण दिए गए हैं. ये उदाहरण, ऊपर बताए गए डिवाइस के टाइप और ट्रेट के आधार पर, सामान्य "बॉयलर" को दिखाते हैं. अगर आपने लागू करने के दौरान, ट्रेट जोड़े या हटाए हैं, तो उन बदलावों को दिखाने के लिए, अपने जवाबों में ज़रूरी बदलाव करें.
SYNC के जवाब का उदाहरण
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.BOILER", "traits": [ "action.devices.traits.TemperatureControl", "action.devices.traits.OnOff" ], "name": { "name": "Simple boiler" }, "willReportState": true, "attributes": { "temperatureRange": { "minThresholdCelsius": 10, "maxThresholdCelsius": 50 }, "temperatureUnitForUX": "F" }, "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, "temperatureSetpointCelsius": 35 } } } }
EXECUTE कमांड के उदाहरण
SetTemperature
कमांड के पैरामीटर के बारे में ज़्यादा जानने के लिए,
action.devices.traits.TemperatureControl
से जुड़ी जानकारी देखें.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetTemperature", "params": { "temperature": 40 } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "temperatureSetpointCelsius": 40 } } ] } }
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 } } ] } }