स्मार्ट होम नेटवर्क कंट्रोल ट्रेल स्कीमा

action.devices.traits.NetworkControl - यह खासियत उन डिवाइसों पर लागू होती है जिनमें नेटवर्क से जुड़े डेटा की रिपोर्ट करने और नेटवर्क से जुड़े खास काम करने की सुविधा होती है.

डिवाइस की विशेषताएं

जिन डिवाइसों में यह एट्रिब्यूट मौजूद है वे SYNC कार्रवाई के तहत, इन एट्रिब्यूट की रिपोर्ट कर सकते हैं. SYNC इंटेंट मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

विशेषताएं	टाइप	जानकारी
supportsEnablingGuestNetwork	बूलियन	(डिफ़ॉल्ट: false) मेहमान नेटवर्क चालू किए जाने की स्थिति में, 'सही है' पर सेट करें.
supportsDisablingGuestNetwork	बूलियन	(डिफ़ॉल्ट: false) मेहमान नेटवर्क की सुविधा बंद होने पर, 'सही है' पर सेट करें.
supportsGettingGuestNetworkPassword	बूलियन	(डिफ़ॉल्ट: false) अगर मेहमान नेटवर्क का पासवर्ड GetGuestNetworkPassword निर्देश से पाया जा सकता है, तो 'सही है' पर सेट करें.
networkProfiles	रेंज	यह सुविधा, नेटवर्क प्रोफ़ाइल के साथ काम करने वाले नामों की जानकारी देती है.
[item, ...]	String	मिलते-जुलते डिवाइसों के ग्रुप को दिखाने वाली नेटवर्क प्रोफ़ाइल का नाम.
supportsEnablingNetworkProfile	बूलियन	(डिफ़ॉल्ट: "false") अगर नेटवर्क प्रोफ़ाइल चालू की जा सकती है, तो 'सही' पर सेट करें.
supportsDisablingNetworkProfile	बूलियन	(डिफ़ॉल्ट: "false") अगर नेटवर्क प्रोफ़ाइल बंद की जा सकती है, तो 'सही' पर सेट करें.
supportsNetworkDownloadSpeedTest	बूलियन	(डिफ़ॉल्ट: false) अगर डाउनलोड स्पीड टेस्ट चलाया जा सकता है, तो 'सही' पर सेट करें.
supportsNetworkUploadSpeedTest	बूलियन	(डिफ़ॉल्ट: false) अगर अपलोड स्पीड टेस्ट चलाया जा सकता है, तो 'सही' पर सेट करें.

उदाहरण

मेहमान नेटवर्क, प्रोफ़ाइल, और स्पीड टेस्ट के साथ काम करने वाला नेटवर्क डिवाइस.

{
  "supportsEnablingGuestNetwork": true,
  "supportsDisablingGuestNetwork": true,
  "supportsEnablingNetworkProfile": true,
  "supportsDisablingNetworkProfile": true,
  "supportsNetworkDownloadSpeedTest": true,
  "supportsNetworkUploadSpeedTest": true,
  "supportsGettingGuestNetworkPassword": true,
  "networkProfiles": [
    "Kids"
  ]
}

डिवाइस के राज्य

इस खासियत वाली इकाइयां, QUERY ऑपरेशन के हिस्से के तौर पर इन स्थितियों की रिपोर्ट कर सकती हैं. QUERY इंटेंट मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

राज्य	टाइप	जानकारी
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	इससे पता चलता है कि पिछली बार नेटवर्क स्पीड डाउनलोड हुई या नहीं. इस्तेमाल की जा सकने वाली वैल्यू: SUCCESS FAILURE
lastNetworkUploadSpeedTest	ऑब्जेक्ट	इसमें नेटवर्क अपलोड करने की हाल ही की रफ़्तार की जांच के नतीजे शामिल हैं.
uploadSpeedMbps	Number	पिछली नेटवर्क गति जांच के एमबीपीएस (मेगाबिट प्रति सेकंड) में अपलोड की गति.
unixTimestampSec	Integer	Unix टाइमस्टैंप (Unix Epoch के बाद से सेकंड की संख्या) जब आखिरी नेटवर्क अपलोड स्पीड टेस्ट चलाया गया था.
status	String	इससे पता चलता है कि पिछली बार नेटवर्क स्पीड अपलोड हुई थी या नहीं. इस्तेमाल की जा सकने वाली वैल्यू: SUCCESS FAILURE
networkSpeedTestInProgress	बूलियन	(डिफ़ॉल्ट: false) स्पीड टेस्ट अभी चल रहा है या नहीं.
networkProfilesState	ऑब्जेक्ट	नेटवर्क प्रोफ़ाइल की स्थिति. इस टॉप लेवल ऑब्जेक्ट में, कुंजी की जोड़ी के वैल्यू पेयर होने चाहिए. इनमें, डिजिटल बटन का नाम, networkProfiles एट्रिब्यूट में दी गई नेटवर्क प्रोफ़ाइल में से एक होता है. साथ ही, इसमें उस प्रोफ़ाइल से जुड़ी वैल्यू भी शामिल होनी चाहिए.
<string>	ऑब्जेक्ट	व्यक्तिगत नेटवर्क प्रोफ़ाइल की स्थिति को संग्रहित करने वाला ऑब्जेक्ट. कुंजी का मान networkProfiles विशेषता में मौजूद नेटवर्क प्रोफ़ाइल में से किसी एक का नाम होना चाहिए.
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
}

पैरामीटर

पैरामीटर	टाइप	जानकारी
enable	बूलियन	ज़रूरी है. मेहमान नेटवर्क को चालू करने के लिए 'सही', मेहमान नेटवर्क को बंद करने के लिए 'गलत' पर सेट करें.

उदाहरण

मेहमान नेटवर्क चालू करें.

{
  "command": "action.devices.commands.EnableDisableGuestNetwork",
  "params": {
    "enable": true
  }
}

action.devices.commands.EnableDisableNetworkProfile

नेटवर्क प्रोफ़ाइल को चालू या बंद करें. दूसरे उपयोगकर्ता की पुष्टि पिन के साथ की जानी चाहिए. अगर इन निर्देशों की मदद से, सुरक्षा से जुड़े दूसरे डिवाइस बंद कर दिए जाते हैं, तो इससे उपयोगकर्ता के घर की सुरक्षा पर असर पड़ सकता है.

इस निर्देश के लिए ये एट्रिब्यूट ज़रूरी हैं:

{
  "supportsEnablingNetworkProfile": true,
  "supportsDisablingNetworkProfile": true
}

पैरामीटर

पैरामीटर	टाइप	जानकारी
profile	String	ज़रूरी है. networkProfiles एट्रिब्यूट से बनाया गया प्रोफ़ाइल नाम.
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	String	ज़रूरी है. मेहमान नेटवर्क का पासवर्ड.

उदाहरण

मेहमान का वाई-फ़ाई पासवर्ड दिखाओ.

{
  "guestNetworkPassword": "123456"
}

action.devices.commands.TestNetworkSpeed

नेटवर्क की डाउनलोड और अपलोड की स्पीड की जांच करें.

इस निर्देश के लिए ये एट्रिब्यूट ज़रूरी हैं:

{
  "supportsNetworkDownloadSpeedTest": true,
  "supportsNetworkUploadSpeedTest": true
}

पैरामीटर

पैरामीटर	टाइप	जानकारी
testDownloadSpeed	बूलियन	ज़रूरी है. इससे पता चलता है कि क्या डाउनलोड करने की रफ़्तार की जाँच की जानी चाहिए.
testUploadSpeed	बूलियन	ज़रूरी है. इससे पता चलता है कि क्या अपलोड की रफ़्तार की जाँच की जानी चाहिए.
followUpToken	String	ज़रूरी है. फ़ॉलो-अप जवाब के लिए Google से मिला टोकन.

उदाहरण

वाई-फ़ाई की स्पीड कितनी है?

{
  "command": "action.devices.commands.TestNetworkSpeed",
  "params": {
    "testDownloadSpeed": true,
    "testUploadSpeed": true,
    "followUpToken": "123"
  }
}

मिलती-जुलती गड़बड़ियां

स्पीड टेस्ट का अनुरोध करते समय कोई गड़बड़ी हुई.

इस्तेमाल की जा सकने वाली वैल्यू:

networkSpeedTestInProgress

फ़ॉलो-अप जवाब

जिन डिवाइसों में यह एट्रिब्यूट मौजूद है वे EXECUTE कार्रवाई के हिस्से के तौर पर, फ़ॉलो-अप रिस्पॉन्स पेलोड दिखा सकते हैं. फ़ॉलो-अप रिस्पॉन्स लागू करने के बारे में ज़्यादा जानने के लिए, स्मार्ट होम ऐक्शन की सूचनाएं देखें.

पेलोड में इनमें से कोई एक शामिल होता है:

सफल: networkDownloadSpeedMbps

फ़ील्ड	टाइप	जानकारी
followUpToken	String	ज़रूरी है. EXECUTE के मूल अनुरोध में दिया गया टोकन.
status	String	ज़रूरी है. अनुरोध का नतीजा. इस्तेमाल की जा सकने वाली वैल्यू: SUCCESS
networkDownloadSpeedMbps	Number	ज़रूरी है. नेटवर्क डाउनलोड स्पीड को मेगाबिट प्रति सेकंड में मापा जाता है.

सफल: networkUploadSpeedMbps

फ़ील्ड	टाइप	जानकारी
followUpToken	String	ज़रूरी है. EXECUTE के मूल अनुरोध में दिया गया टोकन.
status	String	ज़रूरी है. अनुरोध का नतीजा. इस्तेमाल की जा सकने वाली वैल्यू: SUCCESS
networkUploadSpeedMbps	Number	ज़रूरी है. नेटवर्क अपलोड की गति मेगाबिट प्रति सेकंड में मापी जाती है.

सफल: networkDownloadSpeedMbps और networkUploadSpeedMbps

फ़ील्ड	टाइप	जानकारी
followUpToken	String	ज़रूरी है. EXECUTE के मूल अनुरोध में दिया गया टोकन.
status	String	ज़रूरी है. अनुरोध का नतीजा. इस्तेमाल की जा सकने वाली वैल्यू: SUCCESS
networkDownloadSpeedMbps	Number	ज़रूरी है. नेटवर्क डाउनलोड स्पीड को मेगाबिट प्रति सेकंड में मापा जाता है.
networkUploadSpeedMbps	Number	ज़रूरी है. नेटवर्क अपलोड की गति मेगाबिट प्रति सेकंड में मापी जाती है.

पूरा नहीं हो सका

फ़ील्ड	टाइप	जानकारी
followUpToken	String	ज़रूरी है. EXECUTE के मूल अनुरोध में दिया गया टोकन.
status	String	ज़रूरी है. अनुरोध का नतीजा. इस्तेमाल की जा सकने वाली वैल्यू: FAILURE
errorCode	String	ज़रूरी है. इस एट्रिब्यूट के लिए कोई भी गड़बड़ी कोड, वैल्यू हो सकती है. उदाहरण के लिए, transientError.

उदाहरण

वाई-फ़ाई की स्पीड क्या है? (फ़ॉलो-अप जवाब)

{
  "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