হোম APIs ওভারভিউ

অ্যান্ড্রয়েডের জন্য Google Home APIs একটি ইউনিফাইড API পৃষ্ঠ প্রদান করে যাতে ডেভেলপাররা ব্যবহারকারীর বাড়ির সত্তার অবস্থার সাথে ইন্টারঅ্যাক্ট করতে সক্ষম হয়। এই সংস্থাগুলি ব্যবহারকারীর কাঠামো এবং ঘরের সাথে যুক্ত ডিভাইস এবং নন-ডিভাইস তথ্য বর্ণনা করতে পারে।

হোম APIগুলি নিম্নলিখিত সত্তাগুলিকে সংজ্ঞায়িত করে যেগুলির সাথে একজন ব্যবহারকারী ইন্টারঅ্যাক্ট করতে পারে:

  • কাঠামো এমন একটি বাড়ির প্রতিনিধিত্ব করে যাতে রুম এবং ডিভাইস থাকে।
  • রুম একটি কাঠামোর অংশ এবং ডিভাইস ধারণ করে।
  • ডিভাইসগুলি বৈশিষ্ট্যগুলি সম্বলিত বৈশিষ্ট্যগুলি প্রয়োগ করে, প্রকারের সাথে সামঞ্জস্য করে, ইভেন্টগুলি নির্গত করে এবং কমান্ডগুলিতে প্রতিক্রিয়া জানায়।
  • অটোমেশনগুলি একটি কাঠামোর অংশ এবং বাড়িতে কাজগুলি স্বয়ংক্রিয় করতে হোম মেটাডেটা এবং ডিভাইসগুলি ব্যবহার করে।

চিত্র 1 এই স্থাপত্যটি চিত্রিত করে:

হোম APIs স্থাপত্য চিত্রিত চিত্র
চিত্র 1: হোম API-এর আর্কিটেকচার

হোম এপিআই ডিভাইসের ধরন Matter দ্বারা সমর্থিত হতে পারে, স্মার্ট হোমের জন্য একটি উন্মুক্ত মান, বা Google হোম ইকোসিস্টেমে একটি Cloud-to-cloud ডিভাইস হতে পারে। কিছু ডিভাইস প্রকার উভয়ের কার্যকারিতা অন্তর্ভুক্ত করতে পারে। আরও তথ্যের জন্য সমর্থিত ডিভাইসের ধরন দেখুন।

Matter , ডিভাইসের কার্যকারিতা ক্লাস্টার দ্বারা গোষ্ঠীভুক্ত করা হয়, যা হোম API-এ Matter স্ট্যান্ডার্ড বৈশিষ্ট্য হিসাবে উপস্থাপিত হয়। হোম এপিআইগুলি বর্তমান Matter স্পেসিফিকেশনে সংজ্ঞায়িত Matter ক্লাস্টারগুলির স্ট্যান্ডার্ড সেটকে সমর্থন করে।

Google Home ইকোসিস্টেমে, ডিভাইসের কার্যকারিতা স্মার্ট হোম বৈশিষ্ট্য দ্বারা গোষ্ঠীভুক্ত করা হয়, যা হোম API-এ Google স্মার্ট হোম বৈশিষ্ট্য হিসাবে উপস্থাপন করা হয়। হোম APIগুলি Cloud-to-cloud প্রোগ্রামে সংজ্ঞায়িত স্মার্ট হোম বৈশিষ্ট্যগুলির সেটকে সমর্থন করে৷

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

ভাষা

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

আমরা পরামর্শ দিচ্ছি কোরটিন, ফ্লো এবং জেটপ্যাক কম্পোজের কোটলিন ডকুমেন্টেশনের সাথে পরিচিত হওয়ার জন্য, যদি আপনি আগে থেকে না থাকেন:

সত্তা শনাক্তকারী

হোম API-এর প্রতিটি সত্তার একটি আইডি থাকে যা তার প্রাথমিক শনাক্তকারীকে উপস্থাপন করে। এই আইডিটি একটি অনন্য এবং স্থিতিশীল শনাক্তকারী যা সত্তার জীবনকালের জন্য কখনই পরিবর্তন হবে না। এই আইডিটি অবজেক্ট ক্যাশে বা সমতা পরীক্ষা করতে ব্যবহার করা যেতে পারে কারণ একটি সত্তার মেটাডেটা পরিবর্তন হতে পারে।

কোন কোন সত্তার আইডি আছে তা জানতে HasId ইন্টারফেস দেখুন।

পরিভাষা ম্যাপিং

হোম এপিআই-এর সত্তা Matter এবং Cloud-to-cloud ধারণাগুলি নিম্নরূপ:

হোম API Matter Cloud-to-cloud
বৈশিষ্ট্য ক্লাস্টার বৈশিষ্ট্য
বৈশিষ্ট্য বৈশিষ্ট্য বৈশিষ্ট্য, রাষ্ট্র
আদেশ আদেশ আদেশ
ঘটনা ঘটনা ফলো আপ প্রতিক্রিয়া, বিজ্ঞপ্তি