स्मार्ट होम नेटवर्क कंट्रोल ट्रैट स्कीमा
action.devices.traits.NetworkControl
- यह trait उन डिवाइसों से जुड़ा है जो नेटवर्क डेटा की रिपोर्टिंग और नेटवर्क से जुड़ी कार्रवाइयां करने के साथ काम करते हैं.
डिवाइस ATTRIBUTES
इस एट्रिब्यूट वाले डिवाइस, SYNC
ऑपरेशन के तहत, यहां दिए गए
एट्रिब्यूट रिपोर्ट कर सकते हैं. SYNC
इंटेंट को मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.
विशेषताएं | टाइप | ब्यौरा |
---|---|---|
supportsEnablingGuestNetwork |
बूलियन |
(डिफ़ॉल्ट: अगर मेहमान नेटवर्क चालू किया जा सकता है, तो 'सही है' पर सेट करें. |
supportsDisablingGuestNetwork |
बूलियन |
(डिफ़ॉल्ट: अगर मेहमान नेटवर्क बंद किया जा सकता है, तो 'सही है' पर सेट करें. |
supportsGettingGuestNetworkPassword |
बूलियन |
(डिफ़ॉल्ट: अगर मेहमान नेटवर्क का पासवर्ड |
networkProfiles |
कैटगरी |
काम करने वाली नेटवर्क प्रोफ़ाइल के नामों की जानकारी देता है. |
[item, ...] |
स्ट्रिंग |
मिलते-जुलते डिवाइसों के ग्रुप को दिखाने वाली नेटवर्क प्रोफ़ाइल का नाम. |
supportsEnablingNetworkProfile |
बूलियन |
(डिफ़ॉल्ट: अगर नेटवर्क प्रोफ़ाइल चालू की जा सकती हैं, तो 'सही है' पर सेट करें. |
supportsDisablingNetworkProfile |
बूलियन |
(डिफ़ॉल्ट: अगर नेटवर्क प्रोफ़ाइल बंद की जा सकती हैं, तो 'सही है' पर सेट करें. |
supportsNetworkDownloadSpeedTest |
बूलियन |
(डिफ़ॉल्ट: अगर डाउनलोड स्पीड टेस्ट किया जा सकता है, तो 'सही है' पर सेट करें. |
supportsNetworkUploadSpeedTest |
बूलियन |
(डिफ़ॉल्ट: अगर अपलोड स्पीड की जांच की जा सकती है, तो 'सही है' पर सेट करें. |
उदाहरण
ऐसा नेटवर्क डिवाइस जिस पर मेहमान नेटवर्क, प्रोफ़ाइलें, और स्पीड टेस्ट काम करता है.
{ "supportsEnablingGuestNetwork": true, "supportsDisablingGuestNetwork": true, "supportsEnablingNetworkProfile": true, "supportsDisablingNetworkProfile": true, "supportsNetworkDownloadSpeedTest": true, "supportsNetworkUploadSpeedTest": true, "supportsGettingGuestNetworkPassword": true, "networkProfiles": [ "Kids" ] }
डिवाइस की स्थितियां
इस trait वाली इकाइयां QUERY
ऑपरेशन के हिस्से के तौर पर,
यहां दिए गए स्टेटस की जानकारी दे सकती हैं. QUERY
इंटेंट को मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.
राज्य | टाइप | ब्यौरा |
---|---|---|
networkEnabled |
बूलियन |
मुख्य नेटवर्क चालू है या नहीं. |
networkSettings |
ऑब्जेक्ट |
इसमें मुख्य नेटवर्क का SSID शामिल होता है. |
ssid |
स्ट्रिंग |
ज़रूरी है. नेटवर्क SSID. |
guestNetworkEnabled |
बूलियन |
मेहमान नेटवर्क चालू है या नहीं. |
guestNetworkSettings |
ऑब्जेक्ट |
इसमें मेहमान नेटवर्क का SSID शामिल होता है. |
ssid |
स्ट्रिंग |
ज़रूरी है. नेटवर्क SSID. |
numConnectedDevices |
Integer |
नेटवर्क से कनेक्ट किए गए डिवाइसों की संख्या. |
networkUsageMB |
Number |
एमबी में नेटवर्क के इस्तेमाल (मेगाबाइट). नेटवर्क का इस्तेमाल मौजूदा बिलिंग अवधि में है, जिससे बिलिंग अवधि के लिए नेटवर्क के इस्तेमाल की सीमा के संबंध में निगरानी की जा सकती है. |
networkUsageLimitMB |
Number |
नेटवर्क के इस्तेमाल की सीमा एमबी में (मेगाबाइट). नेटवर्क के इस्तेमाल की सीमा, मौजूदा बिलिंग अवधि के बीच की है. |
networkUsageUnlimited |
बूलियन |
नेटवर्क का इस्तेमाल अनलिमिटेड है या नहीं. अगर इसे 'सही है' पर सेट किया जाता है, तो डिवाइस की networkUsageLimitMB अनदेखा किया जाएगा. |
lastNetworkDownloadSpeedTest |
ऑब्जेक्ट |
इसमें नेटवर्क की हाल ही की डाउनलोड स्पीड टेस्ट के नतीजे शामिल होते हैं. |
downloadSpeedMbps |
Number |
नेटवर्क की पिछले जांच में, एमबीपीएस (मेगाबिट प्रति सेकंड) में डाउनलोड की स्पीड. |
unixTimestampSec |
Integer |
आखिरी नेटवर्क के डाउनलोड की स्पीड की जांच करने के समय का Unix टाइमस्टैंप (Unix Epoch के बाद के सेकंड की संख्या). |
status |
स्ट्रिंग |
इससे पता चलता है कि पिछला नेटवर्क डाउनलोड स्पीड टेस्ट पूरा हुआ या नहीं. इस्तेमाल की जा सकने वाली वैल्यू:
|
lastNetworkUploadSpeedTest |
ऑब्जेक्ट |
इसमें हाल ही के नेटवर्क की अपलोड स्पीड की जांच के नतीजे शामिल होते हैं. |
uploadSpeedMbps |
Number |
नेटवर्क की पिछले जांच में, एमबीपीएस (मेगाबिट प्रति सेकंड) में अपलोड की स्पीड. |
unixTimestampSec |
Integer |
आखिरी नेटवर्क अपलोड स्पीड टेस्ट किए जाने के समय का Unix टाइमस्टैंप (Unix Epoch के बाद के सेकंड की संख्या). |
status |
स्ट्रिंग |
इससे पता चलता है कि नेटवर्क के अपलोड होने की पिछली जांच पूरी हो गई थी या नहीं. इस्तेमाल की जा सकने वाली वैल्यू:
|
networkSpeedTestInProgress |
बूलियन |
(डिफ़ॉल्ट: फ़िलहाल, स्पीड टेस्ट किया जा रहा है या नहीं. |
networkProfilesState |
ऑब्जेक्ट |
नेटवर्क प्रोफ़ाइलों की स्थिति. इस टॉप लेवल ऑब्जेक्ट में, कुंजी वैल्यू के जोड़े होने चाहिए. इनमें कुंजी, |
<string> |
ऑब्जेक्ट |
किसी नेटवर्क प्रोफ़ाइल की स्थिति सेव करने वाला ऑब्जेक्ट. |
enabled |
बूलियन |
नेटवर्क प्रोफ़ाइल की मौजूदा चालू/बंद स्थिति. |
उदाहरण
चालू नेटवर्क वाला डिवाइस.
{ "networkEnabled": true, "networkSettings": { "ssid": "home-network-123" }, "guestNetworkSettings": { "ssid": "home-network-123-guest" }, "numConnectedDevices": 4, "networkUsageMB": 100.8 }
चालू नेटवर्क वाला डिवाइस और स्पीड टेस्ट के नतीजे.
{ "networkEnabled": true, "networkSettings": { "ssid": "home-network-123" }, "guestNetworkSettings": { "ssid": "home-network-123-guest" }, "numConnectedDevices": 4, "networkUsageMB": 100.8, "lastNetworkDownloadSpeedTest": { "downloadSpeedMbps": 159.8, "unixTimestampSec": 1563215576, "status": "SUCCESS" }, "lastNetworkUploadSpeedTest": { "uploadSpeedMbps": 64.1, "unixTimestampSec": 1563215576, "status": "SUCCESS" } }
ऐसा डिवाइस जिस पर नेटवर्क चालू हो और उसकी स्पीड की जांच की जा रही हो.
{ "networkEnabled": true, "networkSettings": { "ssid": "home-network-123" }, "guestNetworkSettings": { "ssid": "home-network-123-guest" }, "numConnectedDevices": 4, "networkUsageMB": 100.8, "networkSpeedTestInProgress": true }
ऐसा डिवाइस जिस पर "kids" networkProfile से अनुमति दी गई है.
{ "networkEnabled": true, "networkSettings": { "ssid": "home-network-123" }, "networkProfilesState": { "parents": { "enabled": true }, "kids": { "enabled": false } } }
डिवाइस COMMANDS
इस खूबी वाले डिवाइस, EXECUTE
कार्रवाई के तहत, नीचे दिए गए
निर्देशों का जवाब दे सकते हैं. EXECUTE
इंटेंट को मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.
action.devices.commands.EnableDisableGuestNetwork
मेहमान नेटवर्क को चालू या बंद करें. पिन की मदद से उपयोगकर्ता की जानकारी की पुष्टि दूसरे तरीके से की जानी चाहिए. अगर इन निर्देशों की मदद से अन्य सुरक्षा डिवाइस बंद कर दिए जाते हैं, तो उपयोगकर्ता के घर की सुरक्षा पर असर पड़ सकता है.
इस निर्देश के लिए, इन एट्रिब्यूट की ज़रूरत होती है:{ "supportsEnablingGuestNetwork": true, "supportsDisablingGuestNetwork": true }
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
enable |
बूलियन |
ज़रूरी है. मेहमान नेटवर्क चालू करने के लिए 'सही है' पर सेट है, मेहमान नेटवर्क बंद करने के लिए 'गलत' है. |
उदाहरण
मेहमान नेटवर्क चालू करें.
{ "command": "action.devices.commands.EnableDisableGuestNetwork", "params": { "enable": true } }
action.devices.commands.EnableDisableNetworkProfile
नेटवर्क प्रोफ़ाइल को चालू या बंद करें. पिन की मदद से उपयोगकर्ता की जानकारी की पुष्टि दूसरे तरीके से की जानी चाहिए. अगर इन निर्देशों की मदद से अन्य सुरक्षा डिवाइस बंद कर दिए जाते हैं, तो उपयोगकर्ता के घर की सुरक्षा पर असर पड़ सकता है.
इस निर्देश के लिए, इन एट्रिब्यूट की ज़रूरत होती है:{ "supportsEnablingNetworkProfile": true, "supportsDisablingNetworkProfile": true }
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
profile |
स्ट्रिंग |
ज़रूरी है.
|
enable |
बूलियन |
ज़रूरी है. प्रोफ़ाइल चालू करने के लिए 'सही', प्रोफ़ाइल बंद करने के लिए 'गलत'. |
उदाहरण
बच्चों के लिए इंटरनेट बंद करें.
{ "command": "action.devices.commands.EnableDisableNetworkProfile", "params": { "profile": "Kids", "enable": false } }
मिलती-जुलती गड़बड़ियां
दी गई नेटवर्क प्रोफ़ाइल को कंट्रोल करते समय कोई गड़बड़ी हुई.
इस्तेमाल की जा सकने वाली वैल्यू:
networkProfileNotRecognized
action.devices.commands.GetGuestNetworkPassword
मेहमान नेटवर्क का पासवर्ड पाएं. पिन की मदद से उपयोगकर्ता की जानकारी की पुष्टि दूसरे तरीके से की जानी चाहिए. अगर इन निर्देशों की मदद से अन्य सुरक्षा डिवाइस बंद कर दिए जाते हैं, तो उपयोगकर्ता के घर की सुरक्षा पर असर पड़ सकता है.
इस निर्देश के लिए, इन एट्रिब्यूट की ज़रूरत होती है:{ "supportsGettingGuestNetworkPassword": true }
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
कोई प्रॉपर्टी नहीं |
उदाहरण
मेहमान वाई-फ़ाई का पासवर्ड दिखाओ.
{ "command": "action.devices.commands.GetGuestNetworkPassword", "params": {} }
नतीजे
नतीजे | टाइप | ब्यौरा |
---|---|---|
guestNetworkPassword |
स्ट्रिंग |
ज़रूरी है. मेहमान नेटवर्क का पासवर्ड. |
उदाहरण
मेहमान वाई-फ़ाई का पासवर्ड दिखाओ.
{ "guestNetworkPassword": "123456" }
action.devices.commands.TestNetworkSpeed
नेटवर्क की डाउनलोड और अपलोड स्पीड की जांच करें.
इस निर्देश के लिए, इन एट्रिब्यूट की ज़रूरत होती है:{ "supportsNetworkDownloadSpeedTest": true, "supportsNetworkUploadSpeedTest": true }
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
testDownloadSpeed |
बूलियन |
ज़रूरी है. इससे पता चलता है कि डाउनलोड करने की स्पीड की जांच करनी है या नहीं. |
testUploadSpeed |
बूलियन |
ज़रूरी है. इससे पता चलता है कि अपलोड की स्पीड की जांच करनी है या नहीं. |
followUpToken |
स्ट्रिंग |
ज़रूरी है. फ़ॉलो-अप जवाब के लिए Google का दिया गया टोकन. |
उदाहरण
वाई-फ़ाई की स्पीड कितनी है?
{ "command": "action.devices.commands.TestNetworkSpeed", "params": { "testDownloadSpeed": true, "testUploadSpeed": true, "followUpToken": "123" } }
मिलती-जुलती गड़बड़ियां
इंटरनेट स्पीड की जांच करने का अनुरोध करते समय कोई गड़बड़ी हुई.
इस्तेमाल की जा सकने वाली वैल्यू:
networkSpeedTestInProgress
फ़ॉलो-अप जवाब
इस trait वाले डिवाइस, EXECUTE
कार्रवाई के तौर पर,
फ़ॉलो-अप रिस्पॉन्स पेलोड दिखा सकते हैं. फ़ॉलो-अप जवाबों को लागू करने के बारे में ज़्यादा जानने के लिए, स्मार्ट होम कार्रवाइयों के लिए सूचनाएं देखें.
पेलोड में इनमें से कोई एक जानकारी शामिल होती है:
सफलता: networkDownloadSpeedspeed
फ़ील्ड | टाइप | ब्यौरा |
---|---|---|
followUpToken |
स्ट्रिंग |
ज़रूरी है. मूल EXECUTE अनुरोध में दिया गया टोकन. |
status |
स्ट्रिंग |
ज़रूरी है. अनुरोध का नतीजा. इस्तेमाल की जा सकने वाली वैल्यू:
|
networkDownloadSpeedMbps |
Number |
ज़रूरी है. नेटवर्क की डाउनलोड स्पीड, मेगाबिट प्रति सेकंड में मापी जाती है. |
सफल: networkUploadSpeed आपसे
फ़ील्ड | टाइप | ब्यौरा |
---|---|---|
followUpToken |
स्ट्रिंग |
ज़रूरी है. मूल EXECUTE अनुरोध में दिया गया टोकन. |
status |
स्ट्रिंग |
ज़रूरी है. अनुरोध का नतीजा. इस्तेमाल की जा सकने वाली वैल्यू:
|
networkUploadSpeedMbps |
Number |
ज़रूरी है. नेटवर्क की अपलोड करने की स्पीड, मेगाबिट प्रति सेकंड में मापी जाती है. |
सफलता: networkDownloadSpeedMB और networkUploadspeed आपसे कनेक्ट होने की स्पीड
फ़ील्ड | टाइप | ब्यौरा |
---|---|---|
followUpToken |
स्ट्रिंग |
ज़रूरी है. मूल EXECUTE अनुरोध में दिया गया टोकन. |
status |
स्ट्रिंग |
ज़रूरी है. अनुरोध का नतीजा. इस्तेमाल की जा सकने वाली वैल्यू:
|
networkDownloadSpeedMbps |
Number |
ज़रूरी है. नेटवर्क की डाउनलोड स्पीड, मेगाबिट प्रति सेकंड में मापी जाती है. |
networkUploadSpeedMbps |
Number |
ज़रूरी है. नेटवर्क की अपलोड करने की स्पीड, मेगाबिट प्रति सेकंड में मापी जाती है. |
पूरा नहीं हो सका
फ़ील्ड | टाइप | ब्यौरा |
---|---|---|
followUpToken |
स्ट्रिंग |
ज़रूरी है. मूल EXECUTE अनुरोध में दिया गया टोकन. |
status |
स्ट्रिंग |
ज़रूरी है. अनुरोध का नतीजा. इस्तेमाल की जा सकने वाली वैल्यू:
|
errorCode |
स्ट्रिंग |
ज़रूरी है. इस trait के लिए वैल्यू, कोई भी गड़बड़ी कोड हो सकती है, जैसे कि |
उदाहरण
वाई-फ़ाई की स्पीड कितनी है? (फ़ॉलो-अप जवाब)
{ "NetworkControl": { "priority": 0, "followUpResponse": { "status": "SUCCESS", "networkDownloadSpeedMbps": 23.3, "networkUploadSpeedMbps": 10.2, "followUpToken": "1234" } } }
वाई-फ़ाई की स्पीड कितनी है? (पुष्टि नहीं हो पाने पर फ़ॉलो-अप जवाब)
{ "NetworkControl": { "priority": 0, "followUpResponse": { "status": "FAILURE", "errorCode": "transientError", "followUpToken": "1234" } } }
डिवाइस ERRORS
गड़बड़ियों और अपवादों की पूरी सूची देखें.दी गई नेटवर्क प्रोफ़ाइल को कंट्रोल करते समय कोई गड़बड़ी हुई.
इस्तेमाल की जा सकने वाली वैल्यू:
networkProfileNotRecognized
इंटरनेट स्पीड की जांच करने का अनुरोध करते समय कोई गड़बड़ी हुई.
इस्तेमाल की जा सकने वाली वैल्यू:
networkSpeedTestInProgress