স্মার্ট হোম লাইট গাইড
action.devices.types.LIGHT
- হালকা ডিভাইস চালু এবং বন্ধ করা যেতে পারে। তাদের অতিরিক্ত বৈশিষ্ট্য থাকতে পারে, যেমন ম্লান হওয়া এবং রঙ পরিবর্তন করার ক্ষমতা।
এই ধরনের নির্দেশ করে যে ডিভাইসটি হালকা আইকন এবং কিছু সম্পর্কিত প্রতিশব্দ এবং উপনাম পায়।
ডিভাইসের ক্ষমতা
বাস্তবায়নের বিশদ বিবরণের জন্য সংশ্লিষ্ট বৈশিষ্ট্যের ডকুমেন্টেশন পড়ুন, যেমন বৈশিষ্ট্য এবং স্টেট যা আপনার পরিষেবাকে সমর্থন করা উচিত এবং কীভাবে EXECUTE এবং QUERY প্রতিক্রিয়া তৈরি করা যায়।
প্রয়োজনীয় বৈশিষ্ট্য
আপনার ডিভাইসে প্রযোজ্য হলে এই বৈশিষ্ট্য এবং আদেশগুলি প্রয়োজন৷ যদি আপনার ডিভাইস এই বৈশিষ্ট্যগুলিকে সমর্থন না করে, তাহলে একটি QUERY বা EXECUTE প্রতিক্রিয়াতে functionNotSupported
ত্রুটি কোডটি লিখুন৷ আরো তথ্যের জন্য ত্রুটি এবং ব্যতিক্রম দেখুন.
প্রস্তাবিত বৈশিষ্ট্য
এই বৈশিষ্ট্যগুলি সুপারিশ করা হয়, যদি আপনার ডিভাইসে প্রযোজ্য হয়। যাইহোক, আপনি আপনার বিদ্যমান পণ্য কার্যকারিতার সাথে সর্বোত্তম মেলানোর জন্য সমস্ত উপলব্ধ বৈশিষ্ট্যগুলিকে মিশ্রিত করতে এবং মেলাতে মুক্ত।
গুণমানের প্রয়োজনীয়তা
- লেটেন্সি: 700ms এর কম বা সমান হতে হবে।
- নির্ভরযোগ্যতা: 99% এর বেশি বা সমান হতে হবে।
উদাহরণ ডিভাইস: সাধারণ আলো
এই বিভাগে উপরের ডিভাইসের ধরন এবং বৈশিষ্ট্যের উপর ভিত্তি করে একটি সাধারণ "আলো" প্রতিনিধিত্ব করে এমন অভিপ্রায় পেলোডের উদাহরণ রয়েছে৷ আপনি যদি আপনার বাস্তবায়নে বৈশিষ্ট্যগুলি যোগ করেন বা মুছে ফেলেন তবে সেই পরিবর্তনগুলি প্রতিফলিত করতে আপনার প্রতিক্রিয়াগুলিকে সেই অনুযায়ী সংশোধন করুন৷
নমুনা SYNC প্রতিক্রিয়া
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.LIGHT", "traits": [ "action.devices.traits.ColorSetting", "action.devices.traits.Brightness", "action.devices.traits.OnOff" ], "name": { "name": "Simple light" }, "willReportState": true, "attributes": { "colorTemperatureRange": { "temperatureMinK": 2000, "temperatureMaxK": 6500 } }, "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, "brightness": 65, "color": { "temperatureK": 4000 } } } } }
স্যাম্পল এক্সিকিউটি কমান্ড
কালারঅ্যাবসোলিউট
কমান্ড প্যারামিটারের অতিরিক্ত বিবরণের জন্য, action.devices.traits.ColorSetting
রেফারেন্স দেখুন।
{ "requestId": "6894439706274654520", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ColorAbsolute", "params": { "color": { "name": "Warm White", "temperature": 3000 } } } ] } ] } } ] }
{ "requestId": "6894439706274654520", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "color": { "temperatureK": 3000 } } } ] } }
উজ্জ্বলতা পরম
কমান্ড প্যারামিটারের অতিরিক্ত বিবরণের জন্য, action.devices.traits.Brightness
রেফারেন্স দেখুন।
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.BrightnessAbsolute", "params": { "brightness": 65 } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "brightness": 65 } } ] } }
অনঅফ
কমান্ড প্যারামিটারের অতিরিক্ত বিবরণের জন্য, action.devices.traits.OnOff
রেফারেন্স দেখুন।
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }