स्मार्ट होम चैनल ट्रेल स्कीमा
action.devices.traits.Channel
- यह फ़र्क़ उन डिवाइसों पर लागू होता है जिनमें मीडिया चैनलों पर टीवी चैनल काम करते हैं.
availableChannels
के ज़रिए, हर उपयोगकर्ता या डिवाइस के हिसाब से एक सूची के तौर पर शेयर किया जाना चाहिए. इस सूची में सभी लोकप्रिय या लोकप्रिय चैनल
शामिल होने चाहिए, जिनकी उपयोगकर्ता या डिवाइस ने सदस्यता ली है. क्वेरी के इंतज़ार का समय कम रखने के लिए, हमारा सुझाव है कि आप चैनल की सूची को छोटा रखें (30 चैनलों या उससे कम पर).
डिवाइस की विशेषताएं
इस सुविधा का इस्तेमाल करने वाले डिवाइस,
SYNC
की कार्रवाई के तहत, इन एट्रिब्यूट की शिकायत कर सकते हैं. SYNC
इंटेंट को हैंडल करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.
विशेषताएं | टाइप | ब्यौरा |
---|---|---|
availableChannels |
रेंज |
ज़रूरी है. इस डिवाइस के लिए उपलब्ध मीडिया चैनलों की जानकारी देने वाली चीज़ों की सूची. हर आइटम एक ऐसे चैनल के बारे में बताता है जिसे उपयोगकर्ता इस डिवाइस पर चुन सकता है. |
[item, ...] |
ऑब्जेक्ट |
उपलब्ध मीडिया चैनल. |
key |
स्ट्रिंग |
ज़रूरी है. इस चैनल के लिए यूनीक आइडेंटिफ़ायर. उपयोगकर्ता बिना अनुमति के सार्वजनिक करते हैं. |
names |
रेंज |
ज़रूरी है. इस चैनल के लिए उपयोगकर्ताओं को दिखने वाले नामों की सूची. |
[item, ...] |
स्ट्रिंग |
चैनल का नाम. |
number |
स्ट्रिंग |
इस चैनल के लिए वैकल्पिक न्यूमेरिक आइडेंटिफ़ायर. |
commandOnlyChannels |
बूलियन |
(डिफ़ॉल्ट: इससे पता चलता है कि डिवाइस में एकतरफ़ा (सही) या दोतरफ़ा (गलत) बातचीत की सुविधा है या नहीं. अगर डिवाइस इस विशेषता के लिए किसी QUERY इंटेंट या रिपोर्ट स्थिति पर जवाब नहीं दे पाता है, तो इस विशेषता को सही पर सेट करें. |
उदाहरण
दो चैनलों के साथ काम करने वाला डिवाइस.
{ "availableChannels": [ { "key": "ktvu2", "names": [ "Fox", "KTVU" ], "number": "2" }, { "key": "abc1", "names": [ "ABC", "ABC East" ], "number": "4-11" } ] }
डिवाइस की स्थिति
कोई नहीं.
डिवाइस के निर्देश
इस सुविधा का इस्तेमाल करने वाले डिवाइस, EXECUTE
की कार्रवाई के तहत, इन निर्देशों का पालन कर सकते हैं. EXECUTE
इंटेंट को हैंडल करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.
action.devices.commands.selectChannel
मौजूदा चैनल को किसी खास वैल्यू पर सेट करें.
पैरामीटर
पेलोड में इनमें से कोई एक चीज़ होती है:
आईडी के हिसाब से चैनल चुनें
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
channelCode |
स्ट्रिंग |
ज़रूरी है. अनुरोध किए गए चैनल के लिए यूनीक आइडेंटिफ़ायर, जो |
channelName |
स्ट्रिंग |
अनुरोध किए गए चैनल का उपयोगकर्ता के लिए आसान नाम. |
channelNumber |
स्ट्रिंग |
अनुरोध किए गए चैनल का न्यूमेरिक आइडेंटिफ़ायर. |
नंबर के मुताबिक चैनल चुनें
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
channelNumber |
स्ट्रिंग |
ज़रूरी है. अनुरोध किए गए चैनल का न्यूमेरिक आइडेंटिफ़ायर. |
उदाहरण
KTVU पर स्विच करें
{ "command": "action.devices.commands.selectChannel", "params": { "channelCode": "ktvu2", "channelName": "KTVU" } }
तीसरे चैनल पर जाएं.
{ "command": "action.devices.commands.selectChannel", "params": { "channelNumber": "3" } }
मिलती-जुलती गड़बड़ियां
डिवाइस पर कोई नया चैनल चुनते समय गड़बड़ी हुई.
इस्तेमाल की जा सकने वाली वैल्यू:
noAvailableChannel
noChannelSubscription
channelSwitchFailed
action.devices.commands.relativeChannel
मौजूदा चैनल में इससे मिलती-जुलती रकम जोड़ें.
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
relativeChannelChange |
Integer |
ज़रूरी है. घटाने या बढ़ाने के लिए चैनलों की संख्या. |
उदाहरण
अगले चैनल पर जाएं
{ "command": "action.devices.commands.relativeChannel", "params": { "relativeChannelChange": 1 } }
पिछले चैनल पर जाना
{ "command": "action.devices.commands.relativeChannel", "params": { "relativeChannelChange": -1 } }
मिलती-जुलती गड़बड़ियां
डिवाइस के चैनल में बदलाव करने के दौरान कोई गड़बड़ी हुई.
इस्तेमाल की जा सकने वाली वैल्यू:
channelSwitchFailed
action.devices.commands.returnChannel
उस पिछले/पिछले चैनल पर वापस जाएं, जिस पर उपयोगकर्ता था.
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
कोई प्रॉपर्टी नहीं |
उदाहरण
पिछले चैनल पर वापस जाना
{ "command": "action.devices.commands.returnChannel", "params": {} }
मिलती-जुलती गड़बड़ियां
डिवाइस के अंतिम चैनल पर वापस लौटने में कोई गड़बड़ी हुई.
इस्तेमाल की जा सकने वाली वैल्यू:
channelSwitchFailed