স্মার্ট হোম সেট-টপ বক্স গাইড
action.devices.types.SETTOP - মাল্টিচ্যানেল ভিডিও প্রোগ্রামিং ডিস্ট্রিবিউটর (MVPD) এবং সেট-টপ-বক্স ডিভাইসের সাথে মিথস্ক্রিয়ার মধ্যে মিডিয়া প্লেব্যাক নিয়ন্ত্রণ অন্তর্ভুক্ত থাকতে পারে।
এই প্রকারটি নির্দেশ করে যে ডিভাইসটি সেট-টপ বক্স আইকন এবং এর সাথে সম্পর্কিত কিছু সমার্থক ও বিকল্প নাম পায়।
ডিভাইসের ক্ষমতা
বাস্তবায়নের বিশদ বিবরণের জন্য, যেমন আপনার পরিষেবাতে কোন অ্যাট্রিবিউট ও স্টেটগুলো সমর্থন করা উচিত এবং কীভাবে EXECUTE ও QUERY প্রতিক্রিয়া তৈরি করতে হয়, তার জন্য সংশ্লিষ্ট ট্রেইট ডকুমেন্টেশন দেখুন।
প্রয়োজনীয় বৈশিষ্ট্য
আপনার ডিভাইসের জন্য প্রযোজ্য হলে, এই বৈশিষ্ট্য এবং কমান্ডগুলো আবশ্যক। যদি আপনার ডিভাইস এই বৈশিষ্ট্যগুলো সমর্থন না করে, তাহলে একটি QUERY বা EXECUTE রেসপন্সে functionNotSupported এরর কোডটি লিখুন। আরও তথ্যের জন্য এরর এবং এক্সেপশন দেখুন।
| বৈশিষ্ট্য | কমান্ড |
|---|---|
action.devices.traits.AppSelector |
|
action.devices.traits.InputSelector |
|
action.devices.traits.MediaState |
|
action.devices.traits.OnOff |
|
action.devices.traits.TransportControl |
|
action.devices.traits.Volume |
|
সুপারিশকৃত বৈশিষ্ট্য
আপনার ডিভাইসের জন্য প্রযোজ্য হলে এই বৈশিষ্ট্যগুলি সুপারিশ করা হয়। তবে, আপনার বিদ্যমান পণ্যের কার্যকারিতার সাথে সর্বোত্তমভাবে মেলানোর জন্য আপনি উপলব্ধ সমস্ত বৈশিষ্ট্য থেকে পছন্দমতো সমন্বয় করতে পারেন।
উদাহরণ ডিভাইস: সাধারণ সেট-টপ বক্স
এই বিভাগে উপরে উল্লিখিত ডিভাইসের ধরন এবং বৈশিষ্ট্যগুলির উপর ভিত্তি করে একটি সাধারণ "সেট-টপ বক্স"-এর প্রতিনিধিত্বকারী উদাহরণ ইন্টেন্ট পেলোড রয়েছে। আপনি যদি আপনার বাস্তবায়নে বৈশিষ্ট্য যোগ বা অপসারণ করেন, তবে সেই পরিবর্তনগুলি প্রতিফলিত করার জন্য আপনার প্রতিক্রিয়াগুলিও সেই অনুযায়ী পরিবর্তন করুন।
নমুনা SYNC প্রতিক্রিয়া
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.SETTOP", "traits": [ "action.devices.traits.OnOff", "action.devices.traits.AppSelector", "action.devices.traits.MediaState", "action.devices.traits.Channel", "action.devices.traits.TransportControl" ], "name": { "name": "Simple set-top box" }, "willReportState": true, "attributes": { "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME", "CAPTION_CONTROL" ], "availableApplications": [ { "key": "youtube", "names": [ { "name_synonym": [ "Youtube", "Youtube_en" ], "lang": "en" } ] } ], "availableChannels": [ { "key": "ktvu2", "names": [ "Fox", "KTVU" ], "number": "2" }, { "key": "abc1", "names": [ "ABC", "ABC East" ], "number": "702.4-11" } ], "supportActivityState": true, "supportPlaybackState": 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, "on": true, "currentApplication": "youtube", "activityState": "ACTIVE", "playbackState": "PAUSED" } } } }
নমুনা EXECUTE কমান্ড
চালু/বন্ধ
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.OnOff রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654528", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654528", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }
অ্যাপইনস্টল
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.AppSelector রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654522", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.appInstall", "params": { "newApplication": "youtube" } } ] } ] } } ] }
{ "requestId": "6894439706274654522", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentApplication": "youtube" } } ] } }
অ্যাপসার্চ
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.AppSelector রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654524", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.appSearch", "params": { "newApplication": "youtube" } } ] } ] } } ] }
{ "requestId": "6894439706274654524", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentApplication": "youtube" } } ] } }
অ্যাপ নির্বাচন করুন
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.AppSelector রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654526", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.appSelect", "params": { "newApplication": "youtube" } } ] } ] } } ] }
{ "requestId": "6894439706274654526", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentApplication": "youtube" } } ] } }
চ্যানেল নির্বাচন করুন
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.Channel রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.selectChannel", "params": { "channelCode": "ktvu2" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true } } ] } }
আপেক্ষিক চ্যানেল
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.Channel রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.relativeChannel", "params": { "relativeChannelChange": 1 } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true } } ] } }
রিটার্নচ্যানেল
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.Channel রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654520", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.returnChannel" } ] } ] } } ] }
{ "requestId": "6894439706274654520", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true } } ] } }
mediaClosedCaptioningOff
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.TransportControl রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654530", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.mediaClosedCaptioningOff" } ] } ] } } ] }
{ "requestId": "6894439706274654530", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "playbackState": "PLAYING" } } ] } }
মিডিয়া ক্লোজড ক্যাপশনিং অন
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.TransportControl রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654532", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "en" } } ] } ] } } ] }
{ "requestId": "6894439706274654532", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "playbackState": "PLAYING" } } ] } }
মিডিয়ানেক্সট
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.TransportControl রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654534", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.mediaNext" } ] } ] } } ] }
{ "requestId": "6894439706274654534", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "playbackState": "FAST_FORWARDING" } } ] } }
মিডিয়াপজ
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.TransportControl রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654536", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.mediaPause" } ] } ] } } ] }
{ "requestId": "6894439706274654536", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "playbackState": "PAUSED" } } ] } }
মিডিয়া পূর্ববর্তী
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.TransportControl রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654538", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.mediaPrevious" } ] } ] } } ] }
{ "requestId": "6894439706274654538", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "playbackState": "REWINDING" } } ] } }
মিডিয়া রেজ্যুমে
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.TransportControl রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654540", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.mediaResume" } ] } ] } } ] }
{ "requestId": "6894439706274654540", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "playbackState": "PLAYING" } } ] } }
মিডিয়াস্টপ
কমান্ড প্যারামিটার সম্পর্কে অতিরিক্ত বিবরণের জন্য, action.devices.traits.TransportControl রেফারেন্সটি দেখুন।
{ "requestId": "6894439706274654542", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.mediaStop" } ] } ] } } ] }
{ "requestId": "6894439706274654542", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "playbackState": "STOPPED" } } ] } }