স্মার্ট হোম ছাউনি নির্দেশিকা
action.devices.types.AWNING - ছাউনিগুলো প্রত্যাহারযোগ্য এবং খোলা ও বন্ধ করা যায়। এগুলো বাড়ির ভেতরে বা বাইরে স্থাপন করা যেতে পারে।
এই প্রকারটি নির্দেশ করে যে ডিভাইসটি ছাউনির আইকন এবং এর সাথে সম্পর্কিত কিছু সমার্থক শব্দ ও বিকল্প নাম পায়।
ডিভাইসের ক্ষমতা
বাস্তবায়নের বিশদ বিবরণের জন্য, যেমন আপনার পরিষেবাতে কোন অ্যাট্রিবিউট ও স্টেটগুলো সমর্থন করা উচিত এবং কীভাবে EXECUTE ও QUERY প্রতিক্রিয়া তৈরি করতে হয়, তার জন্য সংশ্লিষ্ট ট্রেইট ডকুমেন্টেশন দেখুন।
প্রয়োজনীয় বৈশিষ্ট্য
আপনার ডিভাইসের জন্য প্রযোজ্য হলে, এই বৈশিষ্ট্য এবং কমান্ডগুলো আবশ্যক। যদি আপনার ডিভাইস এই বৈশিষ্ট্যগুলো সমর্থন না করে, তাহলে একটি QUERY বা EXECUTE রেসপন্সে functionNotSupported এরর কোডটি লিখুন। আরও তথ্যের জন্য এরর এবং এক্সেপশন দেখুন।
উদাহরণস্বরূপ ডিভাইস: সাধারণ ছাউনি
এই বিভাগে উপরে উল্লিখিত ডিভাইসের ধরণ এবং বৈশিষ্ট্যগুলির উপর ভিত্তি করে একটি সাধারণ "অনিং"-এর প্রতিনিধিত্বকারী উদাহরণ ইন্টেন্ট পেলোড রয়েছে। আপনি যদি আপনার বাস্তবায়নে বৈশিষ্ট্য যোগ বা অপসারণ করেন, তবে সেই পরিবর্তনগুলি প্রতিফলিত করার জন্য আপনার প্রতিক্রিয়াগুলিও সেই অনুযায়ী পরিবর্তন করুন।
নমুনা SYNC প্রতিক্রিয়া
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.AWNING", "traits": [ "action.devices.traits.OpenClose" ], "name": { "name": "Simple awning" }, "willReportState": true, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
নমুনা কোয়েরি প্রতিক্রিয়া
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "openPercent": 50 } } } }
নমুনা EXECUTE কমান্ড
খোলা বন্ধ
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.OpenClose রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OpenClose", "params": { "openPercent": 100 } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "PENDING", "states": { "online": true, "openPercent": 100 } } ] } }
ওপেনক্লোজরিলেটিভ
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.OpenClose রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 10 } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "PENDING", "states": { "online": true, "openPercent": 60 } } ] } }