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

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

डिवाइस ATTRIBUTES

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

विशेषताएं टाइप ब्यौरा
supportsEnablingGuestNetwork बूलियन

(डिफ़ॉल्ट: false)

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

(डिफ़ॉल्ट: false)

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

(डिफ़ॉल्ट: false)

अगर मेहमान नेटवर्क का पासवर्ड GetGuestNetworkPassword निर्देश से मिल सकता है, तो 'सही है' पर सेट करें.
networkProfiles कैटगरी

काम करने वाली नेटवर्क प्रोफ़ाइल के नामों की जानकारी देता है.
[item, ...] स्ट्रिंग

मिलते-जुलते डिवाइसों के ग्रुप को दिखाने वाली नेटवर्क प्रोफ़ाइल का नाम.
supportsEnablingNetworkProfile बूलियन

(डिफ़ॉल्ट: "false")

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

(डिफ़ॉल्ट: "false")

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

(डिफ़ॉल्ट: false)

अगर डाउनलोड स्पीड टेस्ट किया जा सकता है, तो 'सही है' पर सेट करें.
supportsNetworkUploadSpeedTest बूलियन

(डिफ़ॉल्ट: false)

अगर अपलोड स्पीड की जांच की जा सकती है, तो 'सही है' पर सेट करें.

उदाहरण

ऐसा नेटवर्क डिवाइस जिस पर मेहमान नेटवर्क, प्रोफ़ाइलें, और स्पीड टेस्ट काम करता है.

{
  "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 स्ट्रिंग

इससे पता चलता है कि पिछला नेटवर्क डाउनलोड स्पीड टेस्ट पूरा हुआ या नहीं.

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

SUCCESS
FAILURE
lastNetworkUploadSpeedTest ऑब्जेक्ट

इसमें हाल ही के नेटवर्क की अपलोड स्पीड की जांच के नतीजे शामिल होते हैं.
uploadSpeedMbps Number

नेटवर्क की पिछले जांच में, एमबीपीएस (मेगाबिट प्रति सेकंड) में अपलोड की स्पीड.
unixTimestampSec Integer

आखिरी नेटवर्क अपलोड स्पीड टेस्ट किए जाने के समय का Unix टाइमस्टैंप (Unix Epoch के बाद के सेकंड की संख्या).
status स्ट्रिंग

इससे पता चलता है कि नेटवर्क के अपलोड होने की पिछली जांच पूरी हो गई थी या नहीं.

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

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
}

ऐसा डिवाइस जिस पर "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 स्ट्रिंग

ज़रूरी है.

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 स्ट्रिंग

ज़रूरी है.

मेहमान नेटवर्क का पासवर्ड.

उदाहरण

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

{
  "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 स्ट्रिंग

ज़रूरी है.

अनुरोध का नतीजा.

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

SUCCESS
networkDownloadSpeedMbps Number

ज़रूरी है.

नेटवर्क की डाउनलोड स्पीड, मेगाबिट प्रति सेकंड में मापी जाती है.

सफल: networkUploadSpeed आपसे

फ़ील्ड टाइप ब्यौरा
followUpToken स्ट्रिंग

ज़रूरी है.

मूल EXECUTE अनुरोध में दिया गया टोकन.
status स्ट्रिंग

ज़रूरी है.

अनुरोध का नतीजा.

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

SUCCESS
networkUploadSpeedMbps Number

ज़रूरी है.

नेटवर्क की अपलोड करने की स्पीड, मेगाबिट प्रति सेकंड में मापी जाती है.

सफलता: networkDownloadSpeedMB और networkUploadspeed आपसे कनेक्ट होने की स्पीड

फ़ील्ड टाइप ब्यौरा
followUpToken स्ट्रिंग

ज़रूरी है.

मूल EXECUTE अनुरोध में दिया गया टोकन.
status स्ट्रिंग

ज़रूरी है.

अनुरोध का नतीजा.

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

SUCCESS
networkDownloadSpeedMbps Number

ज़रूरी है.

नेटवर्क की डाउनलोड स्पीड, मेगाबिट प्रति सेकंड में मापी जाती है.
networkUploadSpeedMbps Number

ज़रूरी है.

नेटवर्क की अपलोड करने की स्पीड, मेगाबिट प्रति सेकंड में मापी जाती है.

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

फ़ील्ड टाइप ब्यौरा
followUpToken स्ट्रिंग

ज़रूरी है.

मूल EXECUTE अनुरोध में दिया गया टोकन.
status स्ट्रिंग

ज़रूरी है.

अनुरोध का नतीजा.

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

FAILURE
errorCode स्ट्रिंग

ज़रूरी है.

इस trait के लिए वैल्यू, कोई भी गड़बड़ी कोड हो सकती है, जैसे कि 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"
    }
  }
}

डिवाइस ERRORS

गड़बड़ियों और अपवादों की पूरी सूची देखें.

दी गई नेटवर्क प्रोफ़ाइल को कंट्रोल करते समय कोई गड़बड़ी हुई.

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

networkProfileNotRecognized

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

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

networkSpeedTestInProgress