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

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

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

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

विशेषताएं	Type	जानकारी
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 इंटेंट को हैंडल करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

राज्य	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	इससे पता चलता है कि क्या पिछला नेटवर्क डाउनलोड स्पीड टेस्ट पूरा हुआ था या वह पूरा नहीं हुआ था. इस्तेमाल की जा सकने वाली वैल्यू: 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
}

पैरामीटर

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

उदाहरण

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

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

action.devices.commands.EnableDisableNetworkProfile

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

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

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

पैरामीटर

पैरामीटर	Type	जानकारी
profile	String	ज़रूरी है. networkProfiles एट्रिब्यूट से बना प्रोफ़ाइल नाम.
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	ज़रूरी है. अनुरोध का नतीजा. इस्तेमाल की जा सकने वाली वैल्यू: SUCCESS
networkDownloadSpeedMbps	Number	ज़रूरी है. नेटवर्क डाउनलोड स्पीड, मेगाबिट प्रति सेकंड में मापी जाती है.

सफल: networkUploadspeedMbps

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

सफल: networkDownloadspeedMbps और networkUploadSpeedMbps

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

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

फ़ील्ड	Type	जानकारी
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