ব্যবহারের সহজতার জন্য, কিছু বৈশিষ্ট্যের সরলীকৃত সংস্করণ অটোমেশন API-এর সাথে ব্যবহারের জন্য উপলব্ধ।
একটি সরলীকৃত বৈশিষ্ট্য একটি স্ট্যান্ডার্ড হোম API বৈশিষ্ট্যের জন্য দাঁড়ায়, যেভাবে মুখের প্যাটার্ন কাজ করে। সরলীকৃত বৈশিষ্ট্যগুলি এমন কমান্ড সরবরাহ করে যা নির্দিষ্ট ডিভাইসের প্রকারের জন্য সাধারণ কাজগুলিকে সহজ করে তোলে। সরলীকৃত বৈশিষ্ট্য হল হোম এপিআই বৈশিষ্ট্য এবং অন্যান্য হোম এপিআই বৈশিষ্ট্যের মতো এগুলি Matter এবং Cloud-to-cloud ডিভাইস উভয়ের জন্যই কাজ করে।
একটি সরলীকৃত বৈশিষ্ট্য বৈশিষ্ট্য এবং কমান্ডের একটি বিকল্প উপসেট অফার করে যা সংশ্লিষ্ট স্ট্যান্ডার্ড বৈশিষ্ট্যের তুলনায় ডিভাইস-নির্দিষ্ট। উদাহরণ স্বরূপ, স্ট্যান্ডার্ড LevelControl বৈশিষ্ট্য হল একটি জেনেরিক বৈশিষ্ট্য যা যেকোন ডিভাইসের জন্য ব্যবহার করা যেতে পারে যার একটি সেটিং রয়েছে যা সংখ্যাসূচক মানগুলির একটি পরিসরে ক্রমাগত পরিবর্তিত হয়। Brightness হল একটি সরলীকৃত বৈশিষ্ট্য যা LevelControl জন্য দাঁড়ায় এবং একটি DimmableLight ডিভাইসের জন্য প্রয়োজনীয় কমান্ড এবং বৈশিষ্ট্যগুলি প্রদান করে। Brightness একটি moveToBrightness কমান্ড রয়েছে যা একটি একক brightnessPercent আর্গুমেন্ট নেয়, যেখানে LevelControl একাধিক move কমান্ড রয়েছে, যার বেশিরভাগেরই ব্যবহার-কেসের একটি বিস্তৃত পরিসরকে মিটমাট করার জন্য কমপক্ষে চারটি প্যারামিটার রয়েছে।
নিম্নলিখিত সারণী প্রতিটি সরলীকৃত বৈশিষ্ট্য এবং অন্তর্নিহিত মান বৈশিষ্ট্য(গুলি) দেখায়। প্রতিটি বৈশিষ্ট্যের নাম সংশ্লিষ্ট API ডকুমেন্টেশনের সাথে লিঙ্ক করে:
| সরলীকৃত বৈশিষ্ট্য | স্ট্যান্ডার্ড বৈশিষ্ট্য |
|---|---|
SimplifiedThermostat | Thermostat |
Brightness | LevelControl |
SimplifiedOnOff | OnOff |
Volume | LevelControlOnOff |
সরলীকৃত বৈশিষ্ট্য এবং আবিষ্কার API
ডিসকভারি এপিআই সরলীকৃত বৈশিষ্ট্যের পাশাপাশি তাদের অন্তর্নিহিত স্ট্যান্ডার্ড বৈশিষ্ট্যগুলি রিপোর্ট করে, যতক্ষণ না উভয় বৈশিষ্ট্যই FactoryRegistry নিবন্ধিত ছিল। উদাহরণস্বরূপ, যদি একটি DimmableLight ডিভাইস কাঠামোতে উপস্থিত থাকে, এবং বিকাশকারী FactoryRegistry এ LevelControl এবং Brightness বৈশিষ্ট্য উভয়ই নিবন্ধন করেন, Discovery API উভয় বৈশিষ্ট্যের উপস্থিতি নির্দেশ করবে। বিকাশকারী তাদের অটোমেশনে যেকোন একটি বৈশিষ্ট্য ব্যবহার করতে বেছে নিতে পারে।
আরও তথ্যের জন্য ডিসকভারি API দেখুন।
একটি সরলীকৃত বৈশিষ্ট্য সমর্থন করে এমন একটি ডিভাইস পুনরুদ্ধার করুন৷
SimplifiedThermostat মতো সরলীকৃত বৈশিষ্ট্য সমর্থন করে এমন একটি কাঠামোতে ডিভাইসগুলি পেতে ডিভাইস API ব্যবহার করার সময়, আপনি has(trait) পদ্ধতি ব্যবহার করতে পারবেন না। পরিবর্তে, has(deviceType) পদ্ধতি ব্যবহার করুন:
val thermostat = home.devices().list().first { device -> device.has(ThermostatDevice) }