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