স্মার্ট হোম গ্যারেজ গাইড
action.devices.types.GARAGE - গ্যারেজের দরজা খুলতে, বন্ধ হতে এবং খোলা অবস্থা শনাক্ত করতে পারে। এছাড়াও, দরজা বন্ধ হওয়ার সময় কোনো বস্তু তার পথে বাধা সৃষ্টি করেছে কিনা অথবা দরজাটি লক করা থাকায় নিয়ন্ত্রণ করা যাচ্ছে না কিনা, তাও এটি নির্দেশ করতে পারে।
এই প্রকারটি নির্দেশ করে যে ডিভাইসটি গ্যারেজ আইকন এবং এর সাথে সম্পর্কিত কিছু সমার্থক ও বিকল্প নাম পায়।
ডিভাইসের ক্ষমতা
বাস্তবায়নের বিশদ বিবরণের জন্য, যেমন আপনার পরিষেবাতে কোন অ্যাট্রিবিউট ও স্টেটগুলো সমর্থন করা উচিত এবং কীভাবে 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.GARAGE", "traits": [ "action.devices.traits.OpenClose", "action.devices.traits.LockUnlock" ], "name": { "name": "Simple garage" }, "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, "isLocked": false, "isJammed": false } } } }
নমুনা EXECUTE কমান্ড
খোলা বন্ধ
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.OpenClose রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OpenClose", "params": { "openPercent": 100 } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "PENDING", "states": { "online": true, "openPercent": 100 } } ] } }
ওপেনক্লোজরিলেটিভ
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.OpenClose রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654520", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 10 } } ] } ] } } ] }
{ "requestId": "6894439706274654520", "payload": { "commands": [ { "ids": [ "123" ], "status": "PENDING", "states": { "online": true, "openPercent": 60 } } ] } }
লকআনলক
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.LockUnlock রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.LockUnlock", "params": { "lock": true } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "PENDING", "states": { "online": true, "isLocked": true, "isJammed": false } } ] } }
ডিভাইসের ত্রুটি
ত্রুটি ও ব্যতিক্রমগুলির সম্পূর্ণ তালিকা দেখুন।-
obstructionDetected- ব্যবহারকারী গ্যারেজের দরজাটি বন্ধ করার চেষ্টা করেছিলেন কিন্তু একটি বস্তু দরজাটি আটকে রেখেছিল। -
lockedState- ব্যবহারকারী গ্যারেজের দরজাটি নিয়ন্ত্রণ করার চেষ্টা করেছেন কিন্তু এটি একটি লকড অবস্থায় আছে, যার ফলে এটি নড়াচড়া করতে পারছে না।