বৈশিষ্ট্য

SDM API-এর একটি বৈশিষ্ট্যের মধ্যে রয়েছে ক্ষেত্র , কমান্ড এবং ইভেন্ট

ক্ষেত্র

ক্ষেত্রগুলি হল সাধারণ ডেটা প্রকারের মান, যেমন একটি সংখ্যা বা একটি স্ট্রিং। উদাহরণস্বরূপ, একটি ফিল্ডে একটি বর্তমান মোড বা Google নেস্ট থার্মোস্ট্যাটের পরিবেষ্টিত আর্দ্রতা থাকতে পারে।

পছন্দসই API এন্ডপয়েন্টে একটি GET কল দিয়ে বৈশিষ্ট্য এবং ক্ষেত্রগুলি দেখা যেতে পারে:

GET /enterprises/project-id/devices/device-id
{
  "name" : "enterprises/project-id/devices/device-id",
  "type" : "sdm.devices.types.device-type",
  "traits" : { ... },
  "parentRelations" : [
    {
      "parent" : "enterprises/project-id/structures/structure-id/rooms/room-id",
      "displayName" : "Lobby"
    }
  ]
}

ডিভাইসের ধরন

sdm.devices.types. device-type SDM API দ্বারা প্রত্যাবর্তিত sdm.devices.types. device-type প্রকৃত ডিভাইসের কার্যকারিতা অনুমান করতে বা অনুমান করতে ব্যবহার করা উচিত নয় যা এটিকে বরাদ্দ করা হয়েছে৷ SDM API-তে আরও বৈশিষ্ট্য যুক্ত হওয়ার কারণে একটি ডিভাইসের ধরন একটি নির্দিষ্ট ডিভাইসের জন্য স্থিতিশীল থাকবে এমন কোনো গ্যারান্টি নেই। পরিবর্তে, ডিভাইসের জন্য ফিরে আসা বৈশিষ্ট্য ব্যবহার করুন।

পিতামাতার সম্পর্ক

parentRelations অবজেক্ট বর্তমান রিসোর্সের প্যারেন্ট রিসোর্স, হয় একটি স্ট্রাকচার বা রুম প্রতিনিধিত্ব করে। ডিসপ্লে নাম এর customName ক্ষেত্রের সাথে মিলে যায়তথ্য বৈশিষ্ট্য স্ট্রাকচার প্যারেন্ট সহ ডিভাইসগুলির জন্য বারুম ইনফো বৈশিষ্ট্য রুম প্যারেন্ট সহ ডিভাইসগুলির জন্য।

কমান্ড

কমান্ডগুলি একটি বৈশিষ্ট্যের সাথে যুক্ত অনুরোধ। যেমন, Google Nest Thermostat-এ বর্তমান মোড বা তাপমাত্রা সেটপয়েন্ট পরিবর্তন করা।

একটি কমান্ড একটি executeCommand API কল দ্বারা পাঠানো হয়:

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "command-name",
  "params" : {
    "field" : "value"
  }
}

একটি কমান্ডের বেশিরভাগ প্রতিক্রিয়া একটি সাধারণ সাফল্য বা ব্যর্থতা। নির্দিষ্ট কমান্ড ব্যবহারের উদাহরণের জন্য পৃথক বৈশিষ্ট্য নির্দেশিকা দেখুন।

ঘটনা

ইভেন্টগুলি অ্যাসিঙ্ক্রোনাস এবং Google ক্লাউড পাব/সাব দ্বারা পরিচালিত হয় প্রতি একক বিষয়ে Project আইডি

একটি বৈশিষ্ট্য ক্ষেত্রের মান পরিবর্তনের জন্য ইভেন্টগুলি ডিফল্টরূপে পাঠানো হয়। এগুলি নির্দিষ্ট ডিভাইসের ক্রিয়া বা সংস্থান নিয়োগের পরিবর্তনের প্রতিক্রিয়া হিসাবেও পাঠানো যেতে পারে। আরও তথ্যের জন্য ইভেন্ট দেখুন।

বৈশিষ্ট্য বিভাগ

গঠন

বৈশিষ্ট্য
তথ্য
sdm.structures.traits.Info
এই বৈশিষ্ট্যটি কাঠামো সম্পর্কিত তথ্যের জন্য যে কোনও কাঠামোর অন্তর্গত।
রুম ইনফো
sdm.structures.traits.RoomInfo
এই বৈশিষ্ট্যটি রুম সম্পর্কিত তথ্যের জন্য যেকোন রুমের অন্তর্গত।

ডিভাইস

বৈশিষ্ট্য
সংযোগ
sdm.devices.traits.Connectivity
এই বৈশিষ্ট্যটি যেকোন ডিভাইসের অন্তর্গত যা সংযোগের তথ্য রয়েছে৷
পাখা
sdm.devices.traits.Fan
এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যার ফ্যান নিয়ন্ত্রণ করার সিস্টেম ক্ষমতা রয়েছে।
আর্দ্রতা
sdm.devices.traits.Humidity
এই বৈশিষ্ট্যটি আর্দ্রতা পরিমাপ করার জন্য একটি সেন্সর আছে এমন যেকোনো ডিভাইসের অন্তর্গত।
তথ্য
sdm.devices.traits.Info
ডিভাইস-সম্পর্কিত তথ্যের জন্য এই বৈশিষ্ট্যটি যেকোনো ডিভাইসের অন্তর্গত।
সেটিংস
sdm.devices.traits.Settings
ডিভাইস-সম্পর্কিত সেটিংস তথ্যের জন্য এই বৈশিষ্ট্যটি যেকোনো ডিভাইসের অন্তর্গত।
তাপমাত্রা
sdm.devices.traits.Temperature
এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যার তাপমাত্রা পরিমাপ করার জন্য একটি সেন্সর রয়েছে।

তাপস্থাপক

বৈশিষ্ট্য
থার্মোস্টেট ইকো
sdm.devices.traits.ThermostatEco
এই বৈশিষ্ট্যটি ইকো মোড সমর্থন করে এমন থার্মোস্ট্যাট ধরনের ডিভাইসের অন্তর্গত।
থার্মোস্ট্যাট
sdm.devices.traits.ThermostatHvac
এই বৈশিষ্ট্যটি থার্মোস্ট্যাটের ধরনের ডিভাইসের অন্তর্গত যা HVAC বিবরণ রিপোর্ট করতে পারে।
থার্মোস্ট্যাট মোড
sdm.devices.traits.ThermostatMode
এই বৈশিষ্ট্যটি বিভিন্ন থার্মোস্ট্যাট মোড সমর্থন করে এমন থার্মোস্ট্যাটের ডিভাইসের অন্তর্গত।
থার্মোস্ট্যাট তাপমাত্রা সেটপয়েন্ট
sdm.devices.traits.ThermostatTemperatureSetpoint
এই বৈশিষ্ট্যটি থার্মোস্ট্যাটের ডিভাইসের অন্তর্গত যা লক্ষ্য তাপমাত্রা এবং তাপমাত্রা পরিসীমা নির্ধারণ করতে সহায়তা করে।

ক্যামেরা

বৈশিষ্ট্য
ক্যামেরাক্লিপ প্রিভিউ
sdm.devices.traits.CameraClipPreview
এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যা একটি ক্লিপ প্রিভিউ ডাউনলোড সমর্থন করে৷
ক্যামেরা ইভেন্ট ইমেজ
sdm.devices.traits.CameraEventImage
এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যা ইভেন্ট থেকে ছবি তৈরি করতে সহায়তা করে।
ক্যামেরা ইমেজ
sdm.devices.traits.CameraImage
এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যা ছবি তোলা সমর্থন করে।
ক্যামেরালাইভস্ট্রিম
sdm.devices.traits.CameraLiveStream
এই বৈশিষ্ট্যটি লাইভ স্ট্রিমিং সমর্থন করে এমন যেকোনো ডিভাইসের অন্তর্গত।
ক্যামেরা মোশন
sdm.devices.traits.CameraMotion
এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যা গতি সনাক্তকরণ ইভেন্টগুলিকে সমর্থন করে৷
ক্যামেরাপার্সন
sdm.devices.traits.CameraPerson
এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যা ব্যক্তি সনাক্তকরণ ইভেন্টগুলিকে সমর্থন করে৷
ক্যামেরা সাউন্ড
sdm.devices.traits.CameraSound
এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যা শব্দ সনাক্তকরণ ইভেন্টগুলিকে সমর্থন করে৷

ডোরবেল

বৈশিষ্ট্য
ডোরবেলচাইম
sdm.devices.traits.DoorbellChime
এই বৈশিষ্ট্যটি যেকোনও ডিভাইসের অন্তর্গত যা ডোরবেল কাইম এবং সম্পর্কিত প্রেস ইভেন্ট সমর্থন করে।