স্মার্ট হোম নেটওয়ার্ক কন্ট্রোল ট্রেইট স্কিমা

action.devices.traits.NetworkControl - এই ট্রেইটটি সেইসব ডিভাইসের অন্তর্গত, যেগুলো নেটওয়ার্ক ডেটা রিপোর্ট করা এবং নেটওয়ার্ক-নির্দিষ্ট অপারেশন সম্পাদন করা সমর্থন করে।

ডিভাইসের বৈশিষ্ট্য

এই বৈশিষ্ট্যযুক্ত ডিভাইসগুলি SYNC অপারেশনের অংশ হিসাবে নিম্নলিখিত অ্যাট্রিবিউটগুলি রিপোর্ট করতে পারে। SYNC ইনটেন্ট পরিচালনা সম্পর্কে আরও জানতে, ইনটেন্ট ফুলফিলমেন্ট দেখুন।

বৈশিষ্ট্য প্রকার বর্ণনা
supportsEnablingGuestNetwork বুলিয়ান

(ডিফল্ট: false )

গেস্ট নেটওয়ার্ক সক্রিয় করা গেলে এটিকে 'true' সেট করুন।

supportsDisablingGuestNetwork বুলিয়ান

(ডিফল্ট: false )

গেস্ট নেটওয়ার্ক নিষ্ক্রিয় করা গেলে এটিকে 'true' সেট করুন।

supportsGettingGuestNetworkPassword বুলিয়ান

(ডিফল্ট: false )

যদি GetGuestNetworkPassword কমান্ডের মাধ্যমে গেস্ট নেটওয়ার্কের পাসওয়ার্ড পাওয়া যায়, তাহলে এটিকে true-তে সেট করুন।

networkProfiles অ্যারে

সমর্থিত নেটওয়ার্ক প্রোফাইলের নামগুলো নির্দেশ করে।

[ item, ... ] স্ট্রিং

সম্পর্কিত ডিভাইসগুলোর একটি গোষ্ঠীর প্রতিনিধিত্বকারী একটি নেটওয়ার্ক প্রোফাইলের নাম।

supportsEnablingNetworkProfile বুলিয়ান

(ডিফল্ট: "false" )

নেটওয়ার্ক প্রোফাইল সক্রিয় করা গেলে এটিকে 'true' তে সেট করুন।

supportsDisablingNetworkProfile বুলিয়ান

(ডিফল্ট: "false" )

নেটওয়ার্ক প্রোফাইল নিষ্ক্রিয় করা গেলে এটিকে 'true'-তে সেট করুন।

supportsNetworkDownloadSpeedTest বুলিয়ান

(ডিফল্ট: false )

ডাউনলোড স্পিড টেস্ট চালানো গেলে এটিকে 'true' সেট করুন।

supportsNetworkUploadSpeedTest বুলিয়ান

(ডিফল্ট: false )

আপলোড স্পিড টেস্ট চালানো গেলে এটিকে 'true' সেট করুন।

উদাহরণ

এমন নেটওয়ার্ক ডিভাইস যা গেস্ট নেটওয়ার্ক, প্রোফাইল এবং স্পিড টেস্ট সমর্থন করে।

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

ডিভাইসের অবস্থা

এই বৈশিষ্ট্যযুক্ত সত্তাগুলো QUERY অপারেশনের অংশ হিসেবে নিম্নলিখিত অবস্থাগুলো রিপোর্ট করতে পারে। QUERY ইনটেন্ট পরিচালনা সম্পর্কে আরও জানতে, ইনটেন্ট ফুলফিলমেন্ট দেখুন।

রাজ্যগুলি প্রকার বর্ণনা
networkEnabled বুলিয়ান

প্রধান নেটওয়ার্কটি সক্রিয় আছে কিনা।

networkSettings বস্তু

এতে প্রধান নেটওয়ার্কের SSID রয়েছে।

ssid স্ট্রিং

প্রয়োজনীয়।

নেটওয়ার্ক এসএসআইডি।

guestNetworkEnabled বুলিয়ান

গেস্ট নেটওয়ার্ক সক্রিয় আছে কিনা।

guestNetworkSettings বস্তু

গেস্ট নেটওয়ার্কের SSID ধারণ করে।

ssid স্ট্রিং

প্রয়োজনীয়।

নেটওয়ার্ক এসএসআইডি।

numConnectedDevices পূর্ণসংখ্যা

নেটওয়ার্কের সাথে সংযুক্ত ডিভাইসের সংখ্যা।

networkUsageMB সংখ্যা

নেটওয়ার্ক ব্যবহার এমবি (মেগাবাইট)-তে পরিমাপ করা হয়। এই নেটওয়ার্ক ব্যবহার বর্তমান বিলিং মেয়াদের মধ্যেকার, যা একটি বিলিং মেয়াদের নেটওয়ার্ক ব্যবহারের সীমা নিরীক্ষণের জন্য সহায়ক হতে পারে।

networkUsageLimitMB সংখ্যা

নেটওয়ার্ক ব্যবহারের সীমা এমবি (মেগাবাইট)-তে। এই সীমাটি বর্তমান বিলিং মেয়াদের মধ্যে প্রযোজ্য।

networkUsageUnlimited বুলিয়ান

নেটওয়ার্ক ব্যবহার সীমাহীন কিনা। যদি এটি 'true' তে সেট করা থাকে, তাহলে ডিভাইস স্টেট 'networkUsageLimitMB' উপেক্ষা করা হবে।

lastNetworkDownloadSpeedTest বস্তু

সর্বশেষ নেটওয়ার্ক ডাউনলোড স্পিড টেস্টের ফলাফল রয়েছে।

downloadSpeedMbps সংখ্যা

সর্বশেষ নেটওয়ার্ক স্পিড টেস্টের ডাউনলোড স্পিড, এমবিপিএস (মেগাবিটস প্রতি সেকেন্ড) এককে।

unixTimestampSec পূর্ণসংখ্যা

সর্বশেষ নেটওয়ার্ক ডাউনলোড স্পিড টেস্টটি চালানোর মুহূর্তের ইউনিক্স টাইমস্ট্যাম্প (ইউনিক্স ইপক থেকে সেকেন্ডের সংখ্যা)।

status স্ট্রিং

সর্বশেষ নেটওয়ার্ক ডাউনলোড স্পিড টেস্টটি সফল হয়েছে নাকি ব্যর্থ হয়েছে তা নির্দেশ করে।

সমর্থিত মানসমূহ:

SUCCESS
FAILURE
lastNetworkUploadSpeedTest বস্তু

সর্বশেষ নেটওয়ার্ক আপলোড স্পিড টেস্টের ফলাফল রয়েছে।

uploadSpeedMbps সংখ্যা

সর্বশেষ নেটওয়ার্ক স্পিড টেস্টের আপলোড স্পিড, এমবিপিএস (মেগাবিটস প্রতি সেকেন্ড) এককে।

unixTimestampSec পূর্ণসংখ্যা

সর্বশেষ নেটওয়ার্ক আপলোড স্পিড টেস্টটি চালানোর মুহূর্তের ইউনিক্স টাইমস্ট্যাম্প (ইউনিক্স ইপক থেকে সেকেন্ডের সংখ্যা)।

status স্ট্রিং

সর্বশেষ নেটওয়ার্ক আপলোড স্পিড টেস্টটি সফল হয়েছে নাকি ব্যর্থ হয়েছে তা নির্দেশ করে।

সমর্থিত মানসমূহ:

SUCCESS
FAILURE
networkSpeedTestInProgress বুলিয়ান

(ডিফল্ট: false )

বর্তমানে গতি পরীক্ষা চালানো হচ্ছে কিনা।

networkProfilesState বস্তু

নেটওয়ার্ক প্রোফাইলের অবস্থা। এই শীর্ষ-স্তরের অবজেক্টটিতে কী-ভ্যালু পেয়ার থাকবে, যেখানে কী হবে networkProfiles অ্যাট্রিবিউটে তালিকাভুক্ত নেটওয়ার্ক প্রোফাইলগুলোর একটির নাম এবং ভ্যালু হবে সেই প্রোফাইলের সংশ্লিষ্ট অবস্থা।

<string> বস্তু

একটি অবজেক্ট যা কোনো স্বতন্ত্র নেটওয়ার্ক প্রোফাইলের অবস্থা সংরক্ষণ করে। এর মান key-টি 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 বুলিয়ান

প্রয়োজনীয়।

গেস্ট নেটওয়ার্ক চালু করতে True, বন্ধ করতে False।

উদাহরণ

গেস্ট নেটওয়ার্কটি চালু করুন।

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

action.devices.commands.EnableDisableNetworkProfile

একটি নেটওয়ার্ক প্রোফাইল সক্রিয় বা নিষ্ক্রিয় করুন। পিন ব্যবহার করে দ্বিতীয় ব্যবহারকারীর যাচাইকরণ অবশ্যই করতে হবে। এই কমান্ডগুলির মাধ্যমে অন্যান্য নিরাপত্তা ডিভাইস নিষ্ক্রিয় করা হলে, ব্যবহারকারীর বাড়ির নিরাপত্তা প্রভাবিত হয়েছে বলে গণ্য করা যেতে পারে।

এই কমান্ডটির জন্য নিম্নলিখিত অ্যাট্রিবিউটগুলো প্রয়োজন: 
{
  "supportsEnablingNetworkProfile": true,
  "supportsDisablingNetworkProfile": true
}

প্যারামিটার

প্যারামিটার প্রকার বর্ণনা
profile স্ট্রিং

প্রয়োজনীয়।

networkProfiles অ্যাট্রিবিউট থেকে প্রাপ্ত প্রোফাইলের নাম।

enable বুলিয়ান

প্রয়োজনীয়।

প্রোফাইল সক্রিয় করতে True, নিষ্ক্রিয় করতে False।

উদাহরণ

বাচ্চাদের জন্য ইন্টারনেট বন্ধ করে দিন।

{
  "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 স্ট্রিং

প্রয়োজনীয়।

পরবর্তী প্রতিক্রিয়ার জন্য গুগল-প্রদত্ত টোকেন।

উদাহরণ

ওয়াই-ফাই এর গতি কত? 

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

স্পিড টেস্টের অনুরোধ করার সময় একটি ত্রুটি ঘটেছে।

সমর্থিত মানসমূহ:

networkSpeedTestInProgress

ফলো-আপ প্রতিক্রিয়া

এই বৈশিষ্ট্যযুক্ত ডিভাইসগুলি EXECUTE অপারেশনের অংশ হিসাবে নিম্নলিখিত ফলো-আপ প্রতিক্রিয়া পেলোড ফেরত দিতে পারে। ফলো-আপ প্রতিক্রিয়া বাস্তবায়ন সম্পর্কে আরও জানতে, স্মার্ট হোম অ্যাকশনের জন্য বিজ্ঞপ্তি (Notifications for smart home Actions) দেখুন।

পেলোডটিতে নিম্নলিখিতগুলির মধ্যে একটি রয়েছে:

সফল: নেটওয়ার্ক ডাউনলোড স্পিড এমবিপিএস

ক্ষেত্র প্রকার বর্ণনা
followUpToken স্ট্রিং

প্রয়োজনীয়।

মূল EXECUTE অনুরোধে টোকেন প্রদান করা হয়েছিল।

status স্ট্রিং

প্রয়োজনীয়।

অনুরোধের ফলাফল।

সমর্থিত মানসমূহ:

SUCCESS
networkDownloadSpeedMbps সংখ্যা

প্রয়োজনীয়।

নেটওয়ার্ক ডাউনলোডের গতি মেগাবিট প্রতি সেকেন্ডে পরিমাপ করা হয়।

সফল: নেটওয়ার্ক আপলোড স্পিড এমবিপিএস

ক্ষেত্র প্রকার বর্ণনা
followUpToken স্ট্রিং

প্রয়োজনীয়।

মূল EXECUTE অনুরোধে টোকেন প্রদান করা হয়েছিল।

status স্ট্রিং

প্রয়োজনীয়।

অনুরোধের ফলাফল।

সমর্থিত মানসমূহ:

SUCCESS
networkUploadSpeedMbps সংখ্যা

প্রয়োজনীয়।

নেটওয়ার্ক আপলোড গতি মেগাবিট প্রতি সেকেন্ডে পরিমাপ করা হয়।

সফল: নেটওয়ার্কডাউনলোডস্পিডএমবিপিএস এবং নেটওয়ার্কআপলোডস্পিডএমবিপিএস

ক্ষেত্র প্রকার বর্ণনা
followUpToken স্ট্রিং

প্রয়োজনীয়।

মূল EXECUTE অনুরোধে টোকেন প্রদান করা হয়েছিল।

status স্ট্রিং

প্রয়োজনীয়।

অনুরোধের ফলাফল।

সমর্থিত মানসমূহ:

SUCCESS
networkDownloadSpeedMbps সংখ্যা

প্রয়োজনীয়।

নেটওয়ার্ক ডাউনলোডের গতি মেগাবিট প্রতি সেকেন্ডে পরিমাপ করা হয়।

networkUploadSpeedMbps সংখ্যা

প্রয়োজনীয়।

নেটওয়ার্ক আপলোড গতি মেগাবিট প্রতি সেকেন্ডে পরিমাপ করা হয়।

ব্যর্থতা

ক্ষেত্র প্রকার বর্ণনা
followUpToken স্ট্রিং

প্রয়োজনীয়।

মূল EXECUTE অনুরোধে টোকেন প্রদান করা হয়েছিল।

status স্ট্রিং

প্রয়োজনীয়।

অনুরোধের ফলাফল।

সমর্থিত মানসমূহ:

FAILURE
errorCode স্ট্রিং

প্রয়োজনীয়।

মানটি এই ট্রেইটের যেকোনো এরর কোড হতে পারে, যেমন, 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