অভিপ্রায়

স্মার্ট হোম ইন্টেন্ট হল সহজ মেসেজিং অবজেক্ট যা বর্ণনা করে যে Cloud-to-cloud ইন্টিগ্রেশন কী সম্পাদন করবে, যেমন আলো জ্বালানো বা স্পিকারে অডিও কাস্ট করা।

সমস্ত smart home ইন্টেন্ট action.devices নেমস্পেসে অন্তর্ভুক্ত থাকে এবং আপনাকে অবশ্যই সেগুলির জন্য পরিপূর্ণতা প্রদান করতে হবে। যখনই Google Assistant পরিপূর্ণতার জন্য একটি অভিপ্রায় পাঠায়, তখন ব্যবহারকারীর তৃতীয়-পক্ষের OAuth 2 অ্যাক্সেস টোকেন Authorization হেডারে পাস করা হয়।

সমর্থিত smart home উদ্দেশ্যগুলি এখানে:

সিঙ্ক

action.devices.SYNC ইনটেন্টটি ব্যবহারকারীর সংযুক্ত এবং ব্যবহারের জন্য উপলব্ধ smart home ডিভাইসের তালিকা অনুরোধ করতে ব্যবহৃত হয়।

যখন কোনও ব্যবহারকারী Google Home app (GHA) দিয়ে তাদের ডিভাইস সেট আপ করেন, তখন সেগুলি আপনার ক্লাউড অবকাঠামোর সাথেও প্রমাণিত হয়। তারপর, Assistant একটি OAuth2 টোকেন পায়। এই মুহুর্তে, Assistant আপনার ক্লাউড অবকাঠামো থেকে ব্যবহারকারীর ডিভাইস এবং ক্ষমতার প্রাথমিক তালিকা পুনরুদ্ধার করার জন্য একটি action.devices.SYNC প্রেরণ করে।

এই চিত্রটি গুগল অবকাঠামো এবং পার্টনার অবকাঠামোর মধ্যে মিথস্ক্রিয়া দেখায়। গুগল অবকাঠামো থেকে অ্যাসিস্ট্যান্ট ক্লায়েন্ট অ্যাপে উপলব্ধ অংশীদারদের একটি তালিকা রয়েছে, যা OAuth প্রমাণীকরণ সম্পূর্ণ করার জন্য পার্টনার অবকাঠামোতে প্রবাহিত হয়। পার্টনার সাইডে OAuth প্রমাণীকরণ হল পার্টনার সেটআপ ওয়েবভিউ, OAuth ওয়েবভিউ, ঐচ্ছিক সেটিংস এবং শর্তাবলী এবং পার্টনার ক্লাউড পরিষেবা। পার্টনার অবকাঠামো তারপর অ্যাসিস্ট্যান্ট ক্লায়েন্ট অ্যাপে OAuth শংসাপত্র ফেরত দেয়। পার্টনার ক্লাউড পরিষেবাগুলি অ্যাসিস্ট্যান্ট পরিষেবাগুলিতে উপলব্ধ ডিভাইস এবং ক্ষমতা পাঠায়, যা পরে হোম গ্রাফে তথ্য সংরক্ষণ করে।
চিত্র ১: গুগল এবং পার্টনার অবকাঠামোর মধ্যে মিথস্ক্রিয়া

ব্যবহারকারীর অ্যাকাউন্ট আনলিঙ্ক এবং রিলিঙ্ক করা এড়াতে, আপনি Assistant -এ একটি অনুরোধ সিঙ্ক পাঠাতে পারেন। এটি ডিভাইস এবং ক্ষমতার তালিকা সিঙ্ক করার জন্য আপনার ইচ্ছা পূরণের জন্য action.devices.SYNC পাঠায়। আরও তথ্যের জন্য "অনুরোধ সিঙ্ক বাস্তবায়ন করুন" দেখুন।

একটি SYNC ইন্টেন্টের ফ্লো ডায়াগ্রাম
চিত্র ২: সিঙ্ক ইনটেন্ট

স্থানীয় পরিপূর্ণতা সেটআপের সময়, স্থানীয় হোম প্ল্যাটফর্ম আপনার smart home অ্যাকশনের ক্লাউড পরিপূর্ণতা থেকে SYNC প্রতিক্রিয়া পরীক্ষা করে। স্থানীয় পরিপূর্ণতা সমর্থন করার জন্য আপনার SYNC প্রতিক্রিয়া কীভাবে পরিবর্তন করবেন সে সম্পর্কে আরও জানতে, ক্লাউড পরিপূর্ণতাতে SYNC প্রতিক্রিয়া আপডেট করুন দেখুন।

প্রশ্ন

smart home ডিভাইসের বর্তমান অবস্থা জানতে action.devices.QUERY ইনটেন্ট ব্যবহার করা হয়।

ব্যবহারকারীরা যখন ডিভাইসের অবস্থা সম্পর্কে জিজ্ঞাসা করেন, তখন "হে গুগল, রান্নাঘরে কোন আলো জ্বলছে?" -এর মতো প্রশ্নের উত্তর দিতে, Assistant আপনার ইচ্ছা পূরণের জন্য একটি action.devices.QUERY পাঠায়।

একটি QUERY ইন্টেন্টের ফ্লো ডায়াগ্রাম
চিত্র ৩: QUERY এর উদ্দেশ্য

সেরা ব্যবহারকারীর অভিজ্ঞতার জন্য, আপনার ব্যবহারকারীর ডিভাইসের বর্তমান অবস্থা সরাসরি Google Home Graph এ রিপোর্ট করার জন্য Report State প্রয়োগ করা উচিত। উদাহরণস্বরূপ, এটি Assistant কে জানাবে যে আপনার ব্যবহারকারী একটি ফিজিক্যাল লাইট সুইচ ব্যবহার করে স্মার্ট লাইট চালু করেছেন কিনা।

রিপোর্ট স্টেট ব্যবহার করে ডিভাইসের অবস্থা রিপোর্ট করা হচ্ছে
চিত্র ৪: ডিভাইসের অবস্থা রিপোর্ট করুন

এক্সিকিউট

smart home ডিভাইসে কার্যকর করার জন্য কমান্ড প্রদান করতে action.devices.EXECUTE ইন্টেন্ট ব্যবহার করা হয়।

যখন ব্যবহারকারীরা Assistant ব্যবহার করে ডিভাইসগুলিতে কমান্ড পাঠান, তখন আপনার পূর্ণতা একটি action.devices.EXECUTE অভিপ্রায় পায় যা কর্ম এবং কোন ডিভাইসগুলিতে কাজ করতে হবে তা বর্ণনা করে। একজন ব্যবহারকারী একটি ডিভাইসে একটি ক্রিয়া সম্পাদন করতে পারেন যেমন Hey Google, turn on my living room lights .

একটি EXECUTE ইন্টেন্টের ফ্লো ডায়াগ্রাম
চিত্র ৫: এক্সিকিউট অভিপ্রায়

সংযোগ বিচ্ছিন্ন করুন

যখন কোনও ব্যবহারকারী Assistant থেকে অ্যাপ অ্যাকাউন্টটি আনলিঙ্ক করে, তখন আপনাকে জানানোর জন্য action.devices.DISCONNECT ইন্টেন্টটি ট্রিগার করা হয়। action.devices.DISCONNECT ইন্টেন্ট পাওয়ার পরে, আপনার এই ব্যবহারকারীর ডিভাইসের অবস্থা রিপোর্ট করা উচিত নয়।

পূর্ববর্তী
ডিভাইসের ধরন এবং বৈশিষ্ট্য
পরবর্তী
পূর্ণতা