স্মার্ট হোম কেটল গাইড
action.devices.types.KETTLE
- কেটল হল এমন ডিভাইস যা পানি ফুটিয়ে তোলে। কেটলগুলির সাথে মিথস্ক্রিয়াগুলির মধ্যে সেগুলি চালু এবং বন্ধ করা, লক্ষ্য তাপমাত্রা সামঞ্জস্য করা এবং সম্ভবত বিভিন্ন মোড সেটিংস সামঞ্জস্য করা অন্তর্ভুক্ত থাকতে পারে।
এই প্রকার নির্দেশ করে যে ডিভাইসটি কেটল আইকন এবং কিছু সম্পর্কিত প্রতিশব্দ এবং উপনাম পায়।
কেটলগুলিতেaction.devices.traits.OnOff
এর জন্য টাইপ-ভিত্তিক ব্যাকরণ রয়েছে। যদি ডিভাইসটি OnOff
সমর্থন করে, তাহলে কিছু জল ফুটান একটি action.devices.commands.OnOff
কমান্ড পাঠাবে৷ডিভাইসের ক্ষমতা
বাস্তবায়নের বিশদ বিবরণের জন্য সংশ্লিষ্ট বৈশিষ্ট্যের ডকুমেন্টেশন পড়ুন, যেমন বৈশিষ্ট্য এবং স্টেট যা আপনার পরিষেবাকে সমর্থন করা উচিত এবং কীভাবে EXECUTE এবং QUERY প্রতিক্রিয়া তৈরি করা যায়।
প্রয়োজনীয় বৈশিষ্ট্য
আপনার ডিভাইসে প্রযোজ্য হলে এই বৈশিষ্ট্য এবং আদেশগুলি প্রয়োজন৷ যদি আপনার ডিভাইস এই বৈশিষ্ট্যগুলিকে সমর্থন না করে, তাহলে একটি QUERY বা EXECUTE প্রতিক্রিয়াতে functionNotSupported
ত্রুটি কোডটি লিখুন৷ আরো তথ্যের জন্য ত্রুটি এবং ব্যতিক্রম দেখুন.
প্রস্তাবিত বৈশিষ্ট্য
এই বৈশিষ্ট্যগুলি সুপারিশ করা হয়, যদি আপনার ডিভাইসে প্রযোজ্য হয়। যাইহোক, আপনি আপনার বিদ্যমান পণ্য কার্যকারিতার সাথে সর্বোত্তম মেলানোর জন্য সমস্ত উপলব্ধ বৈশিষ্ট্যগুলিকে মিশ্রিত করতে এবং মেলাতে মুক্ত।
গুণমানের প্রয়োজনীয়তা
- লেটেন্সি: 800ms এর কম বা সমান হতে হবে।
- নির্ভরযোগ্যতা: 97% এর বেশি বা সমান হতে হবে।
উদাহরণ ডিভাইস: সাধারণ কেটলি
এই বিভাগে উপরের ডিভাইসের ধরন এবং বৈশিষ্ট্যের উপর ভিত্তি করে একটি সাধারণ "কেটল" প্রতিনিধিত্বকারী ইন্টেন্ট পেলোডের উদাহরণ রয়েছে। আপনি যদি আপনার বাস্তবায়নে বৈশিষ্ট্যগুলি যোগ করেন বা মুছে ফেলেন তবে সেই পরিবর্তনগুলি প্রতিফলিত করতে আপনার প্রতিক্রিয়াগুলিকে সেই অনুযায়ী সংশোধন করুন৷
নমুনা SYNC প্রতিক্রিয়া
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.KETTLE", "traits": [ "action.devices.traits.TemperatureControl", "action.devices.traits.OnOff" ], "name": { "name": "Simple kettle" }, "willReportState": true, "attributes": { "temperatureRange": { "minThresholdCelsius": 0, "maxThresholdCelsius": 100 }, "temperatureUnitForUX": "F" }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
নমুনা QUERY উত্তর
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "on": true, "temperatureSetpointCelsius": 100 } } } }
স্যাম্পল এক্সিকিউটি কমান্ড
তাপমাত্রা সেট করুন
কমান্ড প্যারামিটারের অতিরিক্ত বিবরণের জন্য, action.devices.traits.TemperatureControl
রেফারেন্স দেখুন।
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetTemperature", "params": { "temperature": 85 } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "temperatureSetpointCelsius": 85 } } ] } }
অনঅফ
কমান্ড প্যারামিটারের অতিরিক্ত বিবরণের জন্য, action.devices.traits.OnOff
রেফারেন্স দেখুন।
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }